> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fintoc.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Model Context Protocol (MCP)
> Permite que tus agentes de IA interactúen con la API de Fintoc usando nuestro servidor 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 (test o live) y 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:**
1. Un Owner debe agregarlo primero en **Organization settings → Connectors** (Add → **Custom → Web**).
2. Ve a **Customize → Connectors**.
3. Encuentra el conector personalizado de Fintoc agregado por tu Owner y haz clic en **Connect**.
**Pro / Max / Free:**
1. Ve a **Customize → Connectors**.
2. Haz clic en **"+"** y luego en **Add custom connector**.
3. Ingresa la URL del servidor [https://mcp.fintoc.com](https://mcp.fintoc.com).
4. 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**.
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://mcp.fintoc.com](https://mcp.fintoc.com).
* 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.
Agrega lo siguiente a tu archivo `\~/.cursor/mcp.json`. Para opciones de configuración, consulta la documentación de Cursor.
```json theme={null}
{
"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.
```json theme={null}
{
"servers": {
"fintoc": {
"type": "http",
"url": "https://mcp.fintoc.com"
}
}
}
```
Ejecuta el siguiente comando:
```bash theme={null}
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.
```json theme={null}
"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](https://modelcontextprotocol.io/docs/concepts/tools). 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 [product@fintoc.com](mailto:mcp@fintoc.com).
| Recurso | Herramienta | Permiso requerido | API |
| ---------------- | ------------------------ | :---------------------- | ----------------------------------------------------------------------------------------------- |
| Account | `list_accounts` | `account:view` | [List accounts](/es/reference/transfers-api/transfers-accounts/transfers-accounts-list) |
| Account Number | `list_account_numbers` | `account_number:view` | [List account numbers](/es/reference/transfers-api/account-numbers/account-numbers-list) |
| Account Number | `create_account_number` | `account_number:manage` | [Create an account number](/es/reference/transfers-api/account-numbers/account-numbers-create) |
| Checkout Session | `list_checkout_sessions` | `payment:view` | [List checkout sessions](/es/reference/payments-api/checkout-sessions/checkout-sessions-get) |
| Customer | `list_customers` | `customer:view` | [List customers](/es/reference/payments-api/customers/customers-list) |
| Customer | `create_customer` | `customer:create` | [Create a customer](/es/reference/payments-api/customers/customers-create) |
| Entity | `list_entities` | `entity:view` | [List entities](/es/reference/transfers-api/entities/entities-list) |
| Invoice | `list_invoices` | `billing:view` | [List invoices](/es/reference/payments-api/invoices/invoices-list) |
| Invoice | `get_invoice` | `billing:view` | [Get an invoice](/es/reference/payments-api/invoices/invoices-get) |
| Link | `list_links` | `link:view` | [List links](/es/reference/movements-api/links/links-list) |
| Payment Intent | `list_payment_intents` | `payment:view` | [List payment intents](/es/reference/payments-api/payment-intents/payment-intents-list) |
| Payout | `list_payouts` | `payout:view` | [List payouts](/es/reference/payments-api/payouts/payouts-list) |
| Refund | `list_refunds` | `refund:view` | [List refunds](/es/reference/payments-api/refunds/refunds-list) |
| Refund | `create_refund` | `refund:manage` | [Create a refund](/es/reference/payments-api/refunds/refunds-create) |
| Refund | `cancel_refund` | `refund:manage` | [Cancel a refund](/es/reference/payments-api/refunds/refunds-cancel) |
| Transfer | `list_transfers` | `transfer:view` | [List transfers](/es/reference/transfers-api/transfers/transfers-list) |
| Webhook Endpoint | `list_webhook_endpoints` | `webhook_endpoint:view` | [List webhook endpoints](/es/reference/main-resources/webhook-endpoints/webhook-endpoints-list) |
**Otras herramientas**
* `fetch_resource`: Búsqueda polimórfica de cualquier recurso de Fintoc por su id.
* `feedback`: Reporta un bloqueador o comportamiento inesperado al equipo de Fintoc.
## 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.
Agrega lo siguiente a tu archivo `\~/.cursor/mcp.json`. Para saber más, consulta la documentación de Cursor.
```json theme={null}
{
"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.
```json theme={null}
{
"servers": {
"fintoc-docs": {
"type": "http",
"url": "https://docs.fintoc.com/mcp"
}
}
}
```
Ejecuta el siguiente comando:
```bash theme={null}
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](/es/docs/mcp-server/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`.
```json theme={null}
"fintoc-docs": {
"url": "https://docs.fintoc.com/mcp"
}
```