Saltar al contenido

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ónClase
brands_listR
accounts_listR
posts_listR
posts_getR
posts_createW
posts_scheduleW*
posts_publishD
posts_cancelD
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: true
  • confirmationToken
  • expiresAt

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.

Continúa con API REST o CLI.

Crea tu espacio, genera una clave en Ajustes → API y conecta tu agente.

Empieza tu prueba de 7 días