Convierta sus estados de cuenta desde su asistente de IA
El servidor MCP de BankConv permite que Claude, Cursor, VS Code y otros asistentes de IA conviertan estados de cuenta en PDF. Indíquele al asistente un PDF de su computadora: devuelve los movimientos, con importes con signo y fechas reales, o guarda un archivo CSV, OFX, QFX, QBO o Xero CSV junto al PDF. Necesita una clave de API de BankConv, y basta un solo comando para instalarlo.
npm: bankconv-mcpCódigo fuente: GitHub (MIT)
Instalación
- Inicie sesión en BankConv y cree una clave de API en Equipo → Claves de API. La clave completa se muestra una sola vez: cópiela.
- Agregue el servidor a su asistente con la clave, usando el fragmento de su aplicación que aparece abajo.
- Reinicie la aplicación si lo pide y luego pídale que convierta un estado de cuenta.
Claude Code
claude mcp add bankconv -e BANKCONV_API_KEY=sk_live_your_api_key -- npx -y bankconv-mcpClaude Desktop
Abra Settings, luego Developer, luego Edit Config, y agregue esto a claude_desktop_config.json:
{
"mcpServers": {
"bankconv": {
"command": "npx",
"args": ["-y", "bankconv-mcp"],
"env": { "BANKCONV_API_KEY": "sk_live_your_api_key" }
}
}
}Cursor, Windsurf y otras aplicaciones
Use los mismos command, args y env en la configuración MCP de la aplicación. En Cursor es ~/.cursor/mcp.json.
VS Code
Agregue esto a .vscode/mcp.json en su proyecto, o a su configuración MCP de usuario:
{
"servers": {
"bankconv": {
"command": "npx",
"args": ["-y", "bankconv-mcp"],
"env": { "BANKCONV_API_KEY": "sk_live_your_api_key" }
}
}
}El servidor necesita Node.js 20 o más reciente. npx lo descarga la primera vez que se ejecuta.
Herramientas
El asistente elige la herramienta según su solicitud. Usted no las llama por su nombre.
| Herramienta | Qué hace |
|---|---|
convert_statement | Convierte un PDF de su computadora. Devuelve los movimientos, o guarda un CSV, OFX, QFX, QBO o Xero CSV junto al PDF (o donde usted indique). Acepta la contraseña del PDF si la tiene. |
get_transactions | Obtiene los movimientos de una conversión anterior. |
download_statement | Guarda una conversión anterior en CSV, OFX, QFX, QBO o Xero CSV. |
list_conversions | Lista sus conversiones recientes con su estatus. |
get_credits | Indica cuántas páginas le quedan a su cuenta en el periodo. |
Lo que recibe el asistente
Para los movimientos, el servidor devuelve un breve resumen, en inglés, y luego cada fila en JSON. Los saldos iniciales y las filas de totales se quitan, los abonos son positivos y los cargos negativos, y las fechas son fechas ISO completas aunque el estado de cuenta solo imprima el día y el mes. Esta es la respuesta para nuestro estado de cuenta de ejemplo (datos ficticios, Banco del Ahuehuete, septiembre de 2026):
9 transactions from 2026-09-01 to 2026-09-30 in MXN.
Account: Banco del Ahuehuete · checking · XXXX4821.
Money in 92774.00, money out -46031.00.{
"institution": "Banco del Ahuehuete",
"country": "MX",
"account_type": "checking",
"currency": "MXN",
"period": {
"start": "2026-09-01",
"end": "2026-09-30"
},
"transaction_count": 9,
"transactions": [
{
"date": "2026-09-01",
"description": "SPEI ENVIADO NOMINA QUINCENA",
"reference": null,
"amount": "-24800.00",
"balance": "59323.70"
},
{
"date": "2026-09-02",
"description": "SPEI RECIBIDO COMERCIALIZADORA DEL BAJIO",
"reference": null,
"amount": "38650.00",
"balance": "97973.70"
},
{
"date": "2026-09-03",
"description": "PAGO CFE SUMINISTRADOR",
"reference": null,
"amount": "-1842.00",
"balance": "96131.70"
},
…
]
}Para un archivo, el asistente solo recibe dónde se guardó, con las advertencias que haya, por ejemplo un banco que QuickBooks no reconoce. Los mismos datos están disponibles sin asistente en el endpoint de movimientos de la API.
Qué archivo para qué software
| Pida | Para usarlo en |
|---|---|
| CSV | Excel, Google Sheets, QuickBooks Online y la mayoría de los demás programas. Para Alegra y CONTPAQi, abra el CSV en Excel y pase las columnas a su plantilla. Vea estado de cuenta PDF a CSV. |
| OFX | Xero, MYOB y QuickBooks Online, sin mapear columnas. Ningún software contable mexicano documenta la importación de OFX. Vea OFX. |
| QFX | Quicken. Vea QFX. |
| QBO | QuickBooks Desktop (Web Connect), con el identificador de QuickBooks de su banco. Vea QBO. |
| Xero CSV | Las columnas CSV de Xero, con las fechas en el orden de su banco. Vea Xero. |
Ejemplos de solicitudes
- «Convierte ~/Descargas/septiembre.pdf y dime mis diez gastos más grandes.»
- «Convierte cada PDF de ~/EstadosDeCuenta/2026 en un CSV para pasarlo a la plantilla de Alegra.»
- «Convierte estado-bbva-marzo.pdf a CSV. La contraseña del PDF es 4821.»
- «Suma mis gastos por categoría en estado-banorte-septiembre.pdf y señala todo lo que parezca una suscripción.»
- «Revisa que los movimientos de este estado de cuenta lleguen al saldo final que imprime.»
Pedir los movimientos es la parte útil: el asistente puede luego sumar, categorizar, comparar meses o revisar el saldo, cosas que en una hoja de cálculo tendría que hacer a mano.
Cuánto cuesta
El servidor es gratis. Las conversiones usan sus páginas de BankConv, igual que en el sitio: cada página del PDF cuenta como una página. El primer estado de cuenta de una cuenta gratis se convierte gratis, hasta 5 páginas. Después, necesita las páginas mensuales de un plan; vea los precios. Pregúntele al asistente «¿cuántas páginas de BankConv me quedan?» para revisarlo.
Lo que sale de su computadora
- Hacia BankConv: solo los PDF que usted indique, por HTTPS, con la contraseña si la da. El PDF y sus archivos convertidos se eliminan después de 24 horas de forma predeterminada. Vea seguridad y tratamiento de datos.
- Hacia su proveedor de IA: lo que el asistente lee. Es decir, los movimientos si los pide, o solo la ruta del archivo si pide un archivo. Una contraseña que escriba forma parte del chat.
- En su disco: los archivos que pida, y nada más. El servidor solo lee los archivos que usted indica.
Su clave de API se queda en la configuración MCP de su aplicación y solo se envía a BankConv. Puede revocarla cuando quiera en Equipo → Claves de API.
Preguntas sobre el servidor MCP
¿Qué es el servidor MCP de BankConv?
Un pequeño programa que permite a un asistente de IA usar BankConv. MCP (Model Context Protocol) es el estándar que usan Claude, Cursor, VS Code y otros asistentes para llamar herramientas externas. Con él, usted le pide al asistente que convierta un estado de cuenta en PDF: sube el archivo, espera la conversión y luego devuelve los movimientos o guarda el archivo que pidió.
¿Con qué asistentes funciona?
Con cualquier aplicación que ejecute servidores MCP locales: Claude Code, Claude Desktop, Cursor, VS Code, Windsurf y otras. Corre en su computadora con Node.js 20 o más reciente, así que necesita una aplicación que pueda ejecutar un programa local. Las aplicaciones de chat que solo se conectan a servidores remotos en la web, como ChatGPT, pueden usar en su lugar el servidor remoto https://bankconv.com/mcp: agréguelo como servidor MCP personalizado e inicie sesión con su cuenta de BankConv, sin clave de API.
¿Necesito un plan de pago?
No para probarlo. Una cuenta gratis de BankConv puede crear una clave de API, y su primer estado de cuenta se convierte gratis, hasta 5 páginas. Después, las conversiones usan las páginas mensuales de un plan de pago; cada página del PDF cuenta como una página de su plan.
¿La IA ve mis movimientos bancarios?
Solo si usted los pide. Si pide los movimientos, el servidor pasa las filas al asistente, y llegan a su proveedor de IA según los términos de esa aplicación, como cualquier cosa que pegue en un chat. Si pide un archivo (CSV, OFX, QFX, QBO o Xero CSV), se escribe en su disco y el asistente solo recibe dónde se guardó.
¿Puede leer estados de cuenta protegidos con contraseña o escaneados?
Sí. Dé la contraseña en su solicitud y el servidor la envía junto con el PDF. Los estados de cuenta escaneados se leen con OCR, igual que en el sitio.
¿Es de código abierto?
Sí, con licencia MIT. El código está en GitHub: https://github.com/wassim/bankconv-mcp. Es una capa delgada sobre la API pública de BankConv: no puede hacer nada que su clave de API no permita.