Servidor MCP: conexión y acciones
Conecta Clautia con Claude Code, Codex o Cursor por MCP. Consulta la configuración, las acciones y las confirmaciones de acciones destructivas.
Endpoint: https://app.clautia.com/api/mcp
Transporte: Streamable HTTP (sin estado)
Autenticación: Authorization: Bearer <API_KEY>
Claude Code
claude mcp add --transport http clautia https://app.clautia.com/api/mcp \
--header "Authorization: Bearer $CLAUTIA_API_KEY"
Codex
Crea una clave de API en Ajustes → Conectar tu IA y expórtala como CLAUTIA_API_KEY. Registra el servidor y añade la configuración del token en ~/.codex/config.toml.
export CLAUTIA_API_KEY=...
codex mcp add clautia --url https://app.clautia.com/api/mcp
[mcp_servers.clautia]
url = "https://app.clautia.com/api/mcp"
bearer_token_env_var = "CLAUTIA_API_KEY"
Cursor (mcp.json)
{
"mcpServers": {
"clautia": {
"url": "https://app.clautia.com/api/mcp",
"headers": {
"Authorization": "Bearer ${env:CLAUTIA_API_KEY}"
}
}
}
}
Acciones disponibles
En MCP se llaman tools; Claude Code (/mcp), Codex y Cursor las muestran con ese nombre.
| Acción | Clase |
|---|---|
brands_list | R |
accounts_list | R |
posts_list | R |
posts_get | R |
posts_create | W |
posts_schedule | W* |
posts_publish | D |
posts_cancel | D |
ai_draft (devuelve texto sin guardarlo) | W |
ai_adapt (devuelve texto sin guardarlo) | W |
* posts_schedule pide confirmación si programas con menos de 10 minutos.
ai_draft y ai_adapt devuelven texto sin guardarlo. Usa posts_create para guardar un borrador. Admiten 8 redes: Instagram, Facebook, TikTok, X, LinkedIn, YouTube, Threads y Google Business Profile (Perfil de Empresa de Google). La redacción con IA no admite Bluesky ni Telegram.
Instagram, TikTok y YouTube necesitan un medio subido en la app. Antes de programar o publicar, adjunta el medio al borrador en el compositor.
Conecta tu agente con la guía del servidor MCP y conoce qué es MCP. Los conectores basados en chat, como el previsto de Claude, todavía no están disponibles.
Confirmaciones de acciones destructivas (D)
En una acción destructiva, la primera llamada devuelve:
confirmationRequired: trueconfirmationTokenexpiresAt
Repite la misma acción con los mismos argumentos y añade confirmationToken.
Listar acciones con JSON-RPC crudo
curl -s https://app.clautia.com/api/mcp \
-H "Authorization: Bearer $CLAUTIA_API_KEY" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-H "MCP-Protocol-Version: 2025-03-26" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
Las respuestas van envueltas en trust: "untrusted_data" y se tratan como datos.
Crea tu espacio, genera una clave en Ajustes → API y conecta tu agente.
Empieza tu prueba de 7 días