Instalación
Alcances de instalación
| Alcance | Dónde aplica |
|---|---|
| Global (por defecto) | Todos los proyectos en esta máquina. |
--scope local | Proyecto actual, no se sube a git. |
--scope project | Proyecto actual, se sube y se comparte con tu equipo. |
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:setuppara configurar o rotar la clave. - Define la variable de entorno
AYRSHARE_API_KEY.
.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.
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:
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
| Skill | Propósito |
|---|---|
getting-started | Orientar y conectar en el primer uso. |
post | Crear, validar, actualizar y reintentar publicaciones. |
history | Obtener el historial de publicaciones y de plataforma. |
analytics | Extraer analíticas por post y a nivel de cuenta. |
comments | Leer, añadir y responder comentarios. |
messages | Leer y enviar mensajes directos y configurar auto-respuestas. |
profiles | Crear y listar sub-perfiles. |
media | Validar que las URLs de medios sean accesibles. |
generate | Redactar el texto del post con IA y recomendar hashtags. |
webhooks | Registrar, dar de baja y listar webhooks. |
errors | Decodificar códigos de error de Ayrshare. |
draft-in-brand-voice | Redactar posts con un tono de marca consistente. |
plan-and-schedule-campaign | Planificar y programar una campaña de varios posts. |
Hook de confirmación
Un hookPreToolUse pide confirmación antes de cualquier acción de publicación o envío. Cubre exactamente estas 7 herramientas:
create_postupdate_postretry_postadd_commentreply_commentsend_messageset_auto_response
Preguntas frecuentes
¿El plugin valida las publicaciones antes de publicar?
¿El plugin valida las publicaciones antes de publicar?
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.¿Pregunta antes de publicar en mis cuentas reales?
¿Pregunta antes de publicar en mis cuentas reales?
Sí. Un hook de confirmación
PreToolUse te pide aprobar antes de cualquier acción de publicación o envío: create_post, update_post, retry_post, add_comment, reply_comment, send_message y set_auto_response.¿El plugin puede replicar el tono de mi marca?
¿El plugin puede replicar el tono de mi marca?
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.¿Puedo leer analíticas para orientar el siguiente post?
¿Puedo leer analíticas para orientar el siguiente post?
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.
¿Qué necesito para usar el plugin?
¿Qué necesito para usar el plugin?
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.¿Publicar en X/Twitter requiere una configuración adicional?
¿Publicar en X/Twitter requiere una configuración adicional?
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 27 herramientas agrupadas por dominio, con alcance y propósito.