Kobana

Servidores MCP para construir agentes sobre Kobana

Cada producto tiene un servidor MCP remoto en mcp.{producto}.kobana.com.br, con OAuth 2.1, alcances por recurso y los permisos de quien lo autorizó.

Ver los servidoresGuía para usuarios
Servidores MCP para construir agentes sobre Kobana

Cómo funcionan los servidores MCP

Streamable HTTP, sin estado

Un mensaje JSON-RPC 2.0 por POST, sin sesión. La URL es la raíz del host, sin ruta.

OAuth 2.1 con PKCE

El cliente descubre dónde autenticar a partir de la URL y abre la pantalla de inicio de sesión de Kobana. No hay client secret.

Token personal, cuando no hay OAuth

Crea en la Cuenta Kobana un token con la aplicación del producto y el uso MCP, y envíalo en Authorization: Bearer.

Alcance y permisos

El token limita al cliente por recurso y nivel (read o write). Los permisos del panel de quien lo autorizó limitan el resto, y se releen en cada llamada.

Tools anotadas

Cada tool declara si es de lectura, escritura o destructiva. Las destructivas solo se ejecutan tras una confirmación.

Las mismas barreras de la API

La tool llama al mismo código de la API REST: cuenta habilitada, suscripción activa, producto en el plan y lista de IPs permitidas.

Servidores por producto

Pega la URL del producto en el cliente MCP. El Gateway Bancario también tiene un host de sandbox, con tokens separados de los de producción.

Gateway Bancario

289 tools

Producción

https://mcp.banking.kobana.com.br

Sandbox

https://mcp.banking.sandbox.kobana.com.br

Opera en la cuenta del token. Para una subcuenta, envía el encabezado X-Account-Uid.

Documentación del MCP →

Financiero Inteligente

96 tools

Producción

https://mcp.finance.kobana.com.br

El workspace se elige en cada llamada, con finance_workspaces_list y el argumento workspace_id.

Documentación del MCP →

Prueba la conexión

Con un token emitido para MCP, lista las tools a las que llega. Cambia el host por el del producto que quieres probar.

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

Si llegan menos tools de las esperadas, es el alcance del token o los permisos de quien lo autorizó. No es un error.

Conectar un cliente

Cualquier cliente con Streamable HTTP y OAuth 2.1 conecta solo con la URL.

Claude Code

Agrega el servidor y autentica con /mcp.

claude mcp add --transport http kobana-banking https://mcp.banking.kobana.com.br

Cliente configurado por archivo

Con token personal, envía el encabezado de autorización. Trata el archivo como un secreto.

{
  "mcpServers": {
    "kobana-banking": {
      "type": "http",
      "url": "https://mcp.banking.kobana.com.br",
      "headers": {
        "Authorization": "Bearer <token>"
      }
    }
  }
}

Token personal

Cuenta Kobana → Tokens y Acceso → Mis Tokens Personales → Nuevo Token, con el uso MCP. Elige la menor vigencia que tu uso permita.

Postura recomendada para agentes

  • Autoriza con el usuario correcto: Un cliente autorizado por un usuario de solo lectura solo ve las tools de lectura, haga lo que haga el modelo.
  • Pide solo lo que el agente necesita: Marca los recursos necesarios y deja write sin marcar para uso exploratorio.
  • Un token por cliente: Cada cliente recibe su token, que solo vale en el MCP. Revócalo en Aplicaciones Autorizadas sin afectar las integraciones REST.
  • En el Gateway Bancario, empieza en el sandbox: Las tools destructivas cancelan boletos, pagan cuentas y transfieren dinero de verdad.
  • El dato de terceros no es una instrucción: Nombres, descripciones y observaciones los escriben otras personas. Los servidores indican al agente que no obedezca órdenes en esos campos.

¿Solo quieres usarlo, sin integrar?

Tenemos una guía para conectar el asistente a tu cuenta Kobana, con paso a paso para Claude, ChatGPT y Cursor.

Ver la guía para usuarios

¿Construimos tu agente?

Cuéntanos qué necesita hacer tu agente y te ayudamos a diseñar la integración.

Agendar charla
Agendar