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 sur le chantier Villa Michu ? »
• « 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, chantiers, clients, comptabilité ; é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 chantier : factures + dépenses.
• Pour le récap TVA / FEC : comptabilité.

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

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

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://voxfacture-production.up.railway.app/api/v1/pub/docs. Voir aussi llms.txt et examples/.

Licence

MIT.