Skip to main content
Glama

voxfactura-mcp

Branche ton business VoxFactura sur ton assistant IA (Claude Desktop, Claude Code, ou tout client MCP). Tu poses tes questions en langage naturel :

  • « Quelles sont mes factures impayées ? »

  • « Quelle est ma marge avec le client Martin ? »

  • « Combien j'ai dépensé chez Point P ce mois-ci ? »

  • « Donne-moi mon récapitulatif TVA du 1er trimestre. »

  • « Crée un devis brouillon pour le client 12 : 3 radiateurs à 450. »

L'assistant consulte tes données et peut préparer des brouillons ; il ne n'envoie jamais rien à un client (l'envoi reste une validation humaine dans VoxFactura). Tout passe par une clé API scopée que tu contrôles.

1. Crée une clé API

Dans VoxFactura : Réglages → Clés API → Créer une clé. Coche les permissions voulues (lecture : factures, dépenses, clients, comptabilité, encaissements ; écriture : créer des devis, marquer payé, ajouter des dépenses). Copie la clé vf_live_… : elle n'est affichée qu'une seule fois.

  • Pour la marge d'un client : factures + dépenses.

  • La case « Chantiers et regroupements (ancien) » ne sert plus qu'aux outils chantiers, gardés pour compatibilité.

  • Pour le récap TVA / FEC : comptabilité.

Related MCP server: @centry-digital/bukku-mcp

2. Installe

pip install voxfactura-mcp
# ou, sans installer : uvx voxfactura-mcp

3. Configure ton client MCP

Claude Desktop

Réglages → Développeur → Modifier la config :

{
  "mcpServers": {
    "voxfactura": {
      "command": "voxfactura-mcp",
      "env": { "VOXFACTURA_API_KEY": "vf_live_ta_cle_ici" }
    }
  }
}

Redémarre Claude Desktop.

Claude Code

claude mcp add voxfactura -e VOXFACTURA_API_KEY=vf_live_ta_cle -- voxfactura-mcp

Variables d'environnement

Variable

Rôle

Défaut

VOXFACTURA_API_KEY

Ta clé API (obligatoire)

aucune

VOXFACTURA_API_BASE_URL

URL de l'API

https://api.voxfactura.com

VOXFACTURA_DOSSIER

Clé cabinet : numéro du dossier client lu par défaut

aucun

Cabinet comptable : une clé pour tous vos dossiers

Un cabinet d'expertise comptable crée une clé cabinet (vf_cab_…) depuis son espace cabinet VoxFactura, page API. Elle lit, en lecture seule, les dossiers des clients qui vous ont donné accès, un dossier à la fois :

  • l'outil dossiers liste vos dossiers (numéro, raison sociale, SIREN) ;

  • chaque outil accepte un paramètre dossier (numéro du dossier) ; à défaut, le serveur prend VOXFACTURA_DOSSIER ;

  • les outils d'écriture répondent par un refus : une clé cabinet ne modifie rien ;

  • chaque lecture figure dans le journal que voit votre client, qui peut retirer l'accès à tout moment.

{
  "mcpServers": {
    "voxfactura-cabinet": {
      "command": "voxfactura-mcp",
      "env": { "VOXFACTURA_API_KEY": "vf_cab_votre_cle", "VOXFACTURA_DOSSIER": "1" }
    }
  }
}

Outils

Outil

Rôle

Permission

dossiers

Dossiers clients d'une clé cabinet

clé cabinet

factures_impayees

Factures impayées

factures

factures

Factures (filtres statut / chantier / période)

factures

facture

Détail d'une facture

factures

pdf_facture

PDF Factur-X d'une facture émise (base64)

factures

depenses

Dépenses avec leur client, devis et facture (filtres client / chantier / catégorie / période)

dépenses

justificatifs_depense

Justificatifs d'une dépense

dépenses

justificatif

Fichier d'un justificatif (base64)

dépenses

clients

Liste / recherche clients

clients

marge_client

Facturé HT, dépenses et marge d'un client, par travail

factures + dépenses

chantiers

Liste des chantiers (ancien regroupement)

chantiers

chantier

Détail d'un chantier (ancien regroupement)

chantiers

marge_chantier

Ancien : CA facturé − dépenses d'un chantier, préférer marge_client

factures + dépenses

recap_tva

TVA collectée / déductible / nette

comptabilité

journal_ventes

Journal des ventes d'une période

comptabilité

journal_achats

Journal des achats d'une période

comptabilité

journal_ventes_csv

Journal des ventes en CSV

comptabilité

journal_achats_csv

Journal des achats en CSV

comptabilité

export_fec

Fichier des écritures comptables de l'année

comptabilité

encaissements

Factures encaissées d'une période (date, montant, moyen)

payments:read

creer_devis_brouillon

Crée un devis (brouillon)

devis:write

modeles_devis

Modèles de devis du compte et leurs variables

devis:write

devis_depuis_modele

Crée un devis (brouillon) depuis un modèle

devis:write

marquer_facture_payee

Marque une facture payée

payments:write

ajouter_depense

Ajoute une dépense

expenses:write

Tous les outils (sauf dossiers) acceptent aussi dossier, utile seulement avec une clé cabinet.

API sous-jacente

Le serveur n'est qu'un habillage de l'API publique VoxFactura (lecture/écriture scopée). Doc interactive : https://api.voxfactura.com/api/v1/pub/docs. Voir aussi llms.txt et examples/.

Éditeur

VoxFactura est édité par ASTERIO 37, SAS immatriculée au RCS de Paris (SIREN 107 559 619), 231 rue Saint-Honoré, 75001 Paris. Données hébergées dans l'Union européenne. Site : https://www.voxfactura.com. Contact : contact@voxfactura.com. Mentions légales : https://www.voxfactura.com/legal/mentions-legales.

La facture électronique passe par une plateforme agréée par l'administration fiscale : VoxFactura n'est pas elle-même plateforme agréée.

Licence

MIT.

Available Tools

25 tools
ajouter_depenseC

Ajoute une dépense (permission expenses:write). Montants en texte (ex. « 240.00 »). Rattache à un chantier via chantier_id (numéro du chantier dans le compte).

Inputs: designation (required), montant_ttc (required), dossier, categorie, +4 more.

chantierC

Détail d'un chantier (ancien regroupement) par son numéro dans le compte (le champ id renvoyé par la liste des chantiers).

Inputs: chantier_id (required), dossier.

chantiersA

Liste les chantiers (ancien regroupement, gardé pour compatibilité), éventuellement filtrés par statut (en_cours, termine…) ou par client (client_id = numéro du client dans le compte). Pour la marge, préférer marge_client.

Inputs: statut, dossier, client_id.

clientsC

Liste les clients, avec une recherche textuelle optionnelle.

Inputs: dossier, recherche.

creer_devis_brouillonA

Crée un devis en BROUILLON (permission devis:write). client_id et chantier_id sont les numéros du client et du chantier dans le compte. Chaque ligne : {designation, quantite, unite, prix_unitaire_ht, taux_tva}, plus en option prestation_id (numéro de la prestation du catalogue ; prix omis, la ligne prend le prix de ce client, sinon celui du catalogue) et nature (« bien » pour une vente, « service » sinon ; omise, elle suit la prestation du catalogue puis le réglage du compte). validite_jours : durée de validité (omis = celle réglée sur le compte, 30 jours par défaut). delai_execution : délai imprimé sur le devis (ex. « 3 semaines après acceptation »). Le devis n'est jamais envoyé automatiquement : l'artisan le relit et l'envoie dans VoxFactura. Son numero est nul tant qu'il est brouillon : le numéro définitif lui est attribué à l'envoi.

Inputs: lignes (required), client_id (required), notes, objet, +4 more.

depensesB

Liste les dépenses (factures de frais). Chacune dit à quel client, devis ou facture elle est rattachée (client_id, devis_id, facture_id, numéros du compte). Filtrables par client (client_id = numéro du client dans le compte), par chantier (numéro du chantier, ancien regroupement), catégorie ou période (debut / fin en AAAA-MM-JJ, inclus).

Inputs: fin, debut, dossier, categorie, +2 more.

devis_depuis_modeleA

Crée un devis en BROUILLON depuis un modèle de devis (permission devis:write). modele : nom ou numéro du modèle (voir modeles_devis). variables : valeur de chaque variable sous son nom, dates en AAAA-MM-JJ. client_id : numéro du client dans le compte, sinon celui du modèle. Jamais envoyé automatiquement : l'artisan le relit et l'envoie dans VoxFactura.

Inputs: modele (required), dossier, client_id, variables.

dossiersA

Clé cabinet seulement : les dossiers clients accessibles (numéro, raison sociale, SIREN). Passez ensuite ce numéro dans le paramètre dossier des autres outils (ou dans VOXFACTURA_DOSSIER).

Inputs: no named parameters.

encaissementsB

Factures encaissées sur une période (dates AAAA-MM-JJ) : facture, date, montant, moyen (carte, virement, déclaré). Permission encaissements.

Inputs: fin, debut, limit, dossier.

export_fecC

Fichier des écritures comptables (FEC, texte tabulé) de l'année, à remettre à l'expert-comptable. Nécessite la permission comptabilité.

Inputs: annee (required), dossier.

factureB

Détail d'une facture (lignes comprises) par son numéro dans le compte (le champ id renvoyé par la liste des factures).

Inputs: facture_id (required), dossier.

facturesB

Liste les factures émises, éventuellement filtrées par statut, chantier (chantier_id = numéro du chantier dans le compte) ou période d'émission (debut / fin en AAAA-MM-JJ, inclus).

Inputs: fin, debut, limit, statut, +2 more.

factures_impayeesB

Liste les factures impayées (envoyées, partiellement payées, en retard).

Inputs: dossier.

journal_achatsA

Journal des achats sur une période (dates AAAA-MM-JJ) : une écriture par dépense. Nécessite la permission comptabilité.

Inputs: fin (required), debut (required), dossier.

journal_achats_csvC

Journal des achats en CSV (séparateur « ; », montants à virgule). Permission comptabilité.

Inputs: fin (required), debut (required), dossier.

journal_ventesB

Journal des ventes sur une période (dates AAAA-MM-JJ) : une écriture par facture et avoir. Nécessite la permission comptabilité.

Inputs: fin (required), debut (required), dossier.

journal_ventes_csvB

Journal des ventes en CSV (séparateur « ; », montants à virgule), tel que l'importe un logiciel de compta français. Permission comptabilité.

Inputs: fin (required), debut (required), dossier.

justificatifB

Télécharge un justificatif d'une dépense (depense_id = numéro de la dépense dans le compte, justificatif_id = le champ id de justificatifs_depense), en base64 avec son type.

Inputs: depense_id (required), justificatif_id (required), dossier.

justificatifs_depenseB

Liste les justificatifs (photo de ticket, PDF) d'une dépense, par son numéro dans le compte : id, nom, type, taille.

Inputs: depense_id (required), dossier.

marge_chantierA

Ancien regroupement, gardé pour compatibilité : préférer marge_client. Marge d'un chantier (par son numéro dans le compte) : chiffre d'affaires facturé moins les dépenses rangées sur ce chantier. Nécessite une clé avec les permissions factures + dépenses.

Inputs: chantier_id (required), dossier.

marge_clientA

Marge d'un client (client_id = numéro du client dans le compte, le champ id de l'outil clients) : facturé HT, dépenses et marge, en tout et par travail (un devis et ses factures, une facture seule, ou un regroupement), plus une ligne sans_document pour les dépenses du client sans devis ni facture. Mêmes chiffres que la fiche client de VoxFactura ; depenses_en_ttc vrai pour un compte en franchise de TVA. Nécessite une clé avec les permissions factures + dépenses.

