Pular para o conteúdo principal
O MCP Server da Ayrshare permite que um agente de IA opere a API da Ayrshare. Esta página cobre como se conectar a ele e como funciona a autenticação.

​
Endpoint e transporte

O MCP Server de produção está disponível em: https://api.ayrshare.com/mcp Ele usa transporte Streamable HTTP e é stateless — não há sessão a manter entre as chamadas.

​
Autenticação

A autenticação é aplicada pela mesma cadeia de API da Ayrshare que alimenta a REST API.
  • Obrigatório: Authorization: Bearer YOUR_API_KEY — a API Key da sua conta (chave do Business Plan para profiles e sub-profiles).
  • Opcional: Profile-Key: YOUR_PROFILE_KEY — direciona para um sub-profile em cada chamada da conexão.
  • Opcional por chamada: um argumento profileKey da tool — direciona para um sub-profile em uma única chamada da tool.

​
Precedência: o argumento vence sobre o header

Quando uma chamada de tool inclui um argumento profileKey e a conexão tem um header Profile-Key, o argumento profileKey por chamada vence. O header é usado somente quando nenhum argumento válido é fornecido. Uma exceção: em get_platform_history e get_social_network_analytics, uma busca por userId/userName do X/Twitter deve usar somente a API Key da conta; fornecer um argumento profileKey ou header Profile-Key retorna Erro 400.
Os métodos MCP initialize e tools/list são acessíveis antes da autenticação — eles retornam apenas metadados e não executam nada. Toda chamada de tool é autenticada.

​
Erros de autenticação

Uma chave inválida ou não autenticada em uma chamada de tool retorna um erro 403 / código 102 da Ayrshare com a mensagem “API Key not valid”. Conforme a especificação do MCP, erros de execução de tool são retornados in-band: o resultado da tool carrega isError: true e essa mensagem, enquanto o próprio transporte MCP responde HTTP 200. (O 403/102 é o erro de aplicação da Ayrshare, não o status do transporte.)

​
Conectar

​
Opção A: plugin do Claude Code

Se você usa Claude Code, instale o plugin da Ayrshare. Ele inclui a configuração do MCP Server, um comando de setup, agents, skills e um hook de confirmação. Consulte a página Claude Code Plugin para as etapas completas de instalação.

​
Opção B: qualquer cliente MCP

Para qualquer cliente MCP que suporte Streamable HTTP, registre o servidor diretamente. No Claude Code:
Para direcionar para um sub-profile em cada chamada, adicione o header opcional Profile-Key:
A conexão MCP é inicializada no início da sessão. Reinicie seu cliente MCP após instalar o servidor ou alterar sua chave, para que a nova configuração entre em vigor.

​
Credenciais BYO do X/Twitter

Desde 31 de março de 2026, operações no X/Twitter via Ayrshare exigem suas próprias credenciais OAuth 1.0a. Quando uma chamada de tool direciona ao X/Twitter, encaminhe estes dois headers na conexão, junto com seus headers Authorization (e opcionalmente Profile-Key):
HeaderDescrição
X-Twitter-OAuth1-Api-KeySua OAuth 1.0a API Key (Consumer Key)
X-Twitter-OAuth1-Api-SecretSeu OAuth 1.0a API Key Secret (Consumer Secret)
Estes são os mesmos headers usados pela REST API — um par de chaves OAuth 1.0a por conta Ayrshare, enviado em cada requisição direcionada ao X (o mesmo par se aplica a todos os sub-profiles). A Ayrshare não usa OAuth 2.0 aqui. Consulte a Visão Geral da API e o Guia de Configuração das Chaves BYO do X para setup, política e solução de problemas.
Sem esses headers, uma chamada de tool ao X/Twitter retorna erro 419 (x_credentials_required).

​
Conectar com os headers BYO

Para configurar as credenciais BYO do X/Twitter desde o início, adicione o servidor com ambos os headers OAuth 1.0a junto com o header Authorization (inclua também Profile-Key se você direcionar para um sub-profile em cada chamada):

​
Adicionar os headers BYO a uma conexão existente

Os headers da conexão são fixos quando o servidor é adicionado, então, se você já se conectou sem os headers BYO, remova o servidor e adicione-o novamente com o conjunto completo (reinclua quaisquer headers que já estivessem em uso, como Profile-Key):
Reinicie seu cliente MCP após alterar os headers para que a nova configuração entre em vigor. Usando o plugin do Claude Code em vez de uma conexão bruta? Veja Claude Code Plugin → Credenciais BYO do X/Twitter.

​
Próximos passos

Catálogo de Tools

As 27 tools agrupadas por domínio, com escopo e propósito.

Plugin do Claude Code

Instale o plugin da Ayrshare para Claude Code.