1. Créer le jeton
Dans l'application Margeo, section de connexion Claude. Le jeton est une chaîne de 32 caractères hexadécimaux, valable un an, révocable immédiatement.
Connecteur MCP Claude : brancher Claude sur votre stock Margeo
Réponse directe : Margeo expose un serveur MCP à l'adresse https://margeoapp.com/mcp. Il donne à Claude Desktop, Claude Code ou Claude.ai 41 outils pour lire et mettre à jour votre stock, vos ventes, vos lots, vos dépenses et votre fiscalité, en langage naturel. Il est inclus dans Pro mensuel (7,99 €/mois), Pro annuel (69 €/an) et Business (19,99 €/mois), jamais dans Starter.
Par Jules Bege · Mis à jour le
Ce que le connecteur change concrètement
Sans connecteur, un assistant IA ne connaît pas votre activité : vous lui décrivez votre stock, vos frais et vos ventes à la main, à chaque conversation, et il répond sur des généralités. Avec le connecteur MCP, Claude interroge vos données et répond sur votre situation.
La différence est nette sur les questions où le chiffre d'affaires trompe. Un revendeur qui a encaissé 18 000 € et un autre qui a encaissé 18 000 € n'ont pas la même marge nette : l'un vend des articles achetés 4 €, l'autre des pièces achetées 60 €. Un assistant sans accès à vos données répondra la moyenne du marché ; un assistant connecté répondra la vôtre.
Comment ça se branche
2. Déclarer le serveur
Dans Claude Desktop, Claude Code ou Claude.ai, ajoutez le serveur MCP d'adresse https://margeoapp.com/mcp et transmettez le jeton en en-tête Authorization: Bearer.
3. Vérifier
Demandez « quel est mon chiffre d'affaires de cette année ? ». Claude doit appeler ses outils et répondre avec votre montant réel. S'il répond une généralité, le jeton n'est pas passé.
Le protocole est JSON-RPC 2.0 sur HTTP, en POST. Un GET sur la même adresse renvoie le descripteur du serveur — protocole, outils, authentification, palier requis — ce qui permet à un agent de découvrir le connecteur sans authentification préalable.
Les 41 outils exposés
Profil, fiscalité et simulations
Régime fiscal, ACRE, réglages autorisés, chiffres d'activité, cotisations estimées et simulation de marge.
get_profile, update_profile_settings, get_stats, get_stats_by_platform, get_stats_by_period, get_tax_summary, simulate_profitability
Stock et achats
Les articles avec leur prix d'achat, leur prix estimé, leur prix de vente réel et leur statut (en stock, reçu, en transit, vendu) et les lots d'achat.
list_items, get_item, create_item, update_item, delete_item, list_packs, create_pack, update_pack, delete_pack
Ventes et déclarations
Ventes à un article ou groupées, suivi du statut déclaré, et contrôle des ventes non déclarées.
list_sales, create_sale, create_sale_group, mark_item_sold, mark_declared, list_undeclared
Dépenses, plateformes et catalogue
Frais d'exploitation, plateformes de vente et produits réutilisables dans le simulateur.
list_frais, create_frais, update_frais, delete_frais, list_platforms, create_platform, update_platform, delete_platform, list_catalogue, create_catalogue_item, update_catalogue_item, delete_catalogue_item
Factures et boutiques
Historique des factures et sélection/création de boutiques secondaires Business.
list_invoices, get_invoice, list_workspaces, create_boutique
Quatre questions qui marchent déjà
Faire le point avant une déclaration
« Quelles ventes de 2026 ne sont pas encore déclarées, et quel est le total à déclarer ? »
Claude appelle get_tax_summary et list_undeclared, puis sépare les cotisations estimées des ventes encore non déclarées.
Savoir si un lot valait le coup
« Sur mon lot de septembre, quel est le taux de marge réel après tous les frais ? »
Claude appelle list_packs, get_stats_by_period et list_frais, et distingue le chiffre d'affaires de la marge nette — la confusion qui fait croire qu'une activité est rentable.
Enregistrer une vente sans ouvrir l'application
« J'ai vendu la veste Carhartt 45 € sur Vinted aujourd'hui, enregistre la vente. »
Claude appelle mark_item_sold, puis create_sale. L'article bascule en vendu et entre dans le calcul de marge.
Vérifier sa position fiscale
« Où j'en suis du seuil DAC7 cette année, et combien il me reste avant la franchise TVA ? »
Claude appelle get_stats et get_profile et confronte le chiffre d'affaires encaissé aux seuils — sans que vous ayez à chercher lesquels s'appliquent à votre régime.
Ce que le connecteur ne fait pas
Il ne donne aucun accès aux comptes d'autres utilisateurs : le jeton ouvre le compte qui l'a créé, et rien d'autre. Il ne permet pas de modifier votre régime fiscal ni vos informations de facturation Stripe. Il n'écrit rien dans vos ventes sans que vous l'ayez demandé — un assistant connecté reste un assistant que vous pilotez.
La limite est de 200 appels par heure et par compte (tous jetons confondus), avec un plafond de 60 requêtes par minute et par adresse IP. Au-delà, l'endpoint répond 429 : c'est un garde-fou contre une boucle d'agent, pas une contrainte d'usage normal.
Questions fréquentes sur le connecteur MCP
Qu'est-ce que le connecteur MCP de Margeo ?
Margeo expose un serveur MCP (Model Context Protocol) à l'adresse https://margeoapp.com/mcp. Il donne à Claude Desktop, Claude Code ou Claude.ai un accès à 41 outils qui lisent et modifient le stock, les ventes, les packs, les dépenses et la fiscalité du compte de l'utilisateur.
Le connecteur MCP est-il inclus dans le plan gratuit ?
Non. Il est inclus dans Pro mensuel (7,99 €/mois), Pro annuel (69 €/an) et Business (19,99 €/mois), jamais dans Starter. L'endpoint MCP répond 403 en Starter. Ce plan reste gratuit à vie, sans carte bancaire.
Comment obtenir le jeton du connecteur MCP ?
Le jeton se crée dans l'application Margeo, section de connexion Claude. C'est une chaîne de 32 caractères hexadécimaux, valable un an, à transmettre en en-tête « Authorization: Bearer ». Margeo ne l'accepte jamais en paramètre d'URL : un jeton en query string fuit dans les journaux, les proxys et l'historique du navigateur.
Y a-t-il une limite d'appels sur le serveur MCP ?
Oui : 200 appels par heure et par compte, tous jetons confondus — en ajouter un second ne multiplie pas le quota. Un contrôle séparé autorise au plus 60 requêtes par minute depuis une même adresse IP. Au-delà, l'endpoint répond 429.
Comment un agent découvre-t-il le serveur MCP de Margeo ?
Le descripteur est publié à l'adresse https://margeoapp.com/.well-known/mcp.json : il liste les 41 outils, le transport (JSON-RPC 2.0 sur HTTP), l'authentification et le palier requis. Un GET sur https://margeoapp.com/mcp renvoie le même descripteur.