Kema Invoice expose votre facturation comme un jeu d'outils MCP (Model Context Protocol) : une fois le connecteur branché, votre agent IA crée, émet et suit vos factures, devis et provisions en langage naturel, avec la même conformité que dans l'interface. L'interface reste utilisable comme un logiciel de facturation classique : le connecteur s'y ajoute, il ne la remplace pas.
L'adresse du connecteur
https://mcp.kema-studio.com/api/mcp
Cette adresse est affichée en permanence dans la barre latérale de l'application (carte Serveur MCP), avec un bouton pour la copier et un indicateur de disponibilité en temps réel (connecté / déconnecté).
Depuis Claude (recommandé)
- Copiez l'adresse du connecteur ci-dessus.
- Dans Claude : Réglages → Connecteurs → Ajouter, collez l'adresse.
- Autorisez l'accès, une seule fois. Vous êtes redirigé vers votre compte Kema pour donner votre accord (OAuth 2.1).
C'est tout : demandez ensuite à Claude, en français, ce que vous voulez facturer.
En ligne de commande
Pour Claude Code et les clients compatibles :
claude mcp add kema-invoice --transport http \ --url https://mcp.kema-studio.com/api/mcp
Le connecteur fonctionne avec tout client MCP supportant le transport Streamable HTTP et l'authentification OAuth 2.1.
Depuis un annuaire MCP
Le connecteur est également référencé dans les annuaires publics de serveurs MCP. Si votre client IA propose un catalogue intégré, vous pouvez l'y retrouver et l'installer en un clic, sans saisir l'adresse :
- Registre MCP officiel - entrée
com.kema-studio/invoice, adresse du serveurhttps://mcp.kema-studio.com/api/mcp.
- Smithery - smithery.ai/servers/kema-studio/invoice
Quel que soit le point d'entrée, l'installation aboutit au même connecteur et à la même autorisation OAuth 2.1 décrite ci-dessus.
Essai et abonnement
Le connecteur est inclus dans l'essai gratuit comme dans l'abonnement, sans supplément. Ses outils fonctionnent tant que votre compte dispose d'un essai en cours ou d'un abonnement actif.
- Pendant l'essai - les factures créées par l'agent comptent dans la limite des 10 factures de l'essai, comme celles créées dans l'interface. Au-delà,
create_invoiceest refusé avec le message « L'essai gratuit permet 10 factures et ce compte les a toutes utilisées. Passez au plan payant pour en créer d'autres. » Votre agent vous le transmet en clair.
- Sans essai en cours ni abonnement actif - le connecteur reste connecté et continue d'afficher ses 41 outils : ce n'est volontairement pas une erreur de connexion. En revanche, tout appel d'outil est refusé, avec un message explicite qui renvoie vers votre page de facturation. Votre agent (Claude, Cursor, n8n…) reçoit ce message et vous l'explique en clair.
- Ce n'est pas un problème d'authentification - se reconnecter ou se ré-authentifier renverra exactement le même message.
- La vérification a lieu à chaque appel - dès que votre abonnement est actif, l'accès revient sans avoir à rebrancher le connecteur.
- Si l'abonnement s'interrompt, l'accès est coupé dès l'appel suivant.
- En cas de paiement en échec, le message est distinct de celui d'un compte sans abonnement : il vous invite à mettre à jour votre moyen de paiement, et non à souscrire.
Ce que votre agent sait faire
41 outils, en sept domaines : Factures (16), Rectification et import (3), Devis (5), Provisions (6), Clients (5), Profils client (3), Pilotage (3). Chaque appel réussi est journalisé et visible dans le fil Activité de l'agent (barre latérale et page Activité).
Factures (16)
Outil | Ce qu'il fait |
create_invoice | Crée un brouillon de facture (lignes, TVA calculée automatiquement) |
issue_invoice | Émet la facture légalement et déclenche sa certification |
update_invoice | Modifie un brouillon (dates, conditions, notes) |
add_invoice_item / update_invoice_item / delete_invoice_item / reorder_invoice_items | Gère et réordonne les lignes d'un brouillon |
delete_invoice | Supprime un brouillon |
mark_invoice_paid | Enregistre le paiement d'une facture émise |
cancel_invoice | Annule une facture émise (avoir généré automatiquement) |
create_credit_note | Crée un avoir |
check_certification_status | Vérifie l'état de certification d'une facture |
get_invoice / list_invoices | Consulte une facture ou la liste (filtres, recherche) |
get_invoice_pdf | Renvoie un lien de téléchargement du PDF, valable une heure, pour toute facture visible par l'agent (voir ci-dessous) |
update_invoice_matter | Rattache une facture à un dossier |
PDF via l'agent -
get_invoice_pdf fonctionne pour toute facture, quel que soit son état : une facture importée renvoie le fichier que vous avez déposé ; une facture émise dans l'application ou par l'agent est rendue aux couleurs de votre espace de travail et embarque le Factur-X une fois certifiée ; un brouillon est rendu lui aussi, mais signalé comme brouillon (is_draft) : c'est un aperçu, pas un document légal. Le lien expire au bout d'une heure ; redemandez-le simplement.Rectification et import (3)
Outil | Ce qu'il fait |
rectify_invoice | Crée une facture rectificative qui remplace l'originale |
get_rectification_links | Consulte la chaîne original ↔ rectificative |
import_external_invoice | Importe une facture émise hors de Kema Invoice (historique) |
Devis (5)
Cycle complet : brouillon → envoyé → accepté ou refusé → conversion en facture. Aucune certification au stade devis. Le passage à « envoyé » est un changement d'état : Kema Invoice n'expédie pas le devis lui-même.
Outil | Ce qu'il fait |
create_quote | Crée un devis (dates d'émission, d'échéance et de validité par défaut) |
send_quote | Passe le devis de brouillon à envoyé |
accept_quote / reject_quote | Enregistre la décision du client |
convert_quote_to_invoice | Convertit un devis accepté en brouillon de facture |
Provisions (6)
Une provision (note de provision, acompte) se crée pour un client, sans dossier : c'est le cas normal dans Kema Invoice. Une fois émise puis encaissée, elle devient un crédit client que votre agent déduit de la facture finale.
Outil | Ce qu'il fait |
create_provision | Crée une demande de provision pour un client, sans dossier par défaut (rattachement à un dossier facultatif) |
send_provision | Émet la provision et déclenche sa certification |
mark_provision_paid | Enregistre l'encaissement d'une provision, qui devient un crédit déductible |
list_available_provisions | Liste les provisions encaissées non encore imputées ; sans dossier indiqué, celles créées pour un client seul |
apply_provisions_to_invoice / remove_provision_from_invoice | Déduit une ou plusieurs provisions encaissées d'une facture en brouillon (montant dû mis à jour), ou les retire tant que la facture reste en brouillon |
Clients (5)
Outil | Ce qu'il fait |
create_company / update_company / delete_company | Gère vos fiches clients |
list_companies / get_company | Liste vos clients ou consulte une fiche complète |
Profils client (3)
Outil | Ce qu'il fait |
get_invoice_client_profile / upsert_invoice_client_profile / delete_invoice_client_profile | Gère les préférences de facturation par client (conditions, délais par défaut) |
Pilotage (3)
Outil | Ce qu'il fait |
get_revenue_summary | Encaissé, encours, retards et volumes sur une période |
get_settings | Consulte vos paramètres fiscaux (lecture seule) |
list_mcp_activity | Relit le journal des actions de l'agent |
Exemples de demandes
- « Crée une facture de 300 € pour Dupont SARL : 3 h de consulting à 100 € »
- « Fais un devis de 500 € pour Dupont SARL et marque-le comme envoyé »
- « Convertis le devis accepté de Dupont SARL en facture »
- « Quelles factures sont impayées ce mois-ci ? »
- « Quel est mon chiffre d'affaires encaissé ce mois-ci ? »
Des exemples adaptés à vos propres clients défilent dans la barre latérale de l'application.
Sécurité et garde-fous
- Vos données seulement - l'agent agit en votre nom, avec vos droits : il ne voit que les données de votre compte.
- Actions engageantes confirmées - émission, certification de provision, refus de devis, conversion, rectification, annulation et suppressions demandent une confirmation explicite de l'agent.
- Conformité identique - les documents créés par l'agent passent par les mêmes vérifications (TVA, mentions, certification) que ceux créés à la main.
- Défauts serveur - dates, conditions de paiement et TVA sont calculées côté serveur : l'agent n'a jamais à les inventer.
- Révocation à tout moment - supprimez le connecteur dans Réglages → Connecteurs de Claude ; l'accès est coupé immédiatement.
- Tout est tracé - voir la page Activité MCP du guide.