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

  • 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/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 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/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 18 herramientas. Tu IA las descubre automáticamente, solo pregunta en lenguaje natural.

HerramientaDescripciónParámetros clave
list_accountsLista todas las cuentas de redes sociales conectadas con IDs, plataformas y nombres de usuario.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)
create_postCrea y programa una publicación en una o más plataformas.text, platforms, contentType, timezone, scheduledAt?, mediaUrls?, platformTexts?, saveAsDraft?, tiktokConfigs?, youtubeConfigs?, pinterestConfigs?
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?, mediaUrls?, platformTexts?
delete_postElimina una publicación programada o borrador.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, platformConfigs?
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

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.