Instructions du serveur MCP Finch
Connecte Finch à ton assistant IA préféré
Apporte ta situation financière directement dans ton interface de chat IA préférée. En connectant Finch à des assistants comme Claude, ChatGPT ou Gemini, tu peux poser des questions sur ton argent en langage simple, par exemple :
La connexion est totalement sans mot de passe et fluide. Tu n'as pas besoin de copier de clés API ni de gérer des jetons complexes — tu appaires simplement ton assistant avec l'app Finch et tu approuves l'accès grâce à la sécurité biométrique comme Face ID ou l'empreinte digitale.
Ce que ton assistant peut faire
Finch exploite un serveur Model Context Protocol (MCP) qui accorde à ton assistant une seule portée data:read avec 11 outils en lecture seule, fonctionnant uniquement à partir des données que Finch détient déjà. Tout est en lecture seule : l'assistant peut consulter ta vue d'ensemble financière, mais il ne peut rien modifier, ne peut pas déplacer d'argent et ne pousse jamais Finch à contacter une banque. Les chiffres sont aussi récents que la dernière actualisation dans l'app Finch, et tu peux couper la connexion depuis l'app à tout moment.
Outils disponibles
| Outil | Ce qu'il fait |
|---|---|
get_net_worth | Consulte l'évolution de ta valeur nette sur 1D, 1W, 1M, 6M ou YTD dans ta devise de référence. |
list_accounts | Vois tes comptes avec type, devise, solde et horodatage de dernière mise à jour (numéros de compte masqués aux 4 derniers chiffres). |
list_transactions | Récupère tes transactions récentes, les plus récentes d'abord, avec une plage de dates optionnelle (jusqu'à 100 par appel). |
search_transactions | Recherche dans ton historique de transactions en langage naturel (jusqu'à 25 résultats). |
get_spending_summary | Compare revenus et dépenses sur 1W, 1M, 6M, 1Y ou YTD sur tous tes comptes. |
list_stock_holdings | Vois tes positions en actions et ETF. |
list_crypto_holdings | Vois tes positions en cryptomonnaies. |
search_investment_transactions | Parcours tes achats et ventes, filtrables par symbole. |
list_goals | Vérifie tes objectifs d'épargne et ta progression. |
list_assets | Vois les autres actifs que tu suis manuellement (immobilier, véhicules, objets de valeur). |
get_market_snapshot | Lis le briefing de marché partagé de Finch — humeur, mouvements et titres (non personnel). |
Important
- Limites du plan : La disponibilité des données et la fréquence d'actualisation entre l'app Finch et ton serveur MCP dépendent de ton abonnement (Free ou Premium).
- Actualisation des comptes : Doit être lancée directement dans l'app Finch (en tirant pour actualiser). Ton assistant lit toujours les données les plus récentes disponibles dans ton app.
- Connexion et suppression de comptes : Les comptes bancaires ne peuvent être ajoutés que de manière sécurisée dans l'app Finch. La gestion ou la suppression de comptes via MCP n'est pas prise en charge dans la version actuelle.
- Actions d'écriture et chat : Le serveur MCP de Finch est strictement en lecture seule. Le chat Finch AI intégré à l'app et les opérations d'écriture ne sont pas disponibles via MCP. Les recherches web sont gérées directement par l'assistant IA que tu as choisi, pas par Finch.
Quelle est la fraîcheur des données ?
Ton assistant lit les données que Finch détient déjà et ne contacte jamais ta banque.
Chaque compte indique sa dernière mise à jour, et ton assistant te prévient si un chiffre date de plus de quelques jours.
Pour mettre les chiffres à jour, ouvre l'app Finch (ou tire pour actualiser dans l'app), puis pose à nouveau ta question à ton assistant.
Les données des banques suisses (par exemple UBS, ZKB, PostFinance et d'autres) sont présentées à la date de leur dernière actualisation dans l'app Finch elle-même.
Comment connecter ton assistant
- 1
Ajoute l'URL du serveur Finch dans ton assistant
Ajoute l'URL officielle du serveur Finch comme connecteur personnalisé dans ton assistant. La connexion ne requiert ni clés API, ni jetons, ni identifiants web — ton assistant ouvrira la page d'appairage Finch dans ton navigateur avec un code à 8 caractères.
https://api.fjnch.ch/mcp - 2
Ouvre l'app Finch (nécessite Finch 0.4.8 ou plus récent)
Sur ton téléphone, touche « Open Finch on this device » ou ouvre l'app manuellement et navigue vers Menu › API keys › Connect an AI assistant.
- 3
Approuve la connexion
Vérifie le nom de domaine enregistré de l'assistant sur l'écran de consentement et confirme avec Face ID ou ton empreinte. La connexion se termine automatiquement en quelques secondes.
- 4
Commence à poser des questions
La fenêtre d'appairage du navigateur redirige ou confirme automatiquement la connexion, et Finch apparaît dans la liste de tes assistants connectés dans l'app. Il n'y a aucun jeton ni identifiant à stocker.
Instructions pas à pas par assistant
Claude (Web & Desktop)
- 1Navigue vers Settings › Connectors › Add custom connector.
- 2Définis le nom sur Finch et la Remote MCP server URL sur l'URL officielle du serveur Finch. Laisse les champs du client OAuth vides — Finch gère l'enregistrement du client automatiquement.
- 3Clique sur Add, puis sur Connect pour ouvrir la page d'appairage Finch.
- 4Termine les étapes d'approbation dans ton app Finch.
- 5Dans n'importe quelle session de chat, vérifie que Finch est activé dans le menu des outils et commence à poser des questions sur tes finances. (Cowork utilise le même connecteur.)
ChatGPT
- 1Va dans Settings › Connectors › Advanced et active le Developer mode.
- 2Sélectionne Connectors › Create. Entre Finch comme nom et définis la MCP server URL sur l'URL officielle du serveur Finch. Choisis OAuth comme type d'authentification et clique sur Save/Create.
- 3Ouvre un nouveau chat, sélectionne le connecteur Finch dans les outils du mode développeur et suis les instructions du navigateur pour appairer ton app.
Gemini CLI
- 1Ouvre ton terminal et ajoute le serveur Finch :
- 2Exécute /mcp auth finch dans Gemini CLI pour ouvrir la fenêtre d'appairage, puis termine l'autorisation dans l'app mobile Finch.
gemini mcp add --transport http finch https://api.fjnch.ch/mcpConfidentialité et sécurité
Où vont tes données
Toute information financière que tu demandes pendant une conversation est envoyée au fournisseur de l'assistant que tu as choisi (comme Anthropic, OpenAI ou Google), qui peut la traiter en dehors de la Suisse selon ses propres conditions.
Vérifie le domaine, pas le nom
N'importe quelle application peut s'appeler « Claude » ou « ChatGPT ». Vérifie toujours le domaine enregistré de l'assistant sur l'écran de consentement dans l'app Finch (par ex. claude.ai), et n'approuve que les demandes que tu as toi-même initiées depuis ce site.
Ne contacte jamais ta banque
Un assistant ne peut pas déclencher d'actualisation bancaire ni consommer les quotas d'actualisation bancaire de ton plan. Il lit uniquement ce que Finch détient déjà.
Déconnexion à tout moment
Déconnecte-toi à tout moment dans l'app Finch via Menu › API keys › Connected assistants. La déconnexion prend effet à la prochaine requête de l'assistant — supprimer simplement le connecteur dans l'app de l'assistant ne révoque pas l'accès côté Finch.
Aucun jeton à gérer
Il n'y a aucune clé à stocker ou à garder secrète. Les connexions restent actives tant que tu les utilises ; les connexions inutilisées pendant 7 jours expirent et nécessitent une nouvelle approbation.
Coordonnées bancaires protégées
Les numéros de compte sont toujours masqués à leurs quatre derniers chiffres. Les IBAN complets et les identifiants sensibles ne quittent jamais les serveurs de Finch.
Dépannage et FAQ
Le code a expiré.+
Les codes d'appairage sont valables 10 minutes. Relance la configuration de la connexion depuis ton assistant pour générer un nouveau code.
Aucune connexion en attente ne correspond à ce code.+
Vérifie bien les caractères saisis. Les codes ne contiennent jamais 0, O, 1 ou I. Après 10 codes incorrects, la saisie est suspendue pendant 10 minutes.
Redirection non enregistrée.+
L'assistant a renvoyé Finch vers une adresse différente de celle enregistrée. Supprime le connecteur dans ton assistant et rajoute-le.
L'assistant indique que Finch n'est pas autorisé.+
Cela se produit après une déconnexion manuelle dans l'app ou après 7 jours consécutifs d'inactivité. Relance la connexion depuis ton assistant pour approuver à nouveau l'accès.
La page d'appairage ne revient pas à l'assistant.+
Retourne dans ton assistant et vérifie si Finch apparaît comme connecté. Sinon, supprime le connecteur dans ton assistant et rajoute-le.
L'assistant répond avec d'anciens soldes.+
L'assistant lit les données Finch existantes et ne contacte jamais la banque directement. Ouvre l'app Finch, tire pour actualiser tes comptes, puis repose ta question. Si l'app te demande de reconnecter ta banque, fais d'abord cette étape.
Le bouton « Open Finch on this device » ne réagit pas / Je ne trouve pas « Connect an AI assistant ».+
Ta version de l'app est plus ancienne que 0.4.8. Mets à jour l'app Finch via l'App Store, puis saisis le code d'appairage manuellement sous Menu › API keys › Connect an AI assistant.
Accès et support
Contacte notre équipe de support si tu rencontres des problèmes d'accès à ton serveur MCP ou si tu souhaites demander une fonction MCP Server étendue pour toi ou ton équipe.
Obtenir de l'aide





