voxfactura-mcp 0.1.0

Serveur MCP VoxFactura : branche ton business (factures, dépenses, chantiers, marge, TVA) sur ton assistant IA.

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

Variable	Rôle	Défaut
VOXFACTURA_API_KEY	Ta clé API (obligatoire)	—
VOXFACTURA_API_BASE_URL	URL de l'API	https://voxfacture-production.up.railway.app

Outils

Outil	Rôle	Permission
factures_impayees	Factures impayées	factures
factures	Factures (filtres statut / chantier)	factures
facture	Détail d'une facture	factures
depenses	Dépenses (filtres chantier / catégorie)	dépenses
chantiers	Liste des chantiers	chantiers
clients	Liste / recherche clients	clients
marge_chantier	CA facturé − dépenses d'un chantier	factures + dépenses
recap_tva	TVA collectée / déductible / nette	comptabilité
creer_devis_brouillon	Crée un devis (brouillon)	devis:write
marquer_facture_payee	Marque une facture payée	payments:write
ajouter_depense	Ajoute une dépense	expenses:write

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.