Model Context Protocol (MCP)

El servidor del Model Context Protocol (MCP) de Fintoc proporciona un conjunto de herramientas que los agentes de IA pueden usar para interactuar con la API de Fintoc y buscar en la base de conocimiento de Fintoc (incluyendo la documentación). Antes de conectarte, necesitas una cuenta activa de Fintoc con acceso al modo live. También necesitas un cliente compatible: Cursor, VS Code, Claude Code o ChatGPT.

Conectarse al servidor MCP de Fintoc

Los conectores personalizados funcionan en Claude (web, escritorio, móvil y Cowork) en todos los planes — Free, Pro, Max, Team y Enterprise. Para opciones de configuración, consulta la documentación de Claude.Team / Enterprise:

Un Owner debe agregarlo primero en Organization settings → Connectors (Add → Custom → Web).
Ve a Customize → Connectors.
Encuentra el conector personalizado de Fintoc agregado por tu Owner y haz clic en Connect.

Pro / Max / Free:

Ve a Customize → Connectors.
Haz clic en ”+” y luego en Add custom connector.
Ingresa la URL del servidor https://mcp.fintoc.com.
Haz clic en Add, luego conéctate y autentícate vía OAuth.

Habilítalo por conversación mediante el botón ”+” en el chat → Connectors.

Agrega lo siguiente a tu archivo \~/.cursor/mcp.json. Para opciones de configuración, consulta la documentación de Cursor.

{
  "mcpServers": {
    "fintoc": {
      "url": "https://mcp.fintoc.com"
    }
  }
}

Agrega lo siguiente a tu ~/.vscode/mcp.json. Para opciones de configuración, consulta la documentación de Cursor.

{
  "servers": {
    "fintoc": {
      "type": "http",
      "url": "https://mcp.fintoc.com"
    }
  }
}

Ejecuta el siguiente comando:

claude mcp add --transport http fintoc https://mcp.fintoc.com

MCP es un protocolo abierto compatible con muchos clientes. La documentación de tu cliente específico puede orientarte sobre cómo conectarte. Usa la URL del servidor https://mcp.fintoc.com y “OAuth” como mecanismo de conexión si es posible.

{
  "fintoc": {
    "url": "https://mcp.fintoc.com"
  }
}

Cuando el cliente abre la conexión, Fintoc muestra una pantalla de consentimiento. Autoriza en la pantalla de consentimiento y elige los scopes que quieres otorgar a tu sesión MCP. Un token opera solo en modo live. La pantalla de consentimiento solo muestra los scopes que cumplen estas dos condiciones:

Tienes el permiso del recurso correspondiente en el dashboard. Cada scope corresponde a un recurso y nivel de acceso de tu rol en el dashboard. Por ejemplo, movement:view requiere acceso de lectura a Movimientos.
Tu organización tiene el producto al que pertenece el recurso. Por ejemplo, movement:view solo aparece si tu organización tiene el producto Movements.

Si un scope no aparece en la pantalla de consentimiento, Fintoc no puede otorgarlo a tu sesión MCP. Una conexión existente mantiene los scopes que autorizaste para esa conexión. Para usar operaciones que necesitan un scope agregado después de la autorización, vuelve a conectar el cliente. Luego otorga el scope requerido, como Equipo para gestionar los usuarios de tu organización, en la pantalla de consentimiento.

Sesiones de solo lectura

Cada scope tiene un nivel de acceso: view para leer, o manage para crear y modificar datos. Un scope manage incluye el scope view correspondiente. Para darle a un agente acceso de solo lectura, otorga solo scopes view en la pantalla de consentimiento. Las operaciones que requieren un scope manage fallan, así que el agente no puede crear pagos, transferencias ni otros registros.

Herramientas

El servidor expone las siguientes herramientas MCP. Recomendamos habilitar la confirmación humana de las herramientas y tener precaución al usar el MCP de Fintoc con otros servidores para evitar ataques de inyección de prompts. Para pedir más herramientas o enviar comentarios, pídele a tu agente que use la herramienta submit_feedback. También puedes escribirle al soporte de Fintoc a soporte@fintoc.com.

Categoría	Herramienta	Descripción
Operaciones	`fintoc_tool_search`	Busca las operaciones disponibles en el MCP de Fintoc.
Operaciones	`fintoc_tool_details`	Obtiene los parámetros y permisos de una operación.
Operaciones	`fintoc_tool_read`	Lee datos de Fintoc.
Operaciones	`fintoc_tool_write`	Escribe datos en Fintoc. Algunas operaciones pueden mover plata.
Recursos	`fetch_resource`	Obtiene un recurso de Fintoc por su ID.
Otros	`submit_feedback`	Reporta bloqueadores o comportamientos inesperados a Fintoc.

Las herramientas de operaciones permiten usar las acciones compatibles de Fintoc a través de MCP sin exponer una herramienta por cada acción. Así, el conjunto de herramientas disponible para tu cliente se mantiene acotado a medida que Fintoc agrega capacidades.

Operaciones disponibles

El servidor MCP de Fintoc actualmente permite:

Payments: listar y crear customers; listar payment intents, checkout sessions y payment methods; listar, crear y cancelar refunds
Billing: crear, finalizar y anular invoices; listar, crear y actualizar subscriptions
Tus facturas de Fintoc: listar las facturas que Fintoc emite a tu organización
Movements: listar links, cuentas bancarias asociadas y movimientos
Payouts: listar payouts y payout resources
Business Accounts: listar cuentas, cartolas, entidades, números de cuenta y transferencias; crear números de cuenta
Webhooks: listar, crear y actualizar webhook endpoints
Restricciones de IP: agregar un rango de IP permitido (bloque CIDR (Classless Inter-Domain Routing)) a tu organización
Equipo: listar los usuarios de la organización y los roles que se pueden asignar; invitar usuarios con un rol predefinido

