Skip to main content
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.

​
Clientes suportados

O Action MCP Server se autentica somente com um header de requisição estático Authorization: Bearer. Esse único requisito decide tudo abaixo: um cliente que consegue definir um header HTTP customizado em uma conexão Streamable HTTP consegue se autenticar, e um cliente que não consegue, não. Encontre seu cliente antes de começar o setup.

​
Por que conectores pessoais não conseguem se autenticar

O Action MCP da Ayrshare exige um header Authorization: Bearer estático. Adicioná-lo como conector customizado pessoal no claude.ai, no Claude Desktop ou no Claude mobile não funciona, porque a Ayrshare não publica metadados OAuth e a alternativa de header de requisição é um beta limitado a organizações aprovadas. Em um conector pessoal, nenhuma configuração do seu lado resolve isso: não há campo para um header Authorization, nem API Key, profile ou configuração de conta que habilite um. A Ayrshare não publica metadados OAuth, então o caminho OAuth do conector não tem a que se conectar. Use em vez disso um cliente da tabela acima: o Claude Code, o plugin do Claude Code ou qualquer cliente que permita definir um header Authorization customizado. Se você é administrador de uma organização no beta de header de requisição da Anthropic, veja Organizações Team e Enterprise abaixo.
Se o seu conector parece saudável, mas toda tool falha. O conector é adicionado sem problemas, aparece como saudável e lista o catálogo completo de tools — e então toda chamada de tool retorna o erro 403 / código 102, “API Key not valid” da Ayrshare. Isso é essa limitação, não uma chave quebrada — seu cliente não consegue enviar o header Authorization: Bearer estático que este servidor exige. initialize e tools/list são acessíveis antes da autenticação (veja Autenticação abaixo), então nada falha até a primeira chamada de tool, quando fica claro que nenhuma credencial foi enviada.Capacidade do cliente ou uma chave realmente inválida? Ambas retornam o erro idêntico, então use a assinatura para diferenciá-las. Uma falha de capacidade do cliente significa que o conector está saudável e toda tool falha, enquanto a mesma chave funciona em outro lugar. Uma chave inválida produz o mesmo erro, mas é reproduzível fora do conector — ela também falha em uma chamada REST. Para a semântica do erro em si, veja Erros de autenticação abaixo.

​
Organizações Team e Enterprise

O mecanismo static_headers da Anthropic permite que um conector customizado envie uma credencial fixa como header de requisição em vez de usar OAuth. Ele está disponível em beta para administradores de organização em um conjunto limitado de organizações e não está disponível para usuários individuais que adicionam um conector pessoal. Se a sua organização tem acesso, o administrador deve inserir o valor do header como Bearer seguido da sua API Key da Ayrshare, incluindo o espaço — o Claude envia o valor exatamente como inserido e não adiciona o esquema por você. Para disponibilidade atual e setup, veja a documentação de autenticação de conectores da Anthropic.
A chave é compartilhada por toda a organização. A credencial de header de requisição da Anthropic é inserida uma única vez por um administrador e usada por todos os membros da organização, então todos eles atuam como a única conta Ayrshare à qual essa chave pertence — com acesso a todo User Profile sob ela em uma chave do Business Plan, e sem atribuição por usuário no seu histórico ou analytics da Ayrshare. Trate-a como uma credencial de serviço compartilhada, não como acesso individual.

​
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 e permita definir um header de requisição customizado — veja Clientes suportados acima — 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): 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 33 tools agrupadas por domínio, com escopo e propósito.

Plugin do Claude Code

Instale o plugin da Ayrshare para Claude Code.