Herramientas de IA (MCP)

Mono publica un servidor MCP para esta documentación. MCP (Model Context Protocol) es un estándar abierto que permite a los asistentes de IA — como Claude o Cursor — conectarse a herramientas y datos externos. Al conectar el MCP de Mono, tu asistente puede buscar en estos documentos, abrir páginas completas y traer recetas de integración listas para usar mientras programas. Si lo activas, también puede ejecutar llamadas reales contra los sandboxes de Bre-B y Core — entornos de pruebas seguros que nunca mueven dinero real — para que pruebes una integración de principio a fin sin salir de tu editor.

Antes de empezar

Necesitarás:

• Una herramienta de IA compatible con MCP — por ejemplo Claude Code o Cursor.

• Solo para llamadas en sandbox (opcional): credenciales de sandbox del producto que quieras probar. Cada producto se autentica distinto:

  • Bre-B (el sistema de pagos instantáneos de Colombia) — tu client_id y client_secret de sandbox desde el panel de Mono, con los scopes de Bre-B habilitados (recaudos, dispersiones, resolución de llaves y cuentas tenant). El MCP inicia sesión con ellas y solicita esos scopes; si falta uno, las llamadas en sandbox se rechazan.
  • Core (ledger programable y emisión de tarjetas) — un token de sandbox de Core que Mono genera para ti. El MCP lo reenvía en cada llamada.

  Puedes agregar Bre-B, Core o ambos — el asistente obtiene las herramientas de cada producto cuando sus credenciales están presentes.

Qué puede hacer tu asistente

Leer la documentación no requiere nada; ejecutar llamadas requiere las credenciales de sandbox correspondientes.

Leer la documentación (sin credenciales):

• buscar en la documentación por significado, no solo por palabras clave;
• abrir cualquier página completa;
• obtener una guía de integración paso a paso para un caso de uso;
• obtener la referencia exacta del API de un endpoint — ejemplos de petición y respuesta, campos y valores permitidos.

Ejecutar llamadas en sandbox de Bre-B: crear un recaudo, generar códigos QR para cobrarlo, simular un pago (por llave o por QR), resolver una llave de pago y enviar una dispersión.

Ejecutar llamadas en sandbox de Core: gestionar el ledger (cuentas, saldos, transferencias) y emitir y administrar tarjetas (titulares, tarjetas, controles de gasto, activación).

Conectar para leer la documentación

Este modo lo aloja Mono y no necesita credenciales. En Claude Code:

claude mcp add --transport http mono-docs https://docs.cert.monoban.co/api/mcp

Otros clientes MCP (Cursor, etc.) se conectan a la misma URL por HTTP (también llamado "Streamable HTTP"). Luego solo pregunta, en lenguaje natural:

¿Cómo recibo mi primer pago por Bre-B? Muéstrame la petición para crear el recaudo.

Tu asistente busca en los documentos, trae la guía de integración y el endpoint exacto, y responde con código funcional y enlaces a las páginas fuente.

Ejecutar llamadas en sandbox (opcional)

Es el mismo MCP alojado — agregas cabeceras de credenciales al conectar y tu asistente obtiene las herramientas de ese producto además de las de documentación. Las credenciales viajan en la conexión, nunca dentro de una pregunta, así se mantienen fuera de tu chat y de los logs; Mono las usa para firmar cada llamada y luego las descarta.

Bre-B

En Claude Code, agrega las dos cabeceras de credenciales:

claude mcp add --transport http mono-docs https://docs.cert.monoban.co/api/mcp \
  --header "X-Mono-Client-Id: <tu client_id de sandbox>" \
  --header "X-Mono-Client-Secret: <tu client_secret de sandbox>"

Luego guíalo en lenguaje natural. Empieza en modo lectura para confirmar la conexión:

Lista mis cuentas tenant de Bre-B.

Después recorre el flujo completo:

Crea un recaudo de Bre-B por COP 50.000, simula un pago y confirma que quedó pagado.

Core

Agrega la cabecera con tu token de sandbox de Core:

claude mcp add --transport http mono-docs https://docs.cert.monoban.co/api/mcp \
  --header "X-Mono-Core-Token: <tu token de sandbox de Core>"

Luego, de nuevo empezando en modo lectura:

Lista mis cuentas de ledger de Core.

Y el flujo completo:

Crea un titular, emite una tarjeta contra una cuenta de ledger con un control de gasto y luego muéstrame la tarjeta.

Ambos a la vez

Para usar las herramientas de Bre-B y Core en la misma conexión, agrega las tres cabeceras:

claude mcp add --transport http mono-docs https://docs.cert.monoban.co/api/mcp \
  --header "X-Mono-Client-Id: <client_id>" \
  --header "X-Mono-Client-Secret: <client_secret>" \
  --header "X-Mono-Core-Token: <token de core>"

Si ya te conectaste solo para documentación, vuelve a agregarlo con estas cabeceras para habilitar las herramientas de sandbox.

Siguientes pasos

• Recaudos de Bre-B — recibe tu primer pago.
• Dispersiones de Bre-B — envía un pago.
• Emisión de tarjetas (Core) — emite y administra tarjetas.
• Soporte técnico — contacta al equipo de Mono.