Skip to main content
El plugin de Ayrshare para Claude Code integra la configuración del MCP Server, un comando de configuración, agentes, skills y un hook de seguridad. Con él instalado, puedes publicar posts, obtener historial y analíticas, gestionar perfiles y más — directamente desde Claude Code. Antes de que algo se publique, el agente valida cada post contra las reglas de la red objetivo y te pide confirmación, evitando rechazos innecesarios. El historial de publicaciones está disponible para replicar el tono de una marca, y las analíticas pueden leerse para orientar el siguiente post. El plugin es de código abierto. Consulta el repositorio para ver el detalle: ayrshare/ayrshare-social-media-api-claude-plugin.

​
Instalación

1

Añade el marketplace (una vez)

2

Instala el plugin

​
Alcances de instalación

La CLI de Claude Code llama al alcance global --scope user.

​
Credenciales

Proporciona tu API key de Ayrshare por cualquiera de estas vías:
  • Ejecuta /ayrshare:setup para configurar o rotar la clave.
  • Define la variable de entorno AYRSHARE_API_KEY.
El .mcp.json que trae el plugin ya declara la cabecera Authorization junto con las cabeceras opcionales Profile-Key y BYOK de X, cada una con un valor por defecto vacío (${VAR:-}), así que activas una cabecera simplemente definiendo su variable de entorno (Claude Code sustituye los valores al iniciar). Para dirigir todas las llamadas a un sub-perfil, define AYRSHARE_PROFILE_KEY (mediante /ayrshare:setup o el bloque env de tu settings.json) y reinicia Claude Code; la cabecera Profile-Key incluida la lleva, y queda vacía (tratada como no proporcionada) cuando no está definida. Para dirigir una única llamada a un sub-perfil en su lugar, pasa un argumento profileKey en la herramienta (no hace falta cambiar la configuración). No necesitas editar el .mcp.json incluido, y no deberías, porque claude plugin update lo sobrescribe.
El servidor MCP se inicializa al inicio de la sesión. Reinicia Claude Code después de instalar el plugin o cambiar tu clave.

​
Credenciales BYO de X/Twitter

Publicar en X/Twitter requiere tus propias credenciales de X Developer App (el mandato de claves BYO de X, vigente desde el 31 de marzo de 2026; consulta el API Overview). El .mcp.json incluido ya declara ambas cabeceras BYOK de X con valores por defecto vacíos, junto con Authorization y Profile-Key:
Así que solo defines las variables de entorno correspondientes (X_TWITTER_OAUTH1_API_KEY, X_TWITTER_OAUTH1_API_SECRET) mediante /ayrshare:setup o el bloque env de tu settings.json, y luego reinicias Claude Code; no editas el .mcp.json incluido (se sobrescribe con claude plugin update). Define ambas o ninguna: con ninguna definida, una llamada a X/Twitter devuelve el error 419 (x_credentials_required); con solo una definida devuelve el error 400. Es un par de claves por cuenta de Ayrshare, enviado en cada solicitud dirigida a X (el mismo par para todos los sub-perfiles).
¿Prefieres una conexión directa en lugar del plugin? Las mismas cabeceras BYO se pueden pasar con claude mcp add --header — consulta Conexión y configuración → Credenciales BYO de X/Twitter.

​
Qué incluye

​
Comando

  • /ayrshare:setup — configurar o rotar la API key de Ayrshare.

​
Agentes

  • social-manager: publica, programa y analiza contenido en todas las plataformas.
  • profile-manager: crea y lista perfiles y genera URLs de vinculación social JWT para los perfiles de los clientes bajo una cuenta Business.
  • insights-analyst: reportes de solo lectura. Extrae métricas e historial de publicaciones y resume el rendimiento; nunca publica, comenta, envía mensajes ni modifica nada.

​
Skills

​
Hook de confirmación

Un hook PreToolUse pide confirmación antes de cualquier acción con efectos reales. Si la rechazas, la herramienta no se ejecuta y no se envía nada a Ayrshare. Cubre exactamente estas 12 herramientas:
  • create_post
  • update_post
  • retry_post
  • add_comment
  • reply_comment
  • send_message
  • set_auto_response
  • create_profile: crea un perfil de cliente, lo que consume cuota de perfiles.
  • update_ad: pausa, reanuda, elimina o archiva un anuncio promocionado, lo que cambia el gasto publicitario real. El mismo estado también se aplica al conjunto de anuncios y a la campaña del anuncio, por lo que otros anuncios allí también cambian.
  • boost_post: promociona una publicación ya publicada como anuncio de pago, lo que gasta dinero real de la cuenta publicitaria.
  • register_webhook y unregister_webhook: cambian adónde envía Ayrshare los eventos de tu cuenta, incluido el contenido de mensajes y comentarios.
La confirmación requiere la versión 0.2.2 del plugin o posterior. Las versiones anteriores del plugin no la mostraban. Para actualizar, ejecuta claude plugin marketplace update ayrshare, luego claude plugin update ayrshare@ayrshare, y reinicia Claude Code.

​
Preguntas frecuentes

Sí. El plugin ejecuta validate_post para simular tu contenido contra las reglas de cada red — longitud, formato y requisitos de medios — antes de publicar, de modo que detectas rechazos evitables de antemano.
Sí. Un hook de confirmación PreToolUse te pide aprobar antes de cualquier acción con efectos reales: create_post, update_post, retry_post, add_comment, reply_comment, send_message, set_auto_response, create_profile, update_ad, boost_post, register_webhook y unregister_webhook. Requiere la versión 0.2.2 del plugin o posterior.
Sí. La skill draft-in-brand-voice lee tu historial de publicaciones para redactar nuevo copy con un tono de marca consistente. Solo produce borradores — nada se publica sin tu confirmación.
Sí. Las herramientas de analítica devuelven métricas por post y a nivel de cuenta, de modo que puedes leer los resultados y dejar que guíen tu próxima publicación.
Una API key de Ayrshare (una clave del plan Business para perfiles y sub-perfiles) y Claude Code. Configura la clave con /ayrshare:setup o la variable de entorno AYRSHARE_API_KEY, y reinicia Claude Code.
Sí. X/Twitter requiere tus propias credenciales OAuth 1.0a, añadidas como dos cabeceras de conexión (X-Twitter-OAuth1-Api-Key y X-Twitter-OAuth1-Api-Secret). Consulta Credenciales BYO de X/Twitter arriba.

​
Próximos pasos

Conexión y configuración

Autenticación, direccionamiento de perfiles y credenciales BYO.

Catálogo de herramientas

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