Volver a Agentes IA

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

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/mcp

O 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/agent

Instala 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.

HerramientaDescripciónParámetros clave
list_workspacesLista 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_accountsLista 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_mediaSube medios desde URLs o datos base64. Devuelve mediaUrls para create_post.urls?, files?
get_upload_urlsObtiene URLs de carga prefirmadas para subir archivos directamente al almacenamiento.files (fileName + mimeType)
open_upload_widgetMuestra 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_ticketLo llama el cuadro de subida una vez por archivo. Oculto para la IA.None
create_postCrea 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_postObtiene los detalles completos de una publicación por ID.id
list_postsLista publicaciones con filtros opcionales por plataforma, estado o rango de fechas.statuses?, platforms?, startDate?, endDate?, sortOrder?, limit?, offset?
update_postActualiza 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_postElimina una publicación. Una programada ya no saldrá; una publicada sigue visible en las redes.id
unschedule_postQuita una publicación programada del calendario y la conserva como borrador sin fecha.id
publish_draftPublica un borrador inmediatamente o prográmalo para más tarde.id, timezone, scheduledAt?
list_post_resultsComprueba los resultados de publicación por plataforma, éxito/fallo con detalles del error.id
retry_failed_platformsReintenta la publicación en plataformas que fallaron.id, platformIds?
bulk_schedule_postsPrograma múltiples publicaciones a la vez con plataformas y IDs de conexión compartidos.platforms, timezone, posts[], *ConnectionIds, pageIds?, *Configs?
list_recurring_postsLista las publicaciones recurrentes (series) con su estado, calendario y próxima publicación.statuses?, limit?, offset?
get_recurring_postObtiene una publicación recurrente por ID, con el motivo de la pausa y la próxima fecha.id
pause_recurring_postPausa una serie y elimina su próxima publicación programada.id
resume_recurring_postReanuda una serie pausada desde la siguiente fecha. Las fechas perdidas se omiten.id
delete_recurring_postDetiene una serie de forma definitiva. Las publicaciones ya enviadas se conservan.id
get_analytics_overviewVisualizaciones, 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_timeseriesLas mismas métricas agrupadas por día, semana o mes, para preguntas de tendencia.from, to, platforms?, granularity?
get_platform_breakdownLas mismas métricas desglosadas por plataforma, con las métricas que informa cada plataforma.from, to
list_post_analyticsMé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_statusCuándo se sincronizó cada cuenta por última vez y si alguna necesita reconectarse para las estadísticas.None
trigger_analytics_syncActualiza las estadísticas ahora. Una vez cada 10 minutos por espacio de trabajo.None
generate_captionEscribe 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_captionReescribe 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_imageInicia 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_jobConsulta 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.