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

​
Clientes compatibles

El Action MCP Server se autentica únicamente con una cabecera de solicitud estática Authorization: Bearer. Ese único requisito decide todo lo que sigue: un cliente que pueda establecer una cabecera HTTP personalizada en una conexión Streamable HTTP puede autenticarse, y un cliente que no pueda, no. Localiza tu cliente antes de empezar la configuración.

​
Por qué los conectores personales no pueden autenticarse

El Action MCP de Ayrshare requiere una cabecera Authorization: Bearer estática. Añadirlo como conector personalizado personal en claude.ai, Claude Desktop o Claude mobile no funciona, porque Ayrshare no publica metadatos OAuth y la alternativa de cabecera de solicitud es una beta limitada a organizaciones aprobadas. En un conector personal, ningún ajuste de tu parte lo soluciona: no hay ningún campo para una cabecera Authorization, ni ninguna API key, perfil o ajuste de cuenta que la habilite. Ayrshare no publica metadatos OAuth, así que la ruta OAuth del conector no tiene nada a lo que conectarse. Usa en su lugar un cliente de la tabla anterior: Claude Code, el plugin de Claude Code o cualquier cliente que te permita establecer una cabecera Authorization personalizada. Si eres administrador de una organización incluida en la beta de cabeceras de solicitud de Anthropic, consulta Organizaciones Team y Enterprise más abajo.
Si tu conector parece estar bien pero todas las herramientas fallan. El conector se añade sin problemas, aparece como en buen estado y lista el catálogo completo de herramientas — y aun así cada llamada de herramienta devuelve el error 403 / código 102, “API Key not valid” de Ayrshare. Se trata de esta limitación, no de una clave rota — tu cliente no puede enviar la cabecera Authorization: Bearer estática que este servidor requiere. initialize y tools/list son accesibles antes de la autenticación (consulta Autenticación más abajo), así que nada falla hasta la primera llamada de herramienta, cuando queda claro que nunca se envió ninguna credencial.¿Capacidad del cliente o una clave realmente inválida? Devuelven un error idéntico, así que usa la firma para distinguirlos. Un fallo por capacidad del cliente significa que el conector está en buen estado y todas las herramientas fallan, mientras que la misma clave funciona en otro lugar. Una clave inválida produce el mismo error pero es reproducible fuera del conector — también falla en una llamada REST. Para la semántica del error en sí, consulta Errores de autenticación más abajo.

​
Organizaciones Team y Enterprise

El mecanismo static_headers de Anthropic permite que un conector personalizado envíe una credencial fija como cabecera de solicitud en lugar de usar OAuth. Está disponible en beta para administradores de organizaciones en un conjunto limitado de organizaciones, y no está disponible para usuarios individuales que añadan un conector personal. Si tu organización tiene acceso, el administrador debe introducir el valor de la cabecera como Bearer seguido de tu API key de Ayrshare, incluido el espacio — Claude envía el valor exactamente como se introduce y no añade el esquema por ti. Para la disponibilidad actual y la configuración, consulta la documentación de autenticación de conectores de Anthropic.
La clave la comparte toda la organización. La credencial de cabecera de solicitud de Anthropic la introduce una sola vez un administrador y la usan todos los miembros de la organización, así que todos ellos actúan como la única cuenta de Ayrshare a la que pertenece esa clave — con acceso a cada User Profile bajo ella en una clave Business, y sin atribución por usuario en tu historial ni en tus analíticas de Ayrshare. Trátala como una credencial de servicio compartida, no como acceso individual.

​
Autenticación

La autenticación se aplica mediante la misma cadena de la API de Ayrshare que impulsa la REST API.
  • Requerida: Authorization: Bearer YOUR_API_KEY — la API key de tu cuenta (clave del plan Business para perfiles y sub-perfiles).
  • Opcional: Profile-Key: YOUR_PROFILE_KEY — dirige cada llamada de la conexión a un sub-perfil.
  • Opcional por llamada: un argumento profileKey de la herramienta — dirige una única llamada de herramienta a un sub-perfil.

​
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 para los pasos de instalación completos.

​
Opción B: cualquier cliente MCP

Para cualquier cliente MCP que soporte Streamable HTTP y te permita establecer una cabecera de solicitud personalizada — consulta Clientes compatibles más arriba — registra el servidor directamente. En Claude Code:
Para dirigir todas las llamadas a un sub-perfil, añade la cabecera opcional 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): 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 y la Guía de configuración de claves BYO de X 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):

​
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):
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.

​
Próximos pasos

Catálogo de herramientas

Las 33 herramientas agrupadas por dominio, con alcance y propósito.

Plugin de Claude Code

Instala el plugin de Ayrshare para Claude Code.