f facturifirma

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.

Commencer gratuitement Outils disponibles

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/mcp

Authentification

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. 1. Dans claude.ai : ouvre Paramètres → Connectors et clique sur « Add custom connector ».
  2. 2. Donne-lui un nom (ex. « facturifirma »), colle l'adresse https://app.facturifirma.ro/mcp et clique sur « Add ».
  3. 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. 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/mcp

Variante 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. 1. Crée une clé API dans l'appli : Paramètres → Clés API.
  2. 2. Envoie la clé en en-tête Authorization: Bearer <CLÉ_API> à chaque requête.
  3. 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_purchases

e-Factura ANAF

Envoie des documents au SPV, suis leur statut et importe les factures reçues.

send_to_anafpoll_efacturasync_inboxlist_inboximport_inbox

Entreprises

Liste et gère les entreprises de ton compte.

list_companiescreate_companyget_companyupdate_company

Clients

Crée et gère les clients (contreparties) d'une entreprise.

list_clientscreate_clientget_clientupdate_clientdelete_client

Fournisseurs

Crée et gère les fournisseurs (les contreparties auprès desquelles tu achètes) d'une entreprise.

list_suppliersget_suppliercreate_supplierupdate_supplierdelete_supplier

Dépenses

Enregistre et gère les dépenses fournisseurs.

list_expensescreate_expenseupdate_expensedelete_expense

Factures récurrentes

Crée des modèles qui génèrent automatiquement des brouillons de facture selon une cadence.

list_recurringcreate_recurringupdate_recurringdelete_recurring

Comptes bancaires

Liste et remplace les comptes bancaires d'une entreprise, d'un client ou d'un fournisseur.

list_bank_accountsreplace_bank_accounts

Données publiques ANAF

Recherche une entreprise roumaine par CUI (nom, adresse, statut TVA/e-Factura).

lookup_company

Catalogue 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_series

Rapports

Journal des ventes, rapport TVA et rapprochement bancaire.

sales_journalvat_reportreconcile_bank

Paramètres

Lis et mets à jour la configuration du tenant.

get_settings_schemaget_settingsupdate_settings

Sé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

← Retour à l'accueil