Inputs: client_id (required), dossier.

marquer_facture_payeeB

Marque une facture payée (permission payments:write). facture_id = numéro de la facture dans le compte. montant (texte, ex. « 500.00 ») pour un paiement partiel ; vide = solde le total.

Inputs: facture_id (required), dossier, montant.

modeles_devisB

Modèles de devis de l'artisan (permission devis:write) : numéro, nom, objet et variables à remplir pour devis_depuis_modele.

Inputs: dossier.

pdf_factureB

PDF Factur-X d'une facture émise (par son numéro dans le compte), en base64 avec son nom de fichier. Un brouillon n'a pas de PDF.

Inputs: facture_id (required), dossier.

recap_tvaB

Récapitulatif TVA sur une période (dates AAAA-MM-JJ) : collectée, déductible, TVA nette. Nécessite la permission comptabilité.

Inputs: fin (required), debut (required), dossier.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 25 tools

    Disambiguation3/5

    Several tools overlap: factures_impayees is a subset of factures with a status filter, journal_ventes_csv/journal_achats_csv duplicate the non-CSV journals with a different format, and legacy chantier/marge_chantier plus justificatif/justificatifs_depense can cause misselection. Descriptions often clarify intended use, but there is more than one or two ambiguous boundary.

    Naming Consistency4/5

    All names are snake_case and mostly French/domain-specific, with a generally predictable pattern of plural nouns for lists and verb_noun for writes. There are minor deviations such as devis_depuis_modele and export_fec, but the convention remains readable.

    Tool Count3/5

    25 tools is heavy for the apparent scope and includes redundant format variants and legacy compatibility tools that could be consolidated. The domain is broad—quotes, invoices, expenses, accounting, and cabinet access—so it is not an extreme mismatch, but it sits at the borderline.

    Completeness3/5

    Coverage is strong for listing clients, chantiers, invoices, expenses, accounting journals, TVA, FEC, and draft quote/expense creation. However, there is no devis list/detail after draft creation and no client or chantier creation/update, leaving some workflows with dead ends.

    Maintenance

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      MCP server for Invoice Ninja v5 API. Enables AI assistants to manage clients, invoices, quotes, payments, and time tracking through natural language.
      32
      22 npm
      2
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      MCP server for Spanish accounting for freelancers and SMEs, enabling AI agents to issue invoices, OCR expense PDFs, reconcile bank transactions, and prepare quarterly VAT (Modelo 303).
      23
      4
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Multi-tenant MCP server connecting accounting software to AI assistants via ~87 tools. Supports Bokio (Swedish accounting) with mock mode for development.
      -