> ## Documentation Index > Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Conecte-se ao MCP Server > Conecte qualquer cliente MCP ao Ayrshare MCP Server — transporte, endpoint e autenticação. O [MCP Server](/additional/mcp-action-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. ### 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](/additional/mcp-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: ```bash theme={"system"} claude mcp add --transport http ayrshare https://api.ayrshare.com/mcp --header "Authorization: Bearer YOUR_API_KEY" ``` Para direcionar para um sub-profile em cada chamada, adicione o header opcional `Profile-Key`: ```bash theme={"system"} claude mcp add --transport http ayrshare https://api.ayrshare.com/mcp \ --header "Authorization: Bearer YOUR_API_KEY" \ --header "Profile-Key: YOUR_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`): | Header | Descrição | | ----------------------------- | ----------------------------------------------- | | `X-Twitter-OAuth1-Api-Key` | Sua OAuth 1.0a API Key (Consumer Key) | | `X-Twitter-OAuth1-Api-Secret` | Seu 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](/apis/overview#xtwitter-byo-credentials) e o [Guia de Configuração das Chaves BYO do X](/dashboard/connect-social-accounts/x-twitter-byo-keys) 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): ```bash theme={"system"} claude mcp add --transport http ayrshare https://api.ayrshare.com/mcp \ --header "Authorization: Bearer YOUR_API_KEY" \ --header "X-Twitter-OAuth1-Api-Key: YOUR_TWITTER_CONSUMER_KEY" \ --header "X-Twitter-OAuth1-Api-Secret: YOUR_TWITTER_CONSUMER_SECRET" ``` ### 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`): ```bash theme={"system"} claude mcp remove ayrshare claude mcp add --transport http ayrshare https://api.ayrshare.com/mcp \ --header "Authorization: Bearer YOUR_API_KEY" \ --header "X-Twitter-OAuth1-Api-Key: YOUR_TWITTER_CONSUMER_KEY" \ --header "X-Twitter-OAuth1-Api-Secret: YOUR_TWITTER_CONSUMER_SECRET" ``` 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](/additional/mcp-claude-code-plugin#xtwitter-byo-credentials). ## Próximos passos As 27 tools agrupadas por domínio, com escopo e propósito. Instale o plugin da Ayrshare para Claude Code.