Guía de configuración MCP
Conecta AdaptlyPost a tu asistente de IA en menos de un minuto. Pega la URL, inicia sesión cuando se te pida y empieza a publicar.
Requisitos previos
Una cuenta activa de AdaptlyPost registrarse
Al menos una cuenta de redes sociales conectada
Opcional: un token API para agentes headless y clientes sin OAuth, desde Gestionar > API y agentes de IA
Configuración para Claude Code y Cursor
Añade esto a tu configuración MCP e inicia sesión cuando se abra el navegador. Para Claude Code: ~/.claude/settings.json. Para Cursor: .cursor/mcp.json.
MCP config
{
"mcpServers": {
"adaptlypost": {
"type": "http",
"url": "https://mcp.adaptlypost.com/mcp"
}
}
}Claude Code CLI
claude mcp add --transport http adaptlypost https://mcp.adaptlypost.com/mcpO usa el comando de una línea de Claude Code CLI. Abre la página de inicio de sesión en el primer uso:
Alternativa con clave API
{
"mcpServers": {
"adaptlypost": {
"type": "http",
"url": "https://mcp.adaptlypost.com/mcp",
"headers": {
"Authorization": "Bearer adaptly_your_key"
}
}
}
}Para agentes headless o clientes sin OAuth, añade un encabezado Authorization con un token de la página API y agentes de IA. Las claves comienzan con adaptly_.
Configuración para Claude Desktop
Claude Desktop se conecta mediante el puente mcp-remote, que abre la página de inicio de sesión por ti. Añade esto a tu claude_desktop_config.json:
claude_desktop_config.json
{
"mcpServers": {
"adaptlypost": {
"command": "npx",
"args": ["mcp-remote", "https://mcp.adaptlypost.com/mcp"]
}
}
}Configuración para otros clientes MCP
Cualquier cliente MCP que soporte transporte HTTP puede conectarse directamente.
Endpoint
https://mcp.adaptlypost.com/mcp
Autenticación
Inicia sesión cuando se te pida (OAuth), o envía Authorization: Bearer adaptly_your_key
Transporte
HTTP (Streamable HTTP)
Sin encabezado Bearer el servidor responde 401 con un encabezado WWW-Authenticate, así que los clientes con OAuth abren la página de inicio de sesión por sí solos.
Para clientes que solo soportan transporte stdio, usa el puente mcp-remote como se muestra en la sección de Claude Desktop.
Alternativa: Agent Skill
Para Claude Code, Cursor, Windsurf y Codex también puedes instalar AdaptlyPost como un agent skill, sin necesidad de configuración MCP.
npx skills add adaptlypost/agentInstala un SKILL.md y un script CLI que enseña a tu agente la API de AdaptlyPost. Ver en GitHub
Referencia de herramientas
El servidor MCP expone 33 herramientas. Tu IA las descubre automáticamente, solo pregunta en lenguaje natural.
| Herramienta | Descripción | Parámetros clave |
|---|---|---|
| list_workspaces | Lista los espacios de trabajo en los que puede actuar tu inicio de sesión. Pasa un id como workspaceId a cualquier otra herramienta para trabajar en ese espacio de trabajo. | None |
| list_accounts | Lista las cuentas de redes sociales conectadas con IDs, plataformas, nombres de usuario y estado. Una cuenta marcada como unauthorized debe reconectarse antes de poder publicar. | None |
| upload_media | Sube medios desde URLs o datos base64. Devuelve mediaUrls para create_post. | urls?, files? |
| get_upload_urls | Obtiene URLs de carga prefirmadas para subir archivos directamente al almacenamiento. | files (fileName + mimeType) |
| open_upload_widget | Muestra un cuadro de subida en ChatGPT o Claude para que el usuario añada fotos, vídeos o documentos desde su dispositivo. Al terminar, el cuadro devuelve las mediaUrls. | None |
| get_upload_ticket | Lo llama el cuadro de subida una vez por archivo. Oculto para la IA. | None |
| create_post | Crea una publicación para una o más plataformas: publícala ya, prográmala, guárdala como borrador o repítela a diario, cada semana, cada mes o cada año. | platforms, contentType, timezone, text?, scheduledAt?, saveAsDraft?, recurrence?, mediaUrls?, mediaAltTexts?, platformTexts?, *ConnectionIds, pageIds?, *Configs? |
| get_post | Obtiene los detalles completos de una publicación por ID. | id |
| list_posts | Lista publicaciones con filtros opcionales por plataforma, estado o rango de fechas. | statuses?, platforms?, startDate?, endDate?, sortOrder?, limit?, offset? |
| update_post | Actualiza el texto, programación, medios o configuraciones de plataforma de una publicación programada o borrador. | id, text?, platforms?, contentType?, scheduledAt?, timezone?, mediaUrls?, mediaAltTexts?, platformTexts?, *ConnectionIds, *Configs? |
| delete_post | Elimina una publicación. Una programada ya no saldrá; una publicada sigue visible en las redes. | id |
| unschedule_post | Quita una publicación programada del calendario y la conserva como borrador sin fecha. | id |
| publish_draft | Publica un borrador inmediatamente o prográmalo para más tarde. | id, timezone, scheduledAt? |
| list_post_results | Comprueba los resultados de publicación por plataforma, éxito/fallo con detalles del error. | id |
| retry_failed_platforms | Reintenta la publicación en plataformas que fallaron. | id, platformIds? |
| bulk_schedule_posts | Programa múltiples publicaciones a la vez con plataformas y IDs de conexión compartidos. | platforms, timezone, posts[], *ConnectionIds, pageIds?, *Configs? |
| list_recurring_posts | Lista las publicaciones recurrentes (series) con su estado, calendario y próxima publicación. | statuses?, limit?, offset? |
| get_recurring_post | Obtiene una publicación recurrente por ID, con el motivo de la pausa y la próxima fecha. | id |
| pause_recurring_post | Pausa una serie y elimina su próxima publicación programada. | id |
| resume_recurring_post | Reanuda una serie pausada desde la siguiente fecha. Las fechas perdidas se omiten. | id |
| delete_recurring_post | Detiene una serie de forma definitiva. Las publicaciones ya enviadas se conservan. | id |
| get_analytics_overview | Visualizaciones, me gusta, comentarios, compartidos, seguidores y tasa de interacción para un periodo, cada uno comparado con el periodo anterior. | from, to, platforms? |
| get_analytics_timeseries | Las mismas métricas agrupadas por día, semana o mes, para preguntas de tendencia. | from, to, platforms?, granularity? |
| get_platform_breakdown | Las mismas métricas desglosadas por plataforma, con las métricas que informa cada plataforma. | from, to |
| list_post_analytics | Métricas por publicación, ordenables por cualquier métrica. Mejores publicaciones y "cómo fue esta publicación". | from, to, platforms?, sortBy?, page?, limit? |
| get_analytics_sync_status | Cuándo se sincronizó cada cuenta por última vez y si alguna necesita reconectarse para las estadísticas. | None |
| trigger_analytics_sync | Actualiza las estadísticas ahora. Una vez cada 10 minutos por espacio de trabajo. | None |
| generate_caption | Escribe un texto a partir de un prompt, dentro del límite de caracteres de la plataforma elegida. Cuesta 2 créditos de IA. | prompt, platform? |
| refine_caption | Reescribe un texto existente según una instrucción como "hazlo más corto", o termina uno a medio escribir. Cuesta 2 créditos de IA. | prompt, originalText, partialText?, platform? |
| generate_image | Inicia una imagen con IA y devuelve al momento un ID de trabajo. 2 créditos de IA en estándar, 4 en premium, reembolsados si falla. | prompt, aspectRatio?, model?, quality?, sessionId?, referenceImages? |
| get_image_job | Consulta un trabajo de imagen hasta que termine, con una URL pública lista para la publicación, o falle. | jobId |
Gestión del acceso
Los agentes con sesión iniciada pierden el acceso cuando eliminas el conector en tu cliente o cierras sesión. Puedes ver y revocar tokens API en cualquier momento desde tu página API y agentes de IA. Revocar un token desconecta inmediatamente cualquier agente que lo esté usando.
¿Listo para conectar?
Pega la URL en tu configuración MCP, inicia sesión una vez y empieza a publicar desde tu IA.