Convertir vos relevés bancaires depuis votre assistant IA
Le serveur MCP de BankConv permet à Claude, Cursor, VS Code et à d’autres assistants IA de convertir des relevés bancaires PDF. Indiquez à l’assistant un PDF sur votre ordinateur : il renvoie les opérations, avec des montants signés et de vraies dates, ou enregistre un fichier CSV, OFX, QFX, QBO ou CSV Xero à côté du PDF. Il faut une clé d’API BankConv, et une seule commande suffit pour l’installer.
npm : bankconv-mcpCode source : GitHub (MIT)
Installation
- Connectez-vous à BankConv et créez une clé d’API dans Équipe → Clés API. La clé complète ne s’affiche qu’une fois : copiez-la.
- Ajoutez le serveur à votre assistant avec la clé, à l’aide de l’extrait de votre application ci-dessous.
- Redémarrez l’application si elle le demande, puis demandez-lui de convertir un relevé.
Claude Code
claude mcp add bankconv -e BANKCONV_API_KEY=sk_live_your_api_key -- npx -y bankconv-mcpClaude Desktop
Ouvrez Settings, puis Developer, puis Edit Config, et ajoutez ceci à claude_desktop_config.json :
{
"mcpServers": {
"bankconv": {
"command": "npx",
"args": ["-y", "bankconv-mcp"],
"env": { "BANKCONV_API_KEY": "sk_live_your_api_key" }
}
}
}Cursor, Windsurf et autres applications
Utilisez les mêmes command, args et env dans les réglages MCP de l’application. Dans Cursor, c’est ~/.cursor/mcp.json.
VS Code
Ajoutez ceci à .vscode/mcp.json dans votre projet, ou à vos réglages MCP utilisateur :
{
"servers": {
"bankconv": {
"command": "npx",
"args": ["-y", "bankconv-mcp"],
"env": { "BANKCONV_API_KEY": "sk_live_your_api_key" }
}
}
}Le serveur nécessite Node.js 20 ou plus récent. npx le télécharge au premier lancement.
Outils
L’assistant choisit l’outil d’après votre demande. Vous ne les appelez pas par leur nom.
| Outil | Ce qu’il fait |
|---|---|
convert_statement | Convertit un PDF de votre ordinateur. Renvoie les opérations, ou enregistre un CSV, OFX, QFX, QBO ou CSV Xero à côté du PDF (ou là où vous le dites). Accepte le mot de passe du PDF s’il en a un. |
get_transactions | Récupère les opérations d’une conversion précédente. |
download_statement | Enregistre une conversion précédente en CSV, OFX, QFX, QBO ou CSV Xero. |
list_conversions | Liste vos conversions récentes avec leur statut. |
get_credits | Indique combien de pages il reste à votre compte sur la période. |
Ce que reçoit l’assistant
Pour les opérations, le serveur renvoie un court résumé, en anglais, puis chaque ligne en JSON. Les soldes d’ouverture et les lignes de total sont retirés, les entrées sont positives et les sorties négatives, et les dates sont des dates ISO complètes même quand le relevé n’imprime que le jour et le mois. Voici la réponse pour notre relevé d’exemple (données fictives, Banque des Tilleuls, septembre 2026) :
9 transactions from 2026-09-01 to 2026-09-30 in EUR.
Account: Banque des Tilleuls · checking · XXXX4821.
Money in 5610.70, money out -3539.62.{
"institution": "Banque des Tilleuls",
"country": "FR",
"account_type": "checking",
"currency": "EUR",
"period": {
"start": "2026-09-01",
"end": "2026-09-30"
},
"transaction_count": 9,
"transactions": [
{
"date": "2026-09-01",
"description": "PRLV SEPA URSSAF",
"reference": null,
"amount": "-412.00",
"balance": "8000.37"
},
{
"date": "2026-09-02",
"description": "VIR SEPA RECU STRIPE PAYMENTS",
"reference": null,
"amount": "2486.50",
"balance": "10486.87"
},
{
"date": "2026-09-03",
"description": "CB OVH CLOUD 02/09",
"reference": null,
"amount": "-59.99",
"balance": "10426.88"
},
…
]
}Pour un fichier, l’assistant ne reçoit que l’endroit où il a été enregistré, avec d’éventuels avertissements, par exemple une banque que QuickBooks ne connaît pas. Les mêmes données sont disponibles sans assistant via le point d’accès transactions de l’API.
Quel fichier pour quel logiciel
| Demandez | Pour l’utiliser dans |
|---|---|
| CSV | Excel, Google Sheets, QuickBooks Online et la plupart des autres logiciels. Voir relevé bancaire PDF en CSV. |
| OFX | Pennylane, EBP Compta, Sage 50, Xero, MYOB et QuickBooks Online, sans association de colonnes. Voir OFX. |
| QFX | Quicken. Voir QFX. |
| QBO | QuickBooks Desktop (Web Connect), avec l’identifiant QuickBooks de votre banque. Voir QBO. |
| CSV Xero | Les colonnes CSV de Xero, avec les dates dans l’ordre de votre banque. Voir Xero. |
Exemples de demandes
- « Convertis ~/Téléchargements/septembre.pdf et liste mes dix plus grosses dépenses. »
- « Transforme chaque PDF de ~/Relevés/2026 en fichier OFX pour Pennylane. »
- « Convertis releve-bnp-mars.pdf en OFX pour EBP. Le mot de passe du PDF est 4821. »
- « Additionne mes dépenses par catégorie dans releve-qonto-septembre.pdf et signale tout ce qui ressemble à un abonnement. »
- « Vérifie que les opérations de ce relevé aboutissent bien au nouveau solde qu’il imprime. »
Demander les opérations est la partie utile : l’assistant peut ensuite totaliser, catégoriser, comparer des mois ou vérifier le solde, ce qu’un tableur vous ferait faire à la main.
Ce que ça coûte
Le serveur est gratuit. Les conversions utilisent vos pages BankConv, comme sur le site : chaque page de PDF compte pour une page. Le premier relevé d’un compte gratuit est converti gratuitement, jusqu’à 5 pages. Ensuite, il faut les pages mensuelles d’une formule ; voir les tarifs. Demandez à l’assistant « combien de pages BankConv me reste-t-il ? » pour vérifier.
Ce qui quitte votre ordinateur
- Vers BankConv : seulement les PDF que vous indiquez, en HTTPS, avec le mot de passe si vous en donnez un. Le PDF et ses fichiers convertis sont supprimés après 24 heures par défaut. Voir sécurité et traitement des données.
- Vers votre fournisseur d’IA : ce que l’assistant relit. Donc les opérations si vous les demandez, ou seulement le chemin du fichier si vous demandez un fichier. Un mot de passe que vous tapez fait partie du chat.
- Sur votre disque : les fichiers demandés, et rien d’autre. Le serveur ne lit que les fichiers que vous indiquez.
Votre clé d’API reste dans les réglages MCP de votre application et ne part que vers BankConv. Vous pouvez la révoquer à tout moment dans Équipe → Clés API.
Questions sur le serveur MCP
Qu’est-ce que le serveur MCP de BankConv ?
Un petit programme qui permet à un assistant IA d’utiliser BankConv. MCP (Model Context Protocol) est le standard qu’utilisent Claude, Cursor, VS Code et d’autres assistants pour appeler des outils externes. Avec lui, vous demandez à l’assistant de convertir un relevé PDF : il envoie le fichier, attend la conversion, puis renvoie les opérations ou enregistre le fichier demandé.
Avec quels assistants fonctionne-t-il ?
Toute application qui lance des serveurs MCP locaux : Claude Code, Claude Desktop, Cursor, VS Code, Windsurf et d’autres. Il tourne sur votre ordinateur avec Node.js 20 ou plus récent : il lui faut une application capable de lancer un programme local. Les applications de chat qui ne se connectent qu’à des serveurs distants sur le web, comme ChatGPT, peuvent utiliser à la place le serveur distant https://bankconv.com/mcp : ajoutez-le comme serveur MCP personnalisé et connectez-vous avec votre compte BankConv, sans clé d’API.
Faut-il une formule payante ?
Pas pour l’essayer. Un compte BankConv gratuit peut créer une clé d’API, et son premier relevé est converti gratuitement, jusqu’à 5 pages. Ensuite, les conversions utilisent les pages mensuelles d’une formule payante ; une page de PDF compte pour une page de votre quota.
L’IA voit-elle mes opérations bancaires ?
Seulement si vous les demandez. Si vous demandez les opérations, le serveur transmet les lignes à l’assistant, et elles partent chez votre fournisseur d’IA selon les conditions de cette application, comme tout ce que vous collez dans un chat. Si vous demandez un fichier (CSV, OFX, QFX, QBO ou CSV Xero), il est écrit sur votre disque et l’assistant ne reçoit que l’endroit où il a été enregistré.
Peut-il lire les relevés protégés par mot de passe ou scannés ?
Oui. Donnez le mot de passe dans votre demande et le serveur l’envoie avec le PDF. Les relevés scannés sont lus par OCR, comme sur le site.
Est-il open source ?
Oui, sous licence MIT. Le code est sur GitHub : https://github.com/wassim/bankconv-mcp. C’est une fine couche au-dessus de l’API publique de BankConv : il ne peut rien faire que votre clé d’API ne permette pas.