> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://help.fincome.co/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # Connecter le MCP Fincome Le serveur MCP de Fincome connecte un assistant IA (Claude, Cursor…) à vos KPIs financiers. Vous posez vos questions en langage naturel, l'agent va chercher les chiffres directement dans Fincome — sans export ni copier-coller. # Qu'est-ce que le serveur MCP de Fincome ? Le **MCP** (Model Context Protocol) est un standard ouvert qui permet à un assistant IA de se connecter de façon sécurisée à une source de données. Concrètement, le serveur MCP de Fincome donne à un agent comme **Claude** ou **Cursor** un accès **en lecture seule** à vos **KPIs** financiers : MRR, ARR, churn, revenu, LTV/CAC, etc. | À noter — Le serveur MCP donne accès à vos KPIs agrégés ainsi qu'aux vues détaillées raffinées (par ex. ARR/MRR par client et par mois, mouvements d'ARR, lignes de facturation). Il ne donne pas encore accès aux objets bruts de vos sources de facturation (factures, clients et abonnements tels qu'importés) — cela arrivera dans une prochaine version. L'agent se connecte **en tant que l'un de vos utilisateurs** et voit exactement les mêmes données que cet utilisateur peut consulter dans le tableau de bord — ni plus, ni moins. # À quoi ça sert concrètement ? Le serveur MCP est utile dès que vous voulez **obtenir un chiffre ou une analyse sans passer par l'interface**. Quelques cas d'usage typiques : * **Répondre à une question ponctuelle** sans construire de rapport : *« Combien de nouveaux clients en mai ? »*, *« Quel est mon taux de churn ce trimestre ? »* * **Préparer un point investisseurs ou un board** : demandez à l'agent de récupérer MRR, ARR, croissance et churn sur la période, puis de les mettre en forme. * **Ventiler un KPI par dimension** : *« Quel est mon ARR par produit ? »*, *« Mon churn par pays ce trimestre. »* * **Croiser vos analyses avec d'autres sources** déjà connectées à votre assistant, dans un seul et même fil de discussion. L'intérêt : vos chiffres Fincome deviennent accessibles **là où vous travaillez déjà** avec l'IA, en langage naturel. | Pour découvrir tout ce qu'on peut produire avec le MCP (datapack de due diligence, projections d'ARR à 36 mois, réponses au fil de l'eau), voir [Que peut-on faire avec le MCP Fincome ? Usages et exemples d'analyses](https://help.fincome.co/fr/article/que-peut-on-faire-avec-le-mcp-fincome-usages-et-exemples-danalyses-rofjgk/). # Comment l'installer et le tester (bêta) || Le serveur MCP est actuellement en bêta. Il fonctionne avec **n'importe quel assistant compatible MCP** (Claude, Cursor, Claude Desktop, et les autres clients du protocole). La connexion utilise dans tous les cas les mêmes identifiants que votre tableau de bord Fincome. ### Étape 1 — Ajoutez le serveur MCP à votre assistant La façon d'ajouter un serveur MCP dépend de votre assistant, mais le principe est toujours le même : vous déclarez un connecteur pointant vers l'URL du serveur Fincome. ``` https://mcp.fincome.co/mcp ``` * **Assistants avec interface de connecteurs** : ouvrez la section des connecteurs, choisissez « ajouter un connecteur personnalisé », puis collez l'URL ci-dessus. * **Assistants configurés par fichier** (Cursor, Claude Desktop, etc.) : déclarez le serveur dans votre fichier `mcp.json`. Voir la [documentation technique du serveur MCP](https://docs.fincome.co/mcp). || Vous utilisez Claude ? Le plus simple : Fincome est présent dans le **répertoire des connecteurs de Claude**. Recherchez « Fincome » dans le répertoire et cliquez sur **Connecter** — c'est ajouté en un clic, sans URL à saisir. ### Étape 2 — Activez-le dans votre conversation Une fois ajouté, **activez le connecteur Fincome** dans la conversation où vous souhaitez l'utiliser. Il devient alors disponible pour l'assistant. ### Étape 3 — Connectez votre compte Fincome À la première utilisation, votre assistant vous redirige vers la **page de connexion Fincome** (mêmes identifiants que le tableau de bord). Vous **approuvez l'accès**, et l'agent reçoit un jeton sécurisé, limité à votre utilisateur et votre entreprise. C'est terminé : vous pouvez poser vos questions. || Bon à savoir — La connexion se fait via OAuth 2.1 : aucun mot de passe n'est partagé avec l'assistant, et l'accès est révocable à tout moment depuis Paramètres → Assistants IA connectés dans le tableau de bord. # Vous gérez plusieurs entités ? Chaque connexion est liée à **un seul compte** (un utilisateur et une entreprise). Si vous gérez **plusieurs entités séparées**, il suffit de faire pointer chaque compte sur une **URL différente**, par exemple : ``` https://mcp.fincome.co/mcp2 https://mcp.fincome.co/mcp3 ``` Ajoutez ainsi une connexion par entité, et autorisez chacune avec le compte correspondant. || Le numéro d'URL (/mcp2, /mcp3…) n'identifie pas une entité précise : c'est juste un « emplacement » technique pour contourner les refus de deux fois la même URL. Le choix de l'entité se fait à la connexion. # Et avec Cursor ou Claude Desktop ? Il est également possible de le configurer via un fichier `mcp.json`. Pour ces cas, reportez-vous directement à la [documentation technique du serveur MCP](https://docs.fincome.co/mcp). # Ce que vous pouvez demander à l'agent L'assistant interroge automatiquement vos KPIs selon votre question. Vous n'avez rien à paramétrer — il suffit de formuler votre demande en langage naturel. | Vous voulez… | Exemple de question | | ---- | | Lister les métriques disponibles | *« Quelles métriques Fincome puis-je consulter ? »* | | Une série temporelle d'un KPI | *« Montre-moi mon MRR mensuel sur les 12 derniers mois. »* | | Un KPI ventilé par dimension | *« Quel est mon ARR par produit ? »*, *« Mon churn par pays ce trimestre. »* | | Une analyse combinée | *« Compare mon MRR de janvier et juin, et explique l'écart. »* | En coulisses, l'agent récupère vos métriques (MRR, ARR, churn, revenu, LTV/CAC…), les filtre, les ventile par dimension (y compris vos **axes personnalisés**) et choisit le pas de temps (mois, trimestre, année). # Sécurité et confidentialité La sécurité est au cœur du fonctionnement du serveur MCP : * **Lecture seule** : l'agent peut consulter vos données, mais ne peut **rien modifier** dans Fincome. * **Vos permissions s'appliquent** : l'agent voit exactement ce que voit l'utilisateur connecté, selon ses droits dans le tableau de bord. * **Authentification OAuth 2.1** : aucun mot de passe n'est transmis à l'assistant ; l'accès repose sur un jeton sécurisé, limité à votre utilisateur et votre entreprise. * **Révocable à tout moment** : depuis **Paramètres → Assistants IA connectés**, vous pouvez consulter et supprimer chaque connexion. Ces garanties s'ajoutent à la conformité de la plateforme (SOC 2, RGPD, ISO 27001, hébergement européen). --- # Ce que nous avons produit en 10 minutes Pour vous donner une idée concrète, voici un **datapack de revue financière** (style due diligence) construit de bout en bout via le MCP Fincome — sur un compte de démonstration, en une dizaine de minutes, **sans aucun export ni SQL**. À chaque fois, il a suffi de poser la question en langage naturel et de demander à l'assistant de mettre en forme le résultat : * **Décomposition de l'ARR** par industrie, taille de compte, canal d'acquisition et produit. * **Récurrent vs one-off** et niveau de produits constatés d'avance (PCA). * **Recouvrement** par statut et taux d'impayé. * **Panier moyen (ARPA)** et **LTV** sur 12 mois glissants, au global et par segment. * **Décomposition de la croissance** (new / réactivation / expansion / contraction / churn). * **Acquisition par commercial**, **upsell & NRR par CSM**, et **cohortes NRR sur 24 mois**. * Une **scorecard de synthèse** des KPIs SaaS (ARR, croissance YoY, NRR, GRR, quick ratio, churn, part récurrente…). Le tout a été assemblé directement en tableur et en présentation à partir des réponses de l'agent. 1. [Présentation](https://26202015.fs1.hubspotusercontent-eu1.net/hubfs/26202015/MCP/Fincome%20-%20Draft%20analyses%20v1%20MCP%20SaaSCo%20-%20juin-26.pdf) 2. [Fichier excel](https://26202015.fs1.hubspotusercontent-eu1.net/hubfs/26202015/MCP/01%20Fincome%20-%20Draft%20analyses%20v1%20MCP%20SaaSCo%20-%20juin-26.xlsx) || Envie de voir d'autres livrables ? L'article [Que peut-on faire avec le MCP Fincome ? Usages et exemples d'analyses](https://help.fincome.co/fr/article/que-peut-on-faire-avec-le-mcp-fincome-usages-et-exemples-danalyses-rofjgk/) détaille trois exemples complets (datapack de due diligence, projections d'ARR à 36 mois, et réponses au fil de l'eau). --- # FAQ et erreurs courantes **Quels assistants sont compatibles ?** Tous les clients qui supportent le protocole MCP, comme **Claude** (app et Desktop) et **Cursor**. La connexion se fait soit via le répertoire des connecteurs (Claude), soit via un fichier `mcp.json` (Cursor, Claude Desktop). **L'agent peut-il modifier mes données ?** Non. L'accès est **strictement en lecture seule**. L'assistant peut interroger vos métriques et vos vues, mais ne peut rien créer, modifier ou supprimer dans Fincome. **L'agent voit-il toutes les données de mon entreprise ?** Il voit exactement ce que voit **l'utilisateur connecté**, selon ses permissions Fincome. Si un utilisateur n'a pas accès à certaines données dans le tableau de bord, l'agent n'y aura pas accès non plus. **Comment connecter plusieurs sociétés en même temps ?** Chaque connexion est liée à un utilisateur et une entreprise. Pour en connecter plusieurs, attribuez à chacune **sa propre URL** (`…/mcp`, `…/mcp2`, … jusqu'à `…/mcp10`) et autorisez chaque compte séparément. **Comment révoquer un accès ?** Dans le tableau de bord, allez dans **Paramètres → Assistants IA connectés**. Vous y retrouvez toutes les connexions actives et pouvez les supprimer d'un clic. **Mes identifiants sont-ils partagés avec l'assistant ?** Non. La connexion passe par **OAuth 2.1** : vous vous authentifiez sur la page Fincome, et l'assistant ne reçoit qu'un jeton sécurisé et révocable, jamais votre mot de passe. **Les dates renvoyées correspondent-elles bien à ma demande ?** Les plages de dates sont **inclusives par période entière**. Par exemple, du `2024-05-01` au `2024-05-31` renvoie le mois de mai ; du `2024-05-01` au `2024-06-01` renvoie mai **et** juin. Précisez votre période dans votre question pour lever toute ambiguïté.