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.

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. Si tienes feedback o quieres ver más herramientas, escríbele al equipo de Fintoc a mcp@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: listar, crear, finalizar y anular invoices; listar, crear y actualizar subscriptions
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 webhook endpoints

Las operaciones disponibles en una sesión dependen de tus productos de Fintoc y de los scopes otorgados durante la autorización. 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.

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"
  }
}

​Conectarse al servidor MCP de Fintoc

​Herramientas

​Operaciones disponibles

​Conectarse al servidor MCP de Fintoc Docs

Conectarse al servidor MCP de Fintoc

Herramientas

Operaciones disponibles

Conectarse al servidor MCP de Fintoc Docs