Introducción

El servidor MCP de Inbox Autónomo es un servidor Model Context Protocol remoto que expone las mismas operaciones que la API REST pública — inboxes, correos, agentes, ejecuciones, webhooks y el registro de eventos — como tools que un cliente de IA puede llamar. Se conecta por URL; no hay nada que instalar.

Se sirve en su propio host, mcp.inbox.kobana.com.br, con transporte Streamable HTTP en modo stateless y autenticación por Bearer token, emitido para el servidor MCP por el authorization server de Kobana. No hay certificado de cliente: a diferencia de /v1, el host MCP no tiene capa mTLS, y OAuth 2.1 ocupa su lugar.

:::info Disponibilidad El servidor, sus 53 tools, los resources y los prompts están implementados, y la autenticación pasa por el authorization server de Kobana: por el flujo OAuth 2.1, en el que el cliente recibe solo la URL e inicia sesión por su cuenta, o por un token personal creado en tu cuenta Kobana. El edge dedicado (distribution mcp.inbox.*, WAF y DNS) todavía se está aprovisionando. :::

Cuándo usarlo

	API REST (/v1)	Servidor MCP (este)	Servidores stdio
Consumidor	tu backend	un cliente de IA (Claude, ChatGPT, un IDE)	un cliente de IA en tu máquina
Configuración	certificado + token, fuera de banda	una URL	build local + mcp.json
Transporte	HTTPS/REST	Streamable HTTP (JSON-RPC 2.0)	stdio
Autenticación	mTLS + Bearer JWT emitido para la API	OAuth 2.1 o token personal, siempre emitido para el servidor MCP	mTLS + Bearer JWT
Superficie	los endpoints de /v1	53 tools sobre los mismos endpoints, más resources y prompts encima de ellas	un servidor por recurso

El servidor MCP no reemplaza la API REST — cada tool despacha al endpoint dueño de la operación, así que filtros, reglas de upsert, validación y aislamiento multi-tenant son exactamente los mismos. Si estás escribiendo código, usa la API REST. Si estás conectando un asistente, usa este.

Primeros pasos

1. Apunta tu cliente a la URL del servidor — ver Endpoints y Clientes.

2. Autoriza. El cliente abre el login de Kobana; inicia sesión con una cuenta de la organización y autoriza el acceso. Ver Autenticación.

3. Lista las tools para confirmar qué alcanza tu acceso — pídeselo al asistente o, con un token emitido para el servidor MCP a mano:

   curl https://mcp.inbox.kobana.com.br/ \
     -H "Authorization: Bearer $MCP_TOKEN" \
     -H "Content-Type: application/json" \
     -H "Accept: application/json" \
     -H "MCP-Protocol-Version: 2025-06-18" \
     -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/list" }'

4. Explora las tools — la categoría Recursos en la barra lateral documenta cada tool con sus parámetros.

Lo que ve quien llama

tools/list se filtra por lo que quien llama puede ejecutar realmente, en dos ejes:

• los scopes (o el nivel de acceso) del token presentado — el techo del cliente conectado;
• los permisos de la persona que el token nombra — lo que esa persona puede hacer en su organización.

Un token que solo lleva inbox/emails ve únicamente las tools de lectura de correo. Una persona sin emails.reprocess nunca ve emails_reprocess, aunque porte un token que lo permitiría. A un agente no se le informa de capacidades que no puede usar.

Siguientes pasos

• Autenticación — el flujo OAuth, el token personal, scopes y permisos, y los modos de fallo.
• Endpoints — hosts por entorno y rutas servidas.
• Transporte — Streamable HTTP, métodos JSON-RPC y headers.
• Resources y prompts — documentos por URI, prompts listos, autocompletado y la confirmación de tools destructivas.
• Clientes — conectando Claude, Claude Code y otros clientes MCP.
• Límite de solicitudes — throttling y headers de respuesta.
• Paginación — paginación por cursor en los resultados de las tools.
• Idempotencia — idempotency_key para reintentos seguros.
• Errores — errores de protocolo y errores de tool.