> ## 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. # Conectarse al MCP Server > Conecta cualquier cliente MCP al MCP Server de Ayrshare — transporte, endpoint y autenticación. El [MCP Server](/additional/mcp-action-server) de Ayrshare permite que un agente de IA opere la API de Ayrshare. Esta página explica cómo conectarse y cómo funciona la autenticación. ## 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. ## Autenticación La autenticación se aplica mediante la misma cadena de la API de Ayrshare que impulsa la REST API. ### Precedencia: el argumento gana sobre la cabecera Cuando una llamada de herramienta incluye un argumento `profileKey` **y** la conexión tiene una cabecera `Profile-Key`, el **argumento `profileKey` por llamada gana**. La cabecera solo se usa cuando no se proporciona un argumento válido. Una excepción: en `get_platform_history` y `get_social_network_analytics`, una consulta por `userId`/`userName` de X/Twitter debe usar únicamente la API key de la cuenta; proporcionar un argumento `profileKey` o una cabecera `Profile-Key` allí devuelve Error 400. Los métodos MCP `initialize` y `tools/list` son accesibles **antes** de la autenticación — devuelven solo metadatos y no ejecutan nada. **Cada llamada de herramienta se autentica.** ### Errores de autenticación Una clave inválida o no autenticada en una llamada de herramienta devuelve un **error 403 / código 102** de Ayrshare con el mensaje **"API Key not valid"**. Según la especificación MCP, los errores de ejecución de herramientas se devuelven in-band: el resultado de la herramienta lleva `isError: true` y este mensaje, mientras que el transporte MCP en sí responde **HTTP 200**. (El `403`/`102` es el error de aplicación de Ayrshare, no el estado del transporte.) ## Conectar ### Opción A: plugin de Claude Code Si usas Claude Code, instala el plugin de Ayrshare. Incluye la configuración del MCP Server, un comando de configuración, agentes, skills y un hook de confirmación. Consulta la página [Plugin de Claude Code](/additional/mcp-claude-code-plugin) para los pasos de instalación completos. ### Opción B: cualquier cliente MCP Para cualquier cliente MCP que soporte Streamable HTTP, registra el servidor directamente. En Claude Code: ```bash theme={"system"} claude mcp add --transport http ayrshare https://api.ayrshare.com/mcp --header "Authorization: Bearer YOUR_API_KEY" ``` Para dirigir todas las llamadas a un sub-perfil, añade la cabecera 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" ``` La conexión MCP se inicializa al inicio de la sesión. **Reinicia tu cliente MCP** después de instalar el servidor o cambiar tu clave para que la nueva configuración surta efecto. ## Credenciales BYO de X/Twitter A partir del 31 de marzo de 2026, las operaciones de X/Twitter a través de Ayrshare requieren tus propias credenciales OAuth 1.0a. Cuando una llamada de herramienta apunte a X/Twitter, envía estas dos cabeceras en la conexión junto con `Authorization` (y opcionalmente `Profile-Key`): | Cabecera | Descripción | | ----------------------------- | ---------------------------------------------- | | `X-Twitter-OAuth1-Api-Key` | Tu OAuth 1.0a API Key (Consumer Key) | | `X-Twitter-OAuth1-Api-Secret` | Tu OAuth 1.0a API Key Secret (Consumer Secret) | Son las mismas cabeceras que usa la REST API — un par de claves OAuth 1.0a por cuenta de Ayrshare, enviadas en cada solicitud dirigida a X (el mismo par se aplica a todos los sub-perfiles). Ayrshare no usa OAuth 2.0 aquí. Consulta [API Overview](/apis/overview#xtwitter-byo-credentials) y la [Guía de configuración de claves BYO de X](/dashboard/connect-social-accounts/x-twitter-byo-keys) para configuración, políticas y solución de problemas. Sin estas cabeceras, una llamada de herramienta de X/Twitter devuelve el error `419` (`x_credentials_required`). ### Conectar con las cabeceras BYO Para configurar las credenciales BYO de X/Twitter desde el principio, añade el servidor con ambas cabeceras OAuth 1.0a junto con tu cabecera `Authorization` (incluye también `Profile-Key` si diriges todas las llamadas a un sub-perfil): ```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" ``` ### Añadir las cabeceras BYO a una conexión existente Las cabeceras de la conexión son fijas cuando se añade el servidor, así que si ya te conectaste sin las cabeceras BYO, elimina el servidor y vuelve a añadirlo con el conjunto completo (vuelve a incluir todas las cabeceras que ya estabas usando, 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" ``` Reinicia tu cliente MCP después de cambiar las cabeceras para que la nueva configuración surta efecto. ¿Usando el plugin de Claude Code en lugar de una conexión directa? Consulta [Plugin de Claude Code → Credenciales BYO de X/Twitter](/additional/mcp-claude-code-plugin#xtwitter-byo-credentials). ## Próximos pasos Las 27 herramientas agrupadas por dominio, con alcance y propósito. Instala el plugin de Ayrshare para Claude Code.