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 24 outils pour lire et mettre à jour votre stock, vos ventes, vos lots, vos dépenses et votre fiscalité, en langage naturel. Le connecteur est inclus dans les plans Pro (7,99 €/mois) et Business (19,99 €/mois) ; il se révoque à tout moment depuis l'application.
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 24 outils exposés
Profil et statistiques
Plan, régime fiscal, ACRE, TVA, et les chiffres d'activité : chiffre d'affaires, achats, dépenses, marge nette, taux de marge, répartition par plateforme et par période.
get_profile, get_stats, get_stats_by_platform, get_stats_by_period
Stock et lots
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), les lots d'achat, et le catalogue de référence.
list_items, get_item, create_item, update_item, delete_item, list_packs, create_pack, update_pack, delete_pack, list_catalogue
Ventes et fiscalité
L'enregistrement d'une vente, le marquage d'un article comme vendu, et surtout la liste des ventes NON déclarées — le point de contrôle avant une déclaration URSSAF.
list_sales, create_sale, mark_item_sold, mark_declared, list_undeclared
Dépenses et plateformes
Les frais d'exploitation (emballage, transport, abonnements) et les plateformes de vente configurées sur le compte.
list_frais, create_frais, update_frais, delete_frais, list_platforms
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_profile puis list_undeclared et répond avec le montant et la liste, au lieu de vous faire additionner un tableur.
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 jeton. 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 à 24 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. Le connecteur est inclus dans les plans Pro (7,99 €/mois ou 69 €/an) et Business (19,99 €/mois). En Starter, l'endpoint répond 403 avec un message qui indique comment activer un plan payant. Le plan Starter 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 jeton. Au-delà, l'endpoint répond 429. C'est une limite par jeton, pas par compte : deux jetons distincts disposent chacun de leur quota.
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 24 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.