MCP de Claude Code
Publica en redes sociales desde Claude Code
Un comando añade Onlypult a Claude Code. Convierte un registro de cambios, un lanzamiento o una carpeta de capturas en borradores y publicaciones programadas en 15+ redes, sin salir de la terminal.
- Un comando
- Alojado o local
- Subidas desde el disco
Lee CHANGELOG.md de la v2.4 y redacta una publicación de LinkedIn y una de X para anunciarla. Adjunta ./docs/release.png.
Dos borradores creados con la captura adjunta:
- BorradorLinkedIn: «v2.4 ya está: exportaciones más rápidas y SSO»
- BorradorX: 3 puntos clave y enlace a las notas de la versión
Cómo añadir Onlypult a Claude Code
Crea una clave API, ejecuta un comando y comprueba el servidor con /mcp.
https://mcp.onlypult.com/mcp - 1
En Onlypult, abre Ajustes → Claves API y crea una clave. Empieza por
op_y se muestra una sola vez: cópiala en un lugar seguro. - 2
Ejecuta el comando de abajo en tu terminal. Añade
--scope userpara que Onlypult esté disponible en todos los proyectos. - 3
Abre Claude Code y ejecuta
/mcp: onlypult debe figurar como conectado.
claude mcp add --transport http onlypult https://mcp.onlypult.com/mcp \
--header "Authorization: Bearer op_your_api_key" Ejecuta el servidor MCP de Onlypult en tu máquina, así Claude Code puede subir imágenes y vídeos directo desde tu repositorio con media_upload_file. Necesitas Node.js 18+.
- 1
En Onlypult, abre Ajustes → Claves API y crea una clave. Empieza por
op_y se muestra una sola vez: cópiala en un lugar seguro. - 2
Ejecuta el comando de abajo. Claude Code arranca el paquete con
npxla primera vez. - 3
Ejecuta
/mcppara comprobar la conexión.
claude mcp add onlypult --env ONLYPULT_API_KEY=op_your_api_key \
-- npx -y @onlypult/mcp@latest Comparte el servidor con tu equipo mediante un archivo del proyecto. La clave se queda en el entorno de cada persona, no en git.
- 1
Añade
.mcp.jsona la raíz del proyecto con el bloque de abajo y guárdalo en el repositorio. - 2
Cada persona define
ONLYPULT_API_KEYen el perfil de su terminal con su propia clave. - 3
Claude Code pide a cada persona que apruebe los servidores del proyecto la primera vez.
{
"mcpServers": {
"onlypult": {
"type": "http",
"url": "https://mcp.onlypult.com/mcp",
"headers": {
"Authorization": "Bearer ${ONLYPULT_API_KEY}"
}
}
}
} Comprueba que funcionó: pide a Claude Code «Muestra mis perfiles sociales conectados en Onlypult».
Peticiones para Claude Code que funcionan
Claude Code ve tu repositorio, así que puede escribir publicaciones a partir de notas de versión, documentación y archivos reales.
Anuncio de lanzamiento
“Lee la última entrada de CHANGELOG.md y redacta publicaciones para LinkedIn, X y nuestro canal de Telegram. Solo borradores.”
Capturas a un carrusel
“Sube cada PNG de ./launch/screens y crea un borrador de publicación de Instagram con varias imágenes y un pie de foto que explique cada función.”
Documentación a una serie de consejos
“Recorre docs/guides y redacta ocho consejos cortos para LinkedIn, uno por guía, programados cada martes y jueves a las 10:00.”
Actualización semanal desde los cambios
“Resume los cambios fusionados de esta semana en una publicación «Novedades» para Telegram, escrita para quien usa el producto, y prográmala para el viernes a las 17:00.”
Arregla los fallos de anoche
“Lista las publicaciones fallidas de Onlypult de las últimas 24 horas, explica los errores y reintenta las que tengan retryable.”
Revisa los límites primero
“Consulta posts_limits de nuestros perfiles de X y Threads y acorta los borradores de ./social/*.md para que quepan antes de crearlos.”
Habilidades para Claude Code
Instala el plugin de Onlypult en Claude Code con dos comandos
El plugin une las habilidades de Onlypult con la conexión MCP, así Claude Code conoce las reglas de cada tarea: qué herramienta llamar, cómo escribir la hora, cómo leer la analítica y cómo diagnosticar una publicación fallida antes de reintentarla. Como puede leer los archivos de tu repositorio, las habilidades que convierten un texto ya escrito en publicaciones son donde más destaca.
Instalar para Claude Code
Añade el marketplace y luego instala el plugin. Dos comandos en cualquier sesión de Claude Code. Inicia sesión en Onlypult en la primera llamada a una herramienta.
/plugin marketplace add onlypult/agent-skills
/plugin install onlypult@onlypult ¿Ya añadiste el servidor MCP a mano? Ejecuta antes claude mcp remove onlypult, para que Claude Code no tenga dos conexiones al mismo servidor.
Programar una publicación
Borrador, programación o publicación en la zona horaria correcta y en el perfil correcto, con los límites del plan y las opciones de la red.
Publicación cruzada
Un mismo mensaje en varias redes, comprobando antes los límites de texto y de medios de cada plataforma.
Reels, Shorts y Stories
La herramienta y las opciones correctas para Reels de Instagram y Facebook, YouTube Shorts y Stories.
Subir medios
Elegir entre una URL pública, una subida en el navegador y una subida directa desde un archivo local.
Corregir publicaciones fallidas
Ver qué falló, explicar por qué, arreglar la causa y reintentar solo cuando un reintento puede funcionar.
Informe de analítica
Seguidores, alcance, interacción y mejores publicaciones, leídos bien, con huecos de datos y métricas derivadas explicadas.
Mejor momento para publicar
Los mejores días y horas según el mapa de interacción, y programar las publicaciones en esos huecos.
Calendario de contenido
Planificar una semana o un mes a partir de lo que ya funciona: primero el plan, las publicaciones después de tu aprobación.
Conjuntos de hashtags
Gestionar los conjuntos de hashtags guardados de un perfil y reutilizarlos en lugar de volver a escribirlos.
Le das al agente el trabajo, no el botón de publicar
La mayoría de las formas de «publicar con IA» son todo o nada. Onlypult te deja encargar el trabajo repetitivo y quedarte con la última palabra, en cada publicación.
Borradores por defecto
Pide un borrador y el agente envía is_draft: true. La publicación se guarda en tu calendario y no sale hasta que una persona, o un «publicar ahora» explícito, lo diga.
Permisos por herramienta
En Claude, ChatGPT, Cursor y la mayoría de clientes MCP apruebas las herramientas una a una. Deja las lecturas y los borradores en «Permitir siempre» y la publicación y el borrado en «Preguntar cada vez».
Todo llega a tu calendario
Cada publicación que crea un agente aparece en el calendario de Onlypult junto a las de tu equipo. Edítala, reprográmala o pásala por aprobación antes de que se publique.
OAuth para las apps de chat, claves para el código
Claude y ChatGPT se conectan con OAuth 2.1: inicias sesión en onlypult.com y la app de chat nunca ve tu contraseña. Los agentes de código usan una clave API op_ de Ajustes → Claves API.
Errores con los que el agente puede actuar
Los errores de validación vuelven con un código y un indicador retryable. El agente explica «tu plan termina el día 5, elige una fecha anterior» en lugar de reintentar en bucle.
Atento a la inyección de instrucciones
Los pies de foto y comentarios que trae la analítica se marcan como contenido externo no confiable, así el agente los resume en lugar de seguir instrucciones ocultas dentro.
Todas las herramientas de tu agente
Un servidor MCP cubre todo el ciclo de una publicación: contexto, publicación, medios, hashtags, reparación y analítica. 37 herramientas.
Publicaciones y programación
14Redactar, programar, publicar, cruzar a otras redes, editar, eliminar y reparar.
posts_createposts_create_storyposts_create_reelsposts_create_shortsposts_publish_nowposts_cross_postposts_listposts_list_failedposts_getposts_updateposts_deleteposts_retryposts_retry_all_failedposts_limits Analítica (solo lectura)
8Alcance, seguidores, mejores publicaciones, mejor hora, periodo contra periodo.
analytics_profiles_listanalytics_metrics_listanalytics_overviewanalytics_audienceanalytics_postsanalytics_top_postsanalytics_best_timeanalytics_compare_periods Cuenta y perfiles
6Zona horaria, límites del plan, perfiles conectados, tableros y categorías.
account_getprofiles_listprofiles_getprofiles_platforms_listprofiles_get_pinterest_boardsprofiles_get_youtube_categories Conjuntos de hashtags
6Reutiliza grupos de hashtags guardados por perfil, sin volver a escribirlos.
hashtags_listhashtags_createhashtags_deletehashtag_groups_createhashtag_groups_updatehashtag_groups_delete Medios
3URL públicas, subida desde el navegador o subida directa desde el disco.
media_get_upload_urlmedia_check_statusmedia_upload_file Publica en 15+ redes desde un solo chat
El agente elige perfiles de tu espacio de Onlypult: cada cuenta que conectaste por OAuth oficial está disponible, con opciones por red como Reels, Shorts, Stories, tableros y primeros comentarios.
Consejos y solución de problemas de Claude Code
Alojado o local
El servidor alojado basta para texto y URL públicas de imágenes. Usa el paquete local cuando Claude Code deba subir archivos de tu repositorio: el servidor alojado no puede leer tu disco.
El servidor aparece como fallido en /mcp
En el servidor alojado, comprueba que la cabecera sea exactamente Authorization: Bearer op_…. En el paquete local, comprueba que Node.js 18+ esté instalado y que npx esté en tu PATH.
Mantén las claves fuera de git
Usa ${ONLYPULT_API_KEY} en .mcp.json y deja la clave real en tu entorno. Cada clave pertenece a una cuenta de Onlypult: crea una clave distinta por persona del equipo.
Permisos
Claude Code pregunta antes de ejecutar herramientas MCP. Permite las de lectura y borrador para la sesión; deja posts_publish_now y posts_delete en preguntar.
«No se puede programar después del fin del plan»
No puedes programar publicaciones más allá de la fecha de fin de tu plan. El agente la lee con account_get y debe elegir una fecha anterior o pedirte que renueves. Este error viene marcado como retryable: false, así que un agente bien hecho se detiene en lugar de entrar en bucle.
Claude Code y Onlypult: preguntas frecuentes
¿Claude Code puede publicar en redes sociales?
Sí. Con el servidor MCP de Onlypult añadido, Claude Code puede redactar, programar y publicar en 15+ redes y adjuntar imágenes de tu repositorio.
¿Cuál es el comando para añadir Onlypult a Claude Code?
claude mcp add --transport http onlypult https://mcp.onlypult.com/mcp --header "Authorization: Bearer op_your_api_key". Para subir archivos en local: claude mcp add onlypult --env ONLYPULT_API_KEY=op_your_api_key -- npx -y @onlypult/mcp@latest.
¿Claude Code puede subir imágenes de mi proyecto?
Sí, con el paquete local. Añade media_upload_file, que sube un archivo desde una ruta local y devuelve un ID para posts_create.
¿Puedo usarlo en CI o en scripts?
Para procesos fijos, llama a la API REST de Onlypult directo con la misma clave API: es más predecible que un agente. Usa Claude Code cuando quieras que decida qué escribir.
¿Está incluido en mi plan?
Sí. MCP y la API están en todos los planes de Onlypult, también en los 7 días gratis.
Conecta otro agente de IA
Claude.ai y Claude Desktop. Añade un conector personalizado, inicia sesión con Onlypult: no hay clave API que pegar.
Guía de configuraciónConector personalizado en Plus y Pro, o modo Developer en cualquier plan. Inicio de sesión con OAuth y luego menciona @Onlypult.
Guía de configuraciónAñade Onlypult a .cursor/mcp.json: el servidor alojado, o el paquete local que sube archivos directo desde el disco.
Guía de configuraciónAñade Onlypult a la CLI de Codex o a la extensión del IDE con config.toml o codex mcp add.
Guía de configuraciónAñade Onlypult a Cascade en Windsurf con mcp_config.json: servidor alojado o paquete local.
Guía de configuraciónMCP está incluido en todos los planes
- Funciona en los 7 días gratis
- Sin tarjeta para empezar
- Sin plan aparte para desarrolladores
- Sin cuota de API por perfil
Publica el lanzamiento y las publicaciones juntos
Añade Onlypult a Claude Code y deja que anuncie lo que acabas de construir, como borradores que tú apruebas.
7 días gratis · Sin tarjeta · MCP y API en todos los planes
