Instalar
Escopos de instalação
| Escopo | Onde se aplica |
|---|---|
| Global (padrão) | Todo projeto nesta máquina. |
--scope local | Projeto atual, não commitado no git. |
--scope project | Projeto atual, commitado e compartilhado com sua equipe. |
A CLI do Claude Code chama o escopo global de
--scope user.Credenciais
Forneça sua API Key da Ayrshare de uma destas formas:- Execute
/ayrshare:setuppara configurar ou rotacionar a chave. - Defina a variável de ambiente
AYRSHARE_API_KEY.
.mcp.json incluído no plugin já declara o header Authorization, além dos headers opcionais Profile-Key e BYOK do X, cada um com um valor padrão vazio (${VAR:-}), para que você ative um header apenas definindo sua variável de ambiente (o Claude Code substitui os valores ao iniciar). Para direcionar a um sub-profile em cada chamada, defina AYRSHARE_PROFILE_KEY (via /ayrshare:setup ou pelo bloco env do seu settings.json) e reinicie o Claude Code; o header Profile-Key incluído o transporta e permanece vazio (tratado como não fornecido) quando não definido. Para direcionar a um sub-profile em uma única chamada, passe um argumento profileKey na tool (nenhuma mudança de configuração é necessária). Você não precisa editar o .mcp.json incluído, e não deve fazê-lo, porque claude plugin update o sobrescreve.
Credenciais BYO do X/Twitter
Publicar no X/Twitter exige suas próprias credenciais de X Developer App (o mandato de chaves BYO do X, em vigor desde 31 de março de 2026; veja a Visão Geral da API). O.mcp.json incluído já declara ambos os headers BYOK do X com valores padrão vazios, junto de Authorization e Profile-Key:
X_TWITTER_OAUTH1_API_KEY, X_TWITTER_OAUTH1_API_SECRET) via /ayrshare:setup ou no env do seu settings.json e reiniciar o Claude Code; você não edita o .mcp.json incluído (ele é sobrescrito em claude plugin update). Defina ambas ou nenhuma: sem nenhuma definida, uma chamada ao X/Twitter retorna erro 419 (x_credentials_required); com apenas uma definida, retorna erro 400. Este é um par de chaves por conta Ayrshare, enviado em cada requisição direcionada ao X (o mesmo par para todos os sub-profiles).
Prefere uma conexão bruta ao plugin? Os mesmos headers BYO podem ser passados via
claude mcp add --header — veja Conectar e Configurar → Credenciais BYO do X/Twitter.O que o plugin inclui
Comando
/ayrshare:setup— configura ou rotaciona a API Key da Ayrshare.
Agents
social-manager: publica, agenda e analisa conteúdo em várias plataformas.profile-manager: cria e lista profiles e gera URLs de vinculação social JWT para profiles de clientes sob uma conta Business.insights-analyst: relatórios somente leitura. Puxa métricas e histórico de publicações e resume o desempenho; nunca publica, comenta, envia mensagens ou modifica algo.
Skills
| Skill | Propósito |
|---|---|
getting-started | Orientar e conectar para o primeiro uso. |
post | Criar, validar, atualizar e reenviar publicações. |
history | Obter histórico de publicações e de plataforma. |
analytics | Puxar análises por publicação e no nível da conta. |
comments | Ler, adicionar e responder a comentários. |
messages | Ler e enviar mensagens diretas e configurar respostas automáticas. |
profiles | Criar e listar sub-profiles. |
media | Validar se URLs de mídia são acessíveis. |
generate | Redigir texto de publicação com IA e recomendar hashtags. |
webhooks | Registrar, cancelar registro e listar webhooks. |
errors | Decodificar códigos de erro da Ayrshare. |
draft-in-brand-voice | Redigir texto de publicação em uma voz de marca consistente. |
plan-and-schedule-campaign | Planejar e agendar uma campanha com várias publicações. |
Hook de confirmação
Um hookPreToolUse pede confirmação antes de qualquer ação de publicar ou enviar. Ele cobre exatamente estas 7 tools:
create_postupdate_postretry_postadd_commentreply_commentsend_messageset_auto_response
FAQ
O plugin valida publicações antes de publicar?
O plugin valida publicações antes de publicar?
Sim. O plugin executa
validate_post para simular seu conteúdo contra as regras de cada rede — tamanho, formato e requisitos de mídia — antes de publicar, para que você capture rejeições evitáveis de antemão.Ele pergunta antes de publicar nas minhas contas ao vivo?
Ele pergunta antes de publicar nas minhas contas ao vivo?
Sim. Um hook
PreToolUse de confirmação pede sua aprovação antes de qualquer ação de publicar ou enviar: create_post, update_post, retry_post, add_comment, reply_comment, send_message e set_auto_response.O plugin consegue combinar com a voz da minha marca?
O plugin consegue combinar com a voz da minha marca?
Sim. A skill
draft-in-brand-voice lê seu histórico de publicações para redigir novo texto em uma voz de marca consistente. Ela produz apenas rascunhos — nada é publicado sem sua confirmação.Posso ler análises para orientar a próxima publicação?
Posso ler análises para orientar a próxima publicação?
Sim. As tools de análises retornam métricas por publicação e no nível da conta, então você pode ler os resultados e deixá-los guiar sua próxima publicação.
O que preciso para usar o plugin?
O que preciso para usar o plugin?
Uma API Key da Ayrshare (uma chave do Business Plan para profiles e sub-profiles) e o Claude Code. Configure a chave com
/ayrshare:setup ou pela variável de ambiente AYRSHARE_API_KEY, depois reinicie o Claude Code.Publicar no X/Twitter precisa de configuração extra?
Publicar no X/Twitter precisa de configuração extra?
Sim. O X/Twitter exige suas próprias credenciais OAuth 1.0a, adicionadas como dois headers de conexão (
X-Twitter-OAuth1-Api-Key e X-Twitter-OAuth1-Api-Secret). Veja Credenciais BYO do X/Twitter acima.Próximos passos
Conectar e Configurar
Autenticação, direcionamento de profile e credenciais BYO.
Catálogo de Tools
As 27 tools agrupadas por domínio, com escopo e propósito.