Las operaciones disponibles en una sesión dependen de tus productos de Fintoc y de los scopes otorgados durante la autorización.

Scopes requeridos

Cada operación requiere un scope. Usa fintoc_tool_details para ver el scope de una operación específica.

Operaciones	Scope requerido
Listar customers, listar payment methods	`customer:view`
Crear customers	`customer:manage`
Listar payment intents y checkout sessions	`payment:view`
Listar refunds	`refund:view`
Crear y cancelar refunds	`refund:manage`
Crear, finalizar y anular invoices	`invoicing_invoice:manage`
Listar subscriptions	`invoicing_subscription:view`
Crear y actualizar subscriptions	`invoicing_subscription:manage`
Listar tus facturas de Fintoc	`billing:view`
Listar links	`link:view`
Listar cuentas bancarias asociadas y movimientos (producto Movements)	`movement:view`
Listar payouts y payout resources	`payout:view`
Listar cuentas y cartolas de Business Accounts	`account:view`
Listar entidades	`entity:view`
Listar números de cuenta	`account_number:view`
Crear números de cuenta	`account_number:manage`
Listar transferencias	`transfer:view`
Listar webhook endpoints	`webhook_endpoint:view`
Crear y actualizar webhook endpoints	`webhook_endpoint:manage`
Agregar un rango de IP permitido	`allowed_cidr_block:manage`
Listar usuarios de la organización y roles asignables	`organization_user:view`
Invitar usuarios	`organization_user:manage`

Solución de problemas: un scope requerido no aparece en la pantalla de consentimiento

Si una operación falla porque falta un scope, revisa si el scope aparece en la pantalla de consentimiento. Si no aparece, tu usuario del dashboard no tiene el permiso correspondiente o tu organización no tiene el producto. Por ejemplo, list_links funciona pero list_movements falla porque falta el scope movement:view.

Pídele a un Admin de tu organización que te otorgue el nivel de acceso requerido para el recurso en el dashboard. Para movement:view, es acceso de lectura a Movimientos en Conciliación. Revisa Roles de permisos.
Si el recurso no está disponible en tu organización, contacta al soporte de Fintoc para habilitar el producto.
Vuelve a conectar tu cliente MCP y otorga el scope en la pantalla de consentimiento.

Acciones que el servidor no expone Algunas acciones no tienen herramienta a propósito, para que un agente no pueda tomarlas por ti:

Pagar una factura. Usa Pagar una factura.
Cancelar una suscripción. Usa Cancelar una suscripción.
Desasociar el payment method de una suscripción. Usa Desasociar el payment method de una suscripción.
Cambiar el rol de un usuario o eliminar un usuario de tu organización. Usa el dashboard.

Los reembolsos son la excepción. Un reembolso devuelve la plata al cliente que pagó, y puedes cancelarlo mientras siga pendiente.

Conectarse al servidor MCP de Fintoc Docs

El servidor de docs permite que un agente responda preguntas sobre la API de Fintoc consultando la documentación. Úsalo cuando quieras ejemplos de código, búsquedas de endpoints o explicaciones sin salir de tu editor.

Cursor
VS Code
Claude Code
Chat GPT
Other

Agrega lo siguiente a tu archivo \~/.cursor/mcp.json. Para saber más, consulta la documentación de Cursor.

{
  "mcpServers": {
    "fintoc-docs": {
      "url": "https://docs.fintoc.com/mcp"
    }
  }
}

Agrega lo siguiente a tu ~/.vscode/mcp.json. Para saber más, consulta la documentación de Cursor.

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

Ejecuta el siguiente comando:

claude mcp add --transport http fintoc-docs https://docs.fintoc.com/mcp

Puedes habilitar servidores MCP en ChatGPT si tienes una cuenta Pro, Plus, Business, Enterprise o Education. Sigue la documentación de OpenAI para más instrucciones. Usa los siguientes parámetros al configurar tu conector personalizado:

La URL del servidor es https://docs.fintoc.com/mcp.
Usa “OAuth” como mecanismo de conexión.

El servidor MCP de Fintoc también funciona con la response API de Open AI al construir agentes autónomos.

MCP es un protocolo abierto compatible con muchos clientes. La documentación de tu cliente específico puede orientarte sobre cómo conectarte. Usa la URL del servidor https://docs.fintoc.com/mcp.

{
  "fintoc-docs": {
    "url": "https://docs.fintoc.com/mcp"
  }
}

Inicio

Recursos

Pagos

Business Accounts

Movimientos

Skeleton group medium 9

Model Context Protocol (MCP)

Conectarse al servidor MCP de Fintoc

Sesiones de solo lectura

Herramientas

Operaciones disponibles

Scopes requeridos

Solución de problemas: un scope requerido no aparece en la pantalla de consentimiento

Conectarse al servidor MCP de Fintoc Docs

Inicio

Recursos

Pagos

Business Accounts

Movimientos

Skeleton group medium 9

​Conectarse al servidor MCP de Fintoc

​Sesiones de solo lectura

​Herramientas

​Operaciones disponibles

​Scopes requeridos

​Solución de problemas: un scope requerido no aparece en la pantalla de consentimiento

​Conectarse al servidor MCP de Fintoc Docs

Conectarse al servidor MCP de Fintoc

Sesiones de solo lectura

Herramientas

Operaciones disponibles

Scopes requeridos

Solución de problemas: un scope requerido no aparece en la pantalla de consentimiento

Conectarse al servidor MCP de Fintoc Docs