MCP de la Documentación

Esta documentación tiene su propio servidor MCP. Con él, un asistente de IA (Claude, ChatGPT, Cursor, VS Code, Claude Code) busca y lee las páginas de este sitio sin que tengas que copiar y pegar nada. Así, las respuestas sobre el Gateway Bancario salen del contenido publicado, en el idioma que elijas.

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

No es el MCP del producto

El MCP de la Documentación solo lee la documentación. No accede a tu cuenta, no ve boletos, pagos ni extractos y no cambia nada. Para que un agente opere el Gateway Bancario, usa el MCP del producto (mcp.banking.kobana.com.br), que pide inicio de sesión y respeta tus permisos. Consulta MCP › Clientes.

Cómo funciona

• Público y de solo lectura: no pide inicio de sesión ni token. Expone el mismo contenido que cualquier persona ve en el sitio.
• Siempre actualizado: lee la versión publicada de la documentación. Una página nueva o modificada aparece en el MCP en cuanto se publica el sitio.
• Tres idiomas: portugués (pt), inglés (en) y español (es). Si no se indica idioma, usa el portugués.
• Transporte: Streamable HTTP, sin sesión. Funciona con cualquier cliente MCP que se conecte a un servidor remoto por URL.

Tools

Tool	Qué hace	Parámetros
search_docs	Busca páginas por palabras clave en el título, la ruta y el resumen, sin distinguir acentos ni mayúsculas. Devuelve las mejores páginas con ruta y resumen	query (obligatorio), locale, limit (1 a 25, por defecto 8)
get_page	Devuelve el contenido completo de una página en Markdown	path: la ruta que devolvió search_docs o list_pages (por ejemplo, /es/boletos) o la URL completa
list_pages	Lista todas las páginas, con ruta y resumen	locale

El asistente decide solo cuándo llamar a cada tool. Normalmente busca con search_docs y lee con get_page las páginas que le interesan.

Cómo instalarlo

La forma más rápida es el menú Copiar página, arriba de cada página de este sitio. En MCP de la Documentación encontrarás:

• Conectar a Cursor y Conectar a VS Code: instalan el servidor con un clic.
• Copiar config del MCP: copia el bloque JSON para clientes configurados por archivo.
• Copiar comando del MCP: copia el comando de instalación para la terminal.

Si prefieres configurarlo a mano, los pasos de cada cliente están abajo.

Cualquier cliente, desde la terminal

add-mcp detecta los clientes instalados en tu equipo y les agrega el servidor:

npx add-mcp "https://docs.banking.kobana.com.br/mcp"

Claude Code

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

Cursor

Usa Conectar a Cursor en el menú de la página, o agrega esto a ~/.cursor/mcp.json (para todos los proyectos) o al .cursor/mcp.json del proyecto:

{
  "mcpServers": {
    "kobana-banking-docs": {
      "url": "https://docs.banking.kobana.com.br/mcp"
    }
  }
}

VS Code

Usa Conectar a VS Code en el menú de la página, o crea .vscode/mcp.json en el proyecto. En VS Code la clave es servers, no mcpServers:

{
  "servers": {
    "kobana-banking-docs": {
      "type": "http",
      "url": "https://docs.banking.kobana.com.br/mcp"
    }
  }
}

Claude y ChatGPT

En Configuración › Conectores, agrega un conector personalizado y pega la URL https://docs.banking.kobana.com.br/mcp. No hay inicio de sesión.

Otros clientes configurados por archivo

{
  "mcpServers": {
    "kobana-banking-docs": {
      "type": "http",
      "url": "https://docs.banking.kobana.com.br/mcp"
    }
  }
}

Ejemplos de preguntas

Con el servidor conectado, pregunta con normalidad. El asistente consulta la documentación antes de responder:

• "¿Cómo cancelo un boleto registrado y qué pasa en el banco?"
• "¿Cómo funciona la aprobación de pagos en lote?"
• "¿Cómo creo un cobro Pix con código QR dinámico?"
• "Arma un ejemplo de llamada a la API para emitir un boleto, según la documentación."

Probar sin cliente

curl -s https://docs.banking.kobana.com.br/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_docs","arguments":{"query":"webhook","locale":"es"}}}'

Límites

• Las páginas de referencia de cada endpoint de la API (/api/v1/... y /api/v2/...) no están en el MCP. La fuente legible por máquina de la API es la especificación OpenAPI, en API › OpenAPI.
• La búsqueda es por palabras clave, no semántica. Si no encuentras nada, prueba otros términos o pide al asistente que use list_pages.
• También puedes leer cualquier página en Markdown agregando .md a su URL, o descargar toda la documentación en llms-full.txt.