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

Outils

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.