Conecta Shinkansen a tu asistente de IA (MCP)
Consulta y opera tu cuenta de Shinkansen desde tu asistente de IA, con los mismos perfiles de acceso que tu equipo usa en el dashboard.
Qué es el MCP de Shinkansen
El Model Context Protocol (MCP) es un estándar abierto que permite que un asistente de IA (por ejemplo Claude, Cursor, ChatGPT u otros clientes compatibles) se conecte de forma segura a herramientas externas.
El servidor MCP de Shinkansen expone un conjunto acotado de herramientas para que puedas consultar y operar tu cuenta usando lenguaje natural desde tu asistente: revisar saldos y movimientos, listar órdenes de pago, crear órdenes, consultar cobros (payins), revisar la vista consolidada de tu grupo, gestionar tu agenda de destinatarios y trabajar con cuentas por cobrar.
El asistente nunca recibe tus claves de API ni certificados. Inicia sesión con tu cuenta del dashboard mediante OAuth y opera exactamente con los mismos permisos que tienes asignados allí.
Acceso bajo solicitud
Para usar el MCP, tu organización debe estar provisionada en Shinkansen y tu usuario debe tener perfiles asignados. Si quieres habilitarlo para tu equipo, coordínalo con tu ejecutivo de Shinkansen o en tu canal de Slack compartido.
Requisitos
Para conectarte necesitas:
- Una cuenta en el dashboard de Shinkansen dentro de tu organización.
- Al menos un perfil asignado (ver Permisos). Sin perfiles, el asistente no tendrá herramientas disponibles.
- Un cliente compatible con MCP que soporte servidores remotos con autenticación OAuth.
Entorno
El servidor MCP de Shinkansen opera sobre tu organización real en producción, con su propia URL de servidor.
| Entorno | URL del servidor | Para qué |
|---|---|---|
| Producción | https://mcp.shinkansen.finance/mcp |
Operación real con tu organización en producción. |
Producción opera con datos y dinero reales
Cada herramienta actúa sobre tu organización real. Las acciones de escritura (por ejemplo, crear una orden de pago) tienen el mismo efecto que si las hicieras desde el dashboard o el API.
Conexión
El servidor MCP de Shinkansen es un servidor remoto que usa transporte HTTP y autenticación OAuth 2.0.
- URL del servidor:
https://mcp.shinkansen.finance/mcp(ver Entorno). - Autenticación: OAuth 2.0. Al conectarte, tu cliente abrirá una ventana del navegador para que inicies sesión con tu cuenta del dashboard de Shinkansen. No tienes que copiar ni pegar ningún token.
Configuración
La mayoría de los clientes MCP aceptan un servidor remoto indicando su URL. Si tu cliente usa un archivo de configuración en JSON, la entrada se ve así. Si tu cliente aún no soporta servidores MCP remotos con OAuth, puedes usar un puente local como mcp-remote.
{
"mcpServers": {
"shinkansen": {
"url": "https://mcp.shinkansen.finance/mcp"
}
}
}
{
"mcpServers": {
"shinkansen": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.shinkansen.finance/mcp"]
}
}
}
Consulta la documentación de tu cliente
Los nombres de campos y la ubicación del archivo de configuración varían según el cliente (Claude Desktop, Cursor, ChatGPT, etc.). En todos los casos los datos a entregar son los mismos: la URL del servidor y, cuando aplique, el inicio de sesión OAuth en el navegador.
Flujo de conexión
- Agrega el servidor
https://mcp.shinkansen.finance/mcpen tu cliente MCP. - Al activarlo, el cliente abre tu navegador para iniciar sesión en Shinkansen.
- Inicia sesión con tu cuenta del dashboard (incluyendo SSO y 2FA si tu organización los tiene configurados).
- Autoriza la conexión. El cliente queda vinculado a tu sesión.
- Tu asistente ya puede usar las herramientas habilitadas para tus perfiles.
Permisos
El MCP respeta el mismo modelo de perfiles del dashboard. Cada herramienta queda disponible solo si tienes un perfil que la habilite; el asistente no puede ver ni invocar herramientas fuera de tus permisos. Si tienes varios perfiles, obtienes la unión de sus capacidades.
Para el catálogo completo de perfiles y la matriz de permisos, consulta Roles y permisos del dashboard.
Si tu usuario tiene perfiles en varias organizaciones de un mismo grupo, el asistente puede consultar cualquiera de ellas en la misma sesión. Las acciones de escritura se hacen siempre en la organización con la que iniciaste sesión.
Si tu acceso cambia, el MCP se actualiza
Cuando se te agrega o quita un perfil, el conjunto de herramientas disponibles para tu asistente se ajusta automáticamente en la siguiente solicitud. No necesitas reconectar.
Herramientas disponibles
La columna Perfil requerido indica qué perfiles habilitan cada herramienta. El perfil Admin siempre las habilita todas, salvo las que dependen de un producto que tu organización no tiene.
Consultas (solo lectura)
| Puedes pedirle a tu asistente | Perfil requerido |
|---|---|
| Ver saldos de tus cuentas | Treasury viewer |
| Ver movimientos bancarios (entries) | Treasury viewer |
| Ver la vista consolidada de tu grupo y las cuentas de cada nivel | Treasury viewer, con acceso al grupo en el dashboard |
| Ver extractos y reportes de cuenta | Operations |
| Ver notificaciones de cobros (payins) | Operations |
| Listar órdenes de pago y ver su detalle | Treasury viewer, submitter, approver o rule editor |
| Consultar tus payouts y el motivo de rechazo del banco | Operations, o Treasury viewer, submitter, approver o rule editor |
| Consultar tu agenda de destinatarios | Treasury viewer, submitter o rule editor |
| Consultar cuentas por cobrar y sus etiquetas | Treasury reconciliator |
| Listar tus cuentas bancarias | Security o Treasury approver |
Consulta de payouts
Los payouts son los pagos enviados por el API, distintos de las órdenes de pago de Treasury. La herramienta es de solo lectura y siempre se limita a tu organización. Está disponible si tu organización tiene el producto de payouts o las órdenes de pago de Treasury, con los mismos perfiles que ven la vista de Payouts del dashboard.
Permite filtrar por ID de Shinkansen, por el transaction_id que asignaste al crear el pago, por destinatario (identificador, cuenta y banco), rango de fechas en UTC, estado (pending, ok o error), rango de monto y lote. Devuelve 10 resultados por página (máximo 50) y, si hay más, meta.next_cursor entrega el valor para pedir la página siguiente con cursor. Cuando un payout falla, el motivo informado por el banco viene en response.response_message; mientras está pendiente no hay respuesta. El tracking_key se devuelve, pero no sirve como filtro.
Acciones (escritura)
| Puedes pedirle a tu asistente | Perfil requerido |
|---|---|
| Crear una orden de pago | Treasury submitter |
| Crear o actualizar un destinatario | Treasury submitter |
| Cargar cuentas por cobrar | Treasury reconciliator |
| Crear etiquetas para cuentas por cobrar | Treasury reconciliator |
Las acciones de escritura son reales
Crear una orden de pago vía MCP equivale a crearla por el API o el dashboard. La aprobación de órdenes sigue el mismo flujo de control humano (perfil Treasury approver) y no se hace vía MCP. Tampoco se pueden crear ni editar reglas de aprobación desde el asistente. Revisa siempre lo que tu asistente propone antes de confirmar una acción.
Controla las órdenes creadas vía MCP con reglas de aprobación
Toda orden de pago creada a través del MCP queda registrada con el origen Agentes. Puedes usarlo para crear reglas de aprobación específicas para esta integración.
En el editor de reglas del dashboard, agrega una condición sobre el campo Origen y elige Agentes. En el listado y el detalle de órdenes de pago, estas órdenes aparecen con la etiqueta Via Agentes, para que puedas reconocerlas de un vistazo. Algunos ejemplos de reglas:
- Exigir aprobación manual de un apoderado para toda orden creada vía MCP, sin importar el monto.
- Combinar el origen con otras condiciones, por ejemplo: requerir doble aprobación para órdenes con origen Agentes por sobre cierto monto.
Estas reglas se crean y editan igual que cualquier otra (perfil Treasury rule editor) y se aplican antes de ejecutar el movimiento de fondos. Así tu equipo puede operar en lenguaje natural sin perder el control humano sobre lo que se ejecuta.
Ejemplos de uso
Una vez conectado, puedes conversar con tu asistente en lenguaje natural. Algunos ejemplos:
- "¿Cuál es el saldo actual de mis cuentas?"
- "Muéstrame las últimas 20 órdenes de pago y su estado."
- "¿Recibimos algún cobro (payin) hoy?"
- "Lista los movimientos bancarios de la última semana."
- "¿Cuánto suma el saldo consolidado del grupo por moneda?"
- "Busca al destinatario con RUT 12.345.678-9 en mi agenda."
- "¿Por qué falló el último pago al RUT 11.111.111-1?"
- "Busca el payout con el ID de mi sistema 0b6c7d1e-5f0a-4b0e-9d2a-3c1f2e4a5b6c."
- "Crea una orden de pago a este destinatario por este monto." (requiere perfil Treasury submitter)
El asistente traduce tu pedido a la herramienta correspondiente y te muestra el resultado.
Seguridad
- Sin claves en el cliente: el asistente nunca recibe tus API keys ni certificados. La autorización se basa en tu sesión OAuth, anclada a tu identidad en el proveedor de identidad de tu organización.
- Permisos acotados: el asistente solo puede usar las herramientas que tus perfiles habilitan. No hay forma de elevar privilegios desde el cliente.
- Mismas políticas de tu organización: si usas SSO con MFA corporativo, restricciones por IP o duración de sesión, esas políticas aplican también al iniciar sesión para el MCP.
- Revocación rápida: quitar un perfil o dar de baja al usuario en tu directorio corporativo retira el acceso en la siguiente solicitud del asistente.
Buenas prácticas
Trata la conexión MCP como una sesión más de tu cuenta de Shinkansen. Conéctala solo desde dispositivos de confianza y desconéctala desde tu cliente cuando dejes de usarla. Aplica el principio de mínimo privilegio: usa una cuenta con solo los perfiles que necesitas para la tarea.
Preguntas frecuentes
¿Necesito un API key o certificado para usar el MCP? No. La conexión usa OAuth con tu cuenta del dashboard. Las claves y certificados se siguen usando para la integración directa por API, no para el MCP.
Mi asistente no ve ninguna herramienta. ¿Qué pasa? Lo más probable es que tu usuario no tenga perfiles asignados en la organización, o que el MCP aún no esté habilitado para tu organización. Verifica tus perfiles en el dashboard y coordina la activación con tu contacto de Shinkansen.
¿Qué clientes son compatibles? Cualquier cliente que soporte servidores MCP remotos con autenticación OAuth. La configuración es la misma en todos: la URL del servidor y el inicio de sesión en el navegador.
