> ## 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.

# MCP Server

> Permita que agentes de IA operem a API da Ayrshare por meio do MCP Server (Model Context Protocol).

<Info>
  Procurando o MCP de busca de documentação, somente leitura? Veja [Documentation MCP](/additional/mcp-server). **Esta página documenta o Action MCP** que permite a um agente de IA operar a API da Ayrshare.
</Info>

O **MCP Server** da Ayrshare permite que agentes de IA operem a API da Ayrshare por meio de tools do [Model Context Protocol (MCP)](https://modelcontextprotocol.io). Em vez de escrever chamadas REST manualmente, um agente se conecta ao MCP Server e chama tools da Ayrshare para publicar posts, obter histórico e análises, gerenciar comentários e mensagens diretas, criar profiles e muito mais.

## Como funciona

Cada chamada de tool MCP é despachada in-process pela mesma cadeia de API da Ayrshare que alimenta a REST API:

<ul class="custom-bullets">
  <li>Autenticação da sua API Key.</li>
  <li>Limite de taxa para o nível do seu plano.</li>
  <li>Aplicação de cota e uso.</li>
  <li>Validação de requisição via OpenAPI.</li>
  <li>Os mesmos controllers que atendem os endpoints REST.</li>
</ul>

Como as tools rodam pela cadeia real da API, o MCP Server retorna os mesmos dados e aplica as mesmas regras da REST API. Não há comportamento separado para aprender ou manter.

## Para quem é

<ul class="custom-bullets">
  <li>**Construtores de agents** conectando um agente LLM à API da Ayrshare para publicar e analisar conteúdo.</li>
  <li>**Usuários do Claude Code** que querem publicar, obter histórico e gerenciar profiles direto do editor (veja o [Plugin do Claude Code](/additional/mcp-claude-code-plugin)).</li>
  <li>**Integradores** onboarding contas sociais de clientes sob sub-profiles (veja [Onboarding de Clientes](/additional/mcp-client-onboarding)).</li>
</ul>

<Note>
  Trabalhar com profiles e sub-profiles requer um **Business Plan** (ou Enterprise Plan). Consulte a [Visão Geral do Business Plan](/multiple-users/business-plan-overview).
</Note>

## 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 chamadas. Veja [Conectar e Configurar](/additional/mcp-action-connect) para todos os detalhes de conexão e autenticação.

## Relação com a REST API e o Documentation MCP

<ul class="custom-bullets">
  <li>**REST API** — a [API da Ayrshare](/apis/overview) é a interface subjacente. O MCP Server despacha cada chamada de tool pela mesma cadeia de API, então comportamento, regras e dados coincidem.</li>
  <li>**Documentation MCP** — o [Documentation MCP](/additional/mcp-server) separado é um servidor somente leitura que pesquisa a documentação da API da Ayrshare. Ele não executa ações. Use o MCP Server (esta página) para de fato operar a API.</li>
</ul>

## Próximos passos

<CardGroup cols={2}>
  <Card title="Conectar e Configurar" icon="plug" href="/additional/mcp-action-connect" horizontal>
    Transporte, endpoint e autenticação para qualquer cliente MCP.
  </Card>

  <Card title="Catálogo de Tools" icon="list" href="/additional/mcp-action-tools" horizontal>
    As 27 tools agrupadas por domínio, com escopo e propósito.
  </Card>

  <Card title="Plugin do Claude Code" icon="terminal" href="/additional/mcp-claude-code-plugin" horizontal>
    Instale o plugin da Ayrshare para Claude Code.
  </Card>

  <Card title="Onboarding de Clientes" icon="user-plus" href="/additional/mcp-client-onboarding" horizontal>
    Gere URLs de vinculação social para sub-profiles de clientes.
  </Card>
</CardGroup>