Serveur MCP (Assistants IA)

Connectez Claude, ChatGPT, Cursor et d'autres assistants IA a votre compte Lumabill via le Model Context Protocol.

Serveur MCP (Integration d'assistants IA)

Connectez votre compte Lumabill a des assistants IA comme Claude, ChatGPT et Cursor via le Model Context Protocol (MCP). Une fois connecte, votre assistant IA peut creer des factures, rechercher des clients, generer des rapports et bien plus — le tout en langage naturel.

Le serveur MCP necessite un plan Pro ou Lifetime et une cle API. Creez-en une sous Parametres > API dans le tableau de bord.

Prerequis

  1. Abonnement Pro ou Lifetime — le serveur MCP utilise l'API publique, une fonctionnalite Pro
  2. Une cle API — creez-en une dans Parametres > API (lecture seule suffit pour les requetes ; lecture et ecriture pour un acces complet)
  3. Un client IA compatible — Claude Desktop, Claude Code, Cursor ou tout outil compatible MCP

Configuration

Claude Desktop

Ajoutez ceci a votre claude_desktop_config.json :

{
  "mcpServers": {
    "lumabill": {
      "type": "streamable-http",
      "url": "https://mcp.lumabill.ch/mcp?key=lmb_votre_cle_ici"
    }
  }
}

Emplacement du fichier :

  • macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows : %APPDATA%\Claude\claude_desktop_config.json

Claude Code

Ajoutez dans .mcp.json a la racine de votre projet :

{
  "mcpServers": {
    "lumabill": {
      "type": "streamable-http",
      "url": "https://mcp.lumabill.ch/mcp?key=lmb_votre_cle_ici"
    }
  }
}

Cursor

  1. Ouvrez Parametres > MCP
  2. Cliquez sur Ajouter un serveur MCP
  3. Entrez :
    • Nom : lumabill
    • Type : streamable-http
    • URL : https://mcp.lumabill.ch/mcp?key=lmb_votre_cle_ici

Remplacez lmb_votre_cle_ici par votre cle API reelle dans tous les exemples ci-dessus.

Outils disponibles

Une fois connecte, votre assistant IA a acces a tous les endpoints de l'API Lumabill sous forme d'outils :

Facturation

  • Lister, creer, modifier et supprimer des factures
  • Creer et gerer des offres/devis
  • Gerer les factures recurrentes

Clients & Fournisseurs

  • Rechercher et consulter des clients
  • Creer et mettre a jour les fiches clients
  • Gerer les contacts fournisseurs

Depenses & Revenus

  • Enregistrer et categoriser les depenses
  • Suivre les revenus hors factures
  • Consulter les donnees de revenus

Comptabilite

  • Creer des ecritures comptables
  • Consulter le plan comptable
  • Gerer les exercices fiscaux

Banque

  • Importer des transactions bancaires (CAMT)
  • Rapprocher les transactions

Rapports

  • Generer des comptes de resultat
  • Generer des bilans
  • Creer des rapports TVA

Parametres

  • Consulter les profils et informations d'entreprise
  • Parcourir le catalogue de produits

Exemples de prompts

Une fois votre assistant IA connecte, essayez des prompts comme :

  • "Cree une facture pour Muster AG pour 3 heures de conseil a CHF 180/heure"
  • "Montre-moi toutes les factures impayees"
  • "Quel etait mon chiffre d'affaires le mois dernier ?"
  • "Genere un rapport P&L pour le T1 2026"
  • "Recherche le client Meier GmbH"
  • "Cree une depense de CHF 49.90 pour des fournitures de bureau"
  • "Liste toutes les factures recurrentes"

Permissions & Limites de debit

  • Les cles en lecture seule n'exposent que les outils de lecture (lister, obtenir, rapports). Les operations d'ecriture sont masquees.
  • Les cles lecture et ecriture exposent tous les outils.
  • Les limites de debit sont identiques a l'API REST : 60 lectures/minute et 20 ecritures/minute par cle.
  • Le serveur MCP respecte la portee de profil de votre cle — si la cle est limitee a un profil, l'assistant ne voit que les donnees de ce profil.

Depannage

"Connection refused" ou timeout

  • Verifiez que votre cle API est correcte et commence par lmb_
  • Verifiez que l'URL est exactement https://mcp.lumabill.ch/mcp?key=lmb_votre_cle_ici (pas de slash final)
  • Assurez-vous que votre abonnement est actif (Pro ou Lifetime)

"Unauthorized" ou "Cle API invalide"

  • La cle a peut-etre ete revoquee — verifiez dans Parametres > API du tableau de bord
  • Assurez-vous d'avoir copie la cle complete incluant le prefixe lmb_

Les outils n'apparaissent pas

  • Redemarrez votre client IA apres avoir modifie la configuration
  • Pour Claude Desktop, quittez completement et rouvrez l'application
  • Pour Cursor, rechargez la fenetre apres avoir ajoute le serveur MCP

Erreurs "Cle en lecture seule" sur les operations d'ecriture

  • Votre cle API est en mode lecture seule. Creez une nouvelle cle lecture et ecriture si vous devez creer ou modifier des donnees.

Erreurs de limite de debit (429)

  • Vous envoyez trop de requetes. Attendez un moment et reessayez.
  • Envisagez de regrouper les operations ou de les espacer dans le temps.
Cles API & API publique