Servidor MCP

La integración MCP de Jotly conecta tus herramientas de IA directo a tu espacio a través de un servidor MCP remoto (HTTP transmitible, sin estado) con 82 herramientas: las mismas operaciones de la API REST, salvo subir archivos y borrar datos personales, que sólo van por REST.

Si tu editor o asistente acepta servidores MCP remotos, lo conectas a Jotly sin instalar ningún paquete local. Tus agentes atienden la bandeja, votan por tus clientes y escriben novedades.

Dirección del servidor

Jotly expone un solo endpoint MCP remoto:

https://jotly.si/api/v1/mcp

Es un servidor MCP remoto por HTTP, así que tu cliente necesita aceptar conexiones remotas y cabeceras propias.

Autenticación

Autentica las peticiones con una llave de API de Jotly:

Authorization: Bearer pk_live_TU_LLAVE

Crea la llave en Ajustes → API. Es la misma que usa la API REST. Listar herramientas no pide llave; llamarlas sí.

Cuándo usar MCP

Usa el servidor MCP cuando quieras que un asistente de IA trabaje con Jotly desde un cliente compatible como Claude Code, Cursor o Codex.

MCP te conviene cuando quieres:

MCP o API REST

Usa MCP cuando lo que conectas es un cliente de IA que ya entiende el Model Context Protocol.

Usa la API REST cuando construyes tu propia integración, automatización o código de backend y quieres control total sobre peticiones y respuestas.

Claude Code

Desde la terminal, en la carpeta de tu proyecto:

claude mcp add --transport http jotly https://jotly.si/api/v1/mcp \  --header "Authorization: Bearer pk_live_TU_LLAVE"

O agrégalo a mano en .mcp.json:

{  "mcpServers": {    "jotly": {      "type": "http",      "url": "https://jotly.si/api/v1/mcp",      "headers": { "Authorization": "Bearer pk_live_TU_LLAVE" }    }  }}

Cursor

En .cursor/mcp.json de tu proyecto, o en ~/.cursor/mcp.json para todos:

{  "mcpServers": {    "jotly": {      "url": "https://jotly.si/api/v1/mcp",      "headers": { "Authorization": "Bearer pk_live_TU_LLAVE" }    }  }}

Codex

Codex lee su configuración de ~/.codex/config.toml. Exporta la llave como JOTLY_API_KEY en tu entorno y agrega:

[mcp_servers.jotly]url = "https://jotly.si/api/v1/mcp"# La llave vive en una variable de entorno, no en el archivobearer_token_env_var = "JOTLY_API_KEY"

Probar la conexión

curl -s -X POST "https://jotly.si/api/v1/mcp" \  -H "Content-Type: application/json" \  -H "Accept: application/json, text/event-stream" \  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Para un agente programado que atiende la bandeja, empieza por listConversations con inbox_state=needs_team y updated_since con la hora de su última corrida. Jotly todavía no envía eventos a tu agente: la frecuencia la define tu rutina.

Para no duplicar si la rutina se reintenta, createRequest, createChangelog, importAsset, createConversationReply y createConversationNote aceptan el argumento idempotency_key: con la misma llave y los mismos argumentos durante 24 horas devuelven el resultado original. El límite de peticiones por minuto de la llave es el mismo que en la API REST; al pasarlo, la herramienta responde con isError y el código rate_limited con los segundos de espera.

Manejo de la llave

Trata tu llave de API como cualquier otro secreto:

Una llave puede hacer todo dentro de su espacio, incluso borrar. Crea una por agente y guárdala en tu gestor de secretos, no en el repositorio.

Herramientas