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

> Permite que agentes de IA operen la API de Ayrshare a través del MCP Server (Model Context Protocol).

<Info>
  ¿Buscas el MCP de solo lectura para la documentación? Consulta [Documentation MCP](/additional/mcp-server). **Esta página documenta el Action MCP** que permite a un agente de IA operar la API de Ayrshare.
</Info>

El **MCP Server** de Ayrshare permite a los agentes de IA operar la API de Ayrshare mediante herramientas del [Model Context Protocol (MCP)](https://modelcontextprotocol.io). En lugar de escribir llamadas REST a mano, un agente se conecta al MCP Server y llama a las herramientas de Ayrshare para publicar posts, obtener historial y analíticas, gestionar comentarios y mensajes directos, crear perfiles y más.

## Cómo funciona

Cada llamada de herramienta MCP se despacha en proceso a través de la misma cadena de la API de Ayrshare que impulsa la REST API:

<ul class="custom-bullets">
  <li>Autenticación de tu API key.</li>
  <li>Rate limiting según tu plan.</li>
  <li>Aplicación de cuotas y uso.</li>
  <li>Validación de solicitudes con OpenAPI.</li>
  <li>Los mismos controladores que sirven los endpoints REST.</li>
</ul>

Como las herramientas se ejecutan a través de la cadena real de la API, el MCP Server devuelve los mismos datos y aplica las mismas reglas que la REST API. No hay un comportamiento aparte que aprender ni mantener.

## Para quién es

<ul class="custom-bullets">
  <li>**Constructores de agentes** que conectan un agente LLM a la API de Ayrshare para publicar y analizar contenido.</li>
  <li>**Usuarios de Claude Code** que quieren publicar, obtener historial y gestionar perfiles desde su editor (consulta el [Plugin de Claude Code](/additional/mcp-claude-code-plugin)).</li>
  <li>**Integradores** que incorporan las cuentas sociales de sus clientes bajo sub-perfiles (consulta [Onboarding de clientes](/additional/mcp-client-onboarding)).</li>
</ul>

<Note>
  Trabajar con perfiles y sub-perfiles requiere un **plan Business** (o Enterprise). Consulta la [Visión general del Business Plan](/multiple-users/business-plan-overview).
</Note>

## Endpoint y transporte

El MCP Server de producción está disponible en:

`https://api.ayrshare.com/mcp`

Usa el transporte **Streamable HTTP** y es **stateless** — no hay ninguna sesión que mantener entre llamadas. Consulta [Conexión y configuración](/additional/mcp-action-connect) para los detalles completos de conexión y autenticación.

## Relación con la REST API y el Documentation MCP

<ul class="custom-bullets">
  <li>**REST API** — la [API de Ayrshare](/apis/overview) es la interfaz subyacente. El MCP Server despacha cada llamada de herramienta a través de esa misma cadena de la API, así que el comportamiento, las reglas y los datos coinciden.</li>
  <li>**Documentation MCP** — el [Documentation MCP](/additional/mcp-server) por separado es un servidor de solo lectura que busca en la documentación de la API de Ayrshare. No realiza acciones. Usa el MCP Server (esta página) para operar realmente la API.</li>
</ul>

## Próximos pasos

<CardGroup cols={2}>
  <Card title="Conexión y configuración" icon="plug" href="/additional/mcp-action-connect" horizontal>
    Transporte, endpoint y autenticación para cualquier cliente MCP.
  </Card>

  <Card title="Catálogo de herramientas" icon="list" href="/additional/mcp-action-tools" horizontal>
    Las 27 herramientas agrupadas por dominio, con alcance y propósito.
  </Card>

  <Card title="Plugin de Claude Code" icon="terminal" href="/additional/mcp-claude-code-plugin" horizontal>
    Instala el plugin de Ayrshare para Claude Code.
  </Card>

  <Card title="Onboarding de clientes" icon="user-plus" href="/additional/mcp-client-onboarding" horizontal>
    Genera URLs de vinculación social para los sub-perfiles de tus clientes.
  </Card>
</CardGroup>
