Saltar al contenido principal
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.

​
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, 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):
CabeceraDescripción
X-Twitter-OAuth1-Api-KeyTu OAuth 1.0a API Key (Consumer Key)
X-Twitter-OAuth1-Api-SecretTu 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 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 27 herramientas agrupadas por dominio, con alcance y propósito.

Plugin de Claude Code

Instala el plugin de Ayrshare para Claude Code.