Introducción al MCP de kiban
Conecta Claude (u otro cliente MCP) a workfloo, link y rekon para operar kiban conversando.
El MCP de kiban es un servidor Model Context Protocol que expone kiban cloud a asistentes de IA. Conectado a Claude, puedes pedirle en lenguaje natural cosas como "lista los workfloos que puedo ejecutar", "corre la consulta de CURP para este dato" o "¿en qué paso quedó esta ejecución?", y el asistente llama a kiban por ti.
No reemplaza a la consola ni a la API: es una tercera puerta de entrada a lo mismo, pensada para operar de forma conversacional.
Qué puedes hacer
| Módulo | Alcance |
|---|---|
| workfloo | Descubrir qué workfloos puedes ejecutar, iniciar una ejecución, llenar su formulario, mandar y validar el NIP, subir documentos, consultar estado y resultado, y descargar archivos. |
| link | Consultar el catálogo de servicios y ejecutar una consulta puntual (CURP, RFC/SAT, IMSS, ISSSTE, INE, CEP, cédula, RUG, DOF, SEPOMEX…). |
| rekon | Listar los pagos recibidos. Es de solo lectura: no mueve dinero. |
Son 15 herramientas en total, con prefijo por módulo (workfloo_*, link_*, rekon_*). Ve la lista completa en Herramientas disponibles.
Cómo se conecta
El servidor habla JSON-RPC 2.0 sobre Streamable HTTP en un solo endpoint:
https://mcp.kiban.com/mcpHay dos formas de autenticarte, y la que elijas depende del cliente:
| claude.ai | Claude Code | |
|---|---|---|
| Cómo te autenticas | Login en kiban (OAuth) | Tu api-key en un header |
| Pegas credenciales | No | Sí (x-api-key) |
| Eliges espacio | Sí, en la pantalla de consentimiento | El espacio de la api-key |
| Alcance | Los tres módulos con una sola credencial | Una herramienta por key: workfloo o link (las api-keys no son intercambiables) |
| Módulo rekon | ✅ Disponible | ❌ Requiere login |
| Guía | Conectar claude.ai | Conectar Claude Code |
El backend siempre es la autoridadEl MCP no guarda credenciales ni permisos propios: reenvía tu identidad a workfloo, link y rekon, que aplican los mismos derechos, límites y cobros que si entraras por la consola o por la API. Si tu usuario no puede ejecutar un workfloo, el MCP tampoco.
Producción y sandbox
Todas las herramientas aceptan un argumento sandbox. El valor por defecto es false, es decir producción: costo y efectos reales.
Para ensayar sin costo, pídele explícitamente al asistente que trabaje en sandbox y revisa Ejecutar en sandbox.
Cada ejecución en producción se cobraUna consulta lanzada desde el chat genera costo igual que una lanzada desde la consola. Antes de correr algo en producción, confirma con el asistente qué va a ejecutar.
Qué no hace
- No diseña ni edita workfloos. Eso sigue en el editor de la consola.
- No captura contraseñas. Los pasos que piden una credencial en texto plano (la CIEC del SAT, por ejemplo) no se completan desde el MCP.
- No consulta buró ni círculo de crédito. Están bloqueados por política; ver Seguridad y límites.
- No mueve dinero. El módulo rekon es de solo lectura.
Updated about 16 hours ago