---
title: "Guía de configuración MCP"
description: "Conecta AdaptlyPost con Claude, Cursor, Windsurf o cualquier asistente de IA compatible con MCP. Configuración en menos de un minuto."
url: "https://adaptlypost.com/es/features/agents/docs"
---
[Volver a Agentes IA](https://adaptlypost.com/es/features/agents)
# 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](https://adaptlypost.com/es/signup)
* Al menos una cuenta de redes sociales conectada
* Opcional: un token API para agentes headless y clientes sin OAuth, desde [Configuración > Tokens API](https://adaptlypost.com/es/api-tokens)
## 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 de Tokens API](https://adaptlypost.com/es/api-tokens). 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](https://github.com/adaptlypost/agent)
## 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](https://adaptlypost.com/es/api-tokens). 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.
[Registrarse](https://adaptlypost.com/es/signup)[Obtener clave API](https://adaptlypost.com/es/api-tokens)