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 Configuración > Tokens API
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: <code>~/.claude/settings.json</code>. Para Cursor: <code>.cursor/mcp.json</code>.
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 de Tokens API. Las claves comienzan con adaptly_.
Configuración para Claude Desktop
Claude Desktop se conecta mediante el puente <code>mcp-remote</code>, que abre la página de inicio de sesión por ti. Añade esto a tu <code>claude_desktop_config.json</code>:
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 <code>mcp-remote</code> 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 18 herramientas. Tu IA las descubre automáticamente, solo pregunta en lenguaje natural.
| Herramienta | Descripción | Parámetros clave |
|---|---|---|
| list_accounts | Lista todas las cuentas de redes sociales conectadas con IDs, plataformas y nombres de usuario. | 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) |
| create_post | Crea y programa una publicación en una o más plataformas. | text, platforms, contentType, timezone, scheduledAt?, mediaUrls?, platformTexts?, saveAsDraft?, tiktokConfigs?, youtubeConfigs?, pinterestConfigs? |
| 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?, mediaUrls?, platformTexts? |
| delete_post | Elimina una publicación programada o borrador. | 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, platformConfigs? |
| 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 |
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 de Tokens API. 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.