Endpoints

Servidor MCP

Ambiente	URL
Producción	https://mcp.dunning.kobana.com.br
Sandbox	https://mcp.dunning.sandbox.kobana.com.br

La URL del servidor es la raíz del host — esa dirección entera es la que pegas en un cliente MCP. Es también el resource identifier OAuth (el aud que el token tiene que traer), y por eso no lleva ninguna ruta.

:::info Disponibilidad El borde dedicado de estos hosts (distribución mcp.dunning.*, WAF y DNS) aún se está aprovisionando. El servidor y las tools ya están listos — ve Introducción. :::

Rutas servidas

Método	Ruta	Para qué
POST	/	Un mensaje JSON-RPC por solicitud. Toda la superficie de tools.
GET	/.well-known/oauth-protected-resource	Metadata del recurso protegido (RFC 9728). Pública, sin autenticación, con Cache-Control: public, max-age=300.
GET	/	405 con Allow: POST — este servidor es stateless y no abre stream servidor→cliente (sin SSE).
DELETE	/	204 — no hay sesión que terminar.

En el host MCP, cualquier otra ruta responde un 404 en JSON:

{ "error": { "code": "NOT_FOUND", "message": "Not found." } }

Documentación y API

	URL
Documentación	https://docs.dunning.com.br
API REST (producción)	https://api.dunning.kobana.com.br
API REST (sandbox)	https://api.dunning.sandbox.kobana.com.br

La referencia de la API REST empieza en API → Introducción.

tip

Cada ambiente es un recurso distinto, con su propia URL como audience. Un token emitido para sandbox no vale en producción — empieza por sandbox: las tools destructivas envían mensajes a deudores, negativan y protestan de verdad.

:::info Host separado, a propósito El servidor MCP tiene host propio en lugar de una ruta en el host de la API o de la app. El documento de descubrimiento OAuth debe vivir en la raíz del host; ninguna cookie del panel se envía a este origin; y el host de la API tiene una política de borde pensada para integraciones servidor a servidor, no para un cliente de IA. :::

Desarrollo local

En desarrollo el endpoint responde en /mcp en el host de la app — http://localhost:3028/mcp —, y el documento de descubrimiento en http://localhost:3028/.well-known/oauth-protected-resource.

Fuera de desarrollo, llegar a /mcp por un host que no sea mcp.dunning.* responde 404: el endpoint no anuncia que existe en otro lugar.