live. También necesitas un cliente compatible: Cursor, VS Code, Claude Code o ChatGPT.
Conectarse al servidor MCP de Fintoc
- Claude
- Chat GPT
- Cursor
- VS Code
- Claude Code
- Other
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.
- 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.
- 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:viewrequiere acceso de lectura a Movimientos. - Tu organización tiene el producto al que pertenece el recurso. Por ejemplo,
movement:viewsolo aparece si tu organización tiene el producto Movements.
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 herramientasubmit_feedback. También puedes escribirle al soporte de Fintoc a soporte@fintoc.com.
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.
Aprobar varias escrituras de una vez
En los clientes MCP compatibles con solicitudes de formulario (elicitación), cada llamada afintoc_tool_write te pide confirmarla. Tu agente puede pedir una aprobación para todas las llamadas en un solo formulario. Usa la aprobación agrupada cuando el agente necesita ejecutar la misma operación de escritura dos o más veces, por ejemplo para crear números de cuenta para dos o más clientes:
- El agente llama a
fintoc_request_write_approvalcon laoperationy unparams_listque contiene un conjunto de parámetros por llamada, de 1 a 50 entradas. Antes de preguntarte, Fintoc revisa que la sesión pueda ejecutar la operación. En las operaciones propias de Fintoc, Fintoc también revisa cada entrada contra los parámetros de la operación e indica por número las entradas con errores. - Revisas la operación y todas las entradas en un solo formulario de confirmación y las apruebas.
- Fintoc devuelve un
approval_id. Luego, el agente llama afintoc_tool_writeuna vez por entrada con elapproval_id, la posición de la entrada enapproval_entry(desde 1) y los parámetros exactos de esa entrada.
fintoc_tool_write, sin aprobación.
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
Scopes requeridos
Cada operación requiere un scope. Usafintoc_tool_details para ver el scope de una operación específica.
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.
- 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.
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.