MCP · Model Context Protocol
Connecte un assistant IA à ton entreprise
facturifirma expose un serveur MCP en HTTP flux continu. Tout client compatible (Claude, Claude Code, autres agents) peut émettre des factures, les envoyer au SPV, gérer les clients et générer des rapports directement depuis la conversation.
Qu'est-ce que le connecteur MCP
MCP (Model Context Protocol) est un standard ouvert permettant à un assistant IA d'appeler des outils (tools) exposés par une application. Le connecteur facturifirma donne un accès complet en lecture/écriture à tes entreprises, documents, clients et rapports, avec les mêmes règles métier que l'appli et l'API.
Endpoint
Serveur MCP HTTP en flux continu, disponible à l'adresse ci-dessous.
https://app.facturifirma.ro/mcpAuthentification
Variante 1 — OAuth (recommandé pour claude.ai / ChatGPT)
Pour les clients qui ne peuvent pas envoyer d'en-tête Authorization personnalisé (connecteurs web claude.ai, ChatGPT), l'autorisation se fait dans le navigateur, via OAuth 2.1.
- 1. Dans claude.ai : ouvre Paramètres → Connectors et clique sur « Add custom connector ».
- 2. Donne-lui un nom (ex. « facturifirma »), colle l'adresse https://app.facturifirma.ro/mcp et clique sur « Add ».
- 3. Clique sur « Connect » sur le nouveau connecteur — tu es redirigé vers facturifirma pour te connecter (si ce n'est pas déjà fait).
- 4. Clique sur « Autoriser » sur l'écran de consentement. Tu reviens sur claude.ai avec le connecteur « Connected » — aucun client ID ni secret à configurer.
https://app.facturifirma.ro/mcpVariante 2 — Clé API (Bearer)
Pour les clients pouvant envoyer des en-têtes personnalisés (Claude Code, Claude Desktop, autres agents), utilise une clé API en en-tête Bearer.
- 1. Crée une clé API dans l'appli : Paramètres → Clés API.
- 2. Envoie la clé en en-tête Authorization: Bearer <CLÉ_API> à chaque requête.
- 3. Configure ton client MCP (Claude Code, Claude Desktop, etc.) avec l'endpoint et l'en-tête ci-dessous.
Claude Code (CLI)
claude mcp add --transport http facturifirma https://app.facturifirma.ro/mcp --header "Authorization: Bearer <API_KEY>"Configuration générique (JSON)
{
"mcpServers": {
"facturifirma": {
"url": "https://app.facturifirma.ro/mcp",
"headers": {
"Authorization": "Bearer <API_KEY>"
}
}
}
}Outils disponibles
La liste réelle des outils exposés par le serveur, groupés par domaine :
Facturation et documents
Crée, modifie, émets et encaisse factures, proformas et avoirs.
list_documentscreate_invoiceupdate_invoiceissue_documentdelete_documentrecord_paymentreverse_invoiceconvert_proformalist_purchasese-Factura ANAF
Envoie des documents au SPV, suis leur statut et importe les factures reçues.
send_to_anafpoll_efacturasync_inboxlist_inboximport_inboxe-Transport ANAF
Déclare des transports (UIT), suis leur statut et annule des déclarations, avec des véhicules réutilisables.
declare_transportlist_transport_declarationsget_transport_declarationsync_etransportcancel_transport_declarationlist_vehiclescreate_vehicleEntreprises
Liste et gère les entreprises de ton compte.
list_companiescreate_companyget_companyupdate_companyClients
Crée et gère les clients (contreparties) d'une entreprise.
list_clientscreate_clientget_clientupdate_clientdelete_clientFournisseurs
Crée et gère les fournisseurs (les contreparties auprès desquelles tu achètes) d'une entreprise.
list_suppliersget_suppliercreate_supplierupdate_supplierdelete_supplierDépenses
Enregistre et gère les dépenses fournisseurs.
list_expensescreate_expenseupdate_expensedelete_expenseFactures récurrentes
Crée des modèles qui génèrent automatiquement des brouillons de facture selon une cadence.
list_recurringcreate_recurringupdate_recurringdelete_recurringComptes bancaires
Liste et remplace les comptes bancaires d'une entreprise, d'un client ou d'un fournisseur.
list_bank_accountsreplace_bank_accountsDonnées publiques ANAF
Recherche une entreprise roumaine par CUI (nom, adresse, statut TVA/e-Factura).
lookup_companyCatalogue et opérations
Produits, entrepôts et séries de numérotation.
list_productscreate_productget_productupdate_productdelete_productlist_warehousescreate_warehouseupdate_warehousedelete_warehouselist_seriescreate_seriesupdate_seriesdelete_seriesRapports
Journal des ventes, rapport TVA et rapprochement bancaire.
sales_journalvat_reportreconcile_bankParamètres
Lis et mets à jour la configuration du tenant.
get_settings_schemaget_settingsupdate_settingsSécurité
Une clé API est liée à ton compte (tenant) et peut être révoquée à tout moment depuis Paramètres → Clés API. Chaque appel MCP s'exécute avec les mêmes droits que l'utilisateur ayant généré la clé, rien de plus.
Prêt à connecter un assistant IA ?
Crée une clé API dans l'appli et ajoute-la à ton client MCP préféré.
Ouvrir l'appli