Model Context Protocol

Documentation du serveur MCP

Connectez Claude Desktop, Cursor et d’autres clients MCP gérant les serveurs distants à QuickBilling. Ajoutez une URL et connectez-vous avec votre compte QuickBilling.

Qu’est-ce que le serveur MCP de QuickBilling ?

Un serveur MCP distant hébergé qui expose QuickBilling sous forme d’outils typés pour les assistants IA.

Le Model Context Protocol (MCP) permet aux assistants IA d’appeler des outils structurés plutôt que de lire une interface.

QuickBilling exploite un serveur MCP distant hébergé à l’adresse https://mcp.quickbilling.io/mcp (HTTP en flux continu). Vous l’ajoutez à un client MCP gérant les serveurs distants et vous vous connectez avec votre compte QuickBilling.

Concrètement

Votre assistant peut créer des factures, enregistrer des dépenses, gérer des clients et produire des rapports depuis le chat
129 outils pour la facturation et les dépenses
La connexion utilise OAuth 2.1 avec PKCE et votre compte QuickBilling, pas une clé d’API
Chaque appel s’exécute avec les droits de votre compte

Idéal pour : les indépendants et équipes qui travaillent déjà dans Claude Desktop, Cursor ou un autre client MCP et veulent facturer sans passer par un tableau de bord.

L’API pour les produits, MCP pour les assistants

Les mêmes données, deux accès.

Utilisez l’API REST pour intégrer la facturation à votre produit ou à votre automatisation. Les clés d’API sont incluses dans l’offre Unlimited.

Utilisez le serveur MCP lorsqu’une personne pilote un assistant IA et veut accéder aux mêmes données en langage courant.

QuickBilling MCP est conçu pour

Claude Desktop, ajouté comme connecteur distant personnalisé
Cursor et d’autres clients gérant les serveurs MCP distants
Tout client MCP qui gère les serveurs distants avec connexion OAuth

Chaque outil correspond à un vrai appel authentifié, avec les droits du compte connecté.

Démarrage rapide

Ajoutez une URL et connectez-vous.

Prérequis : un compte QuickBilling et un client MCP qui gère les serveurs distants avec connexion OAuth.

Étapes

Ouvrez les réglages de votre client MCP et ajoutez un serveur MCP distant
Utilisez l’URL https://mcp.quickbilling.io/mcp
Connectez-vous avec votre compte QuickBilling lorsque le client vous demande d’autoriser la connexion
Demandez à votre assistant : « Liste mes espaces QuickBilling » ou « Quelles factures sont en retard ? »

Vous n’avez pas besoin de clé d’API. Si votre compte comprend plusieurs espaces de travail, demandez à l’assistant de les lister et d’en choisir un.

Configuration pour les clients qui lisent un fichier JSON (par exemple Cursor)

mcp.json

{
  "mcpServers": {
    "quickbilling": {
      "url": "https://mcp.quickbilling.io/mcp"
    }
  }
}

Dans Claude Desktop, ajoutez la même URL comme connecteur personnalisé (un serveur MCP distant). Les noms de menus varient selon le client, consultez donc la documentation de votre client pour ajouter un serveur distant.

Détails de connexion

Ce dont votre client MCP a besoin.

URL du serveur : https://mcp.quickbilling.io/mcp
Transport : HTTP en flux continu, un serveur distant sans rien à installer
Authentification : OAuth 2.1 avec PKCE, connexion avec votre compte QuickBilling
Découverte : les métadonnées de la ressource protégée OAuth sont servies sur /.well-known/oauth-protected-resource, sur le même hôte

Le serveur distant n’accepte pas les clés d’API. Les clés d’API servent à l’API REST et sont incluses dans l’offre Unlimited : voir https://quickbilling.io/docs/api

Espaces de travail

Comment un assistant choisit l’espace de travail dans lequel il agit.

Si votre compte a un seul espace de travail, l’assistant l’utilise sans configuration.

Si vous en avez plusieurs, demandez à l’assistant de lister vos espaces de travail et d’en choisir un.

Outils pour les espaces de travail

list_workspaces, renvoie vos espaces de travail
get_active_workspace, affiche l’espace de travail utilisé
set_active_workspace, sélectionne un espace de travail pour les appels suivants

Outils

Ce qu’un assistant peut faire une fois connecté.

Le serveur expose 129 outils

Factures et devis (18) : lister, obtenir, créer, enregistrer, supprimer, dupliquer, convertir un devis en facture, statut, marquer comme payée, aperçu et envoi de l’e-mail, liens de partage, lien PDF, activité, analyses de consultation, rappels
Factures récurrentes (7) : lister, obtenir, créer, modifier, mettre en pause, reprendre, supprimer
Clients (8) : lister, rechercher, obtenir, relevé, créer, création rapide, modifier, supprimer
Profils de facturation et bibliothèque d’articles (7)
Modèles (6) : lister les modèles, modèles intégrés, modèle par défaut, obtenir, définir le modèle par défaut, préréglages
Dépenses (21) : créer (une ou plusieurs), modifier, supprimer, soumettre, approuver, rejeter, marquer comme payée, annuler, actions groupées, dépenses refacturables, lier aux factures, pièces jointes, activité
Rapports de dépenses (9) : statistiques, synthèse, mensuel, trimestriel, annuel, tendances, analyse des coûts, dépenses, déductibles fiscalement
Catégories, fournisseurs et étiquettes (12)
Budgets (5), dépenses récurrentes (7) et revenus (6)
Projets et jalons (10), dont la facturation d’un jalon
Rapports et tableaux de bord (7) : chiffres de la vue d’ensemble, rapports du workspace, compte de résultat, flux de trésorerie, résultat par client, rentabilité des clients, position nette
Espace de travail et profil (5) : get_profile, list_workspaces, get_active_workspace, set_active_workspace et attach_receipt_to_expense
Utilisation de l’offre (1) : get_subscription_usage

Non disponible via MCP : membres de l’équipe et invitations, export du compte, offres d’abonnement, conception de modèles, palettes de couleurs, et téléversement d’avatars ou de logos. Utilisez l’application web pour cela.

Les mêmes données sont disponibles via l’API REST : https://quickbilling.io/docs/api

Scénarios d’exemple

Des demandes qui s’associent bien aux outils.

Créer et envoyer une facture

« Crée une facture pour Bluebird Café pour 3 heures de design à 120 $ de l’heure et envoie-la. » L’assistant trouve ou ajoute le client, construit la facture et l’envoie par e-mail.

Enregistrer une dépense avec un reçu

« Enregistre ce reçu comme dépense Logiciels. » L’assistant crée la dépense dans cette catégorie et y joint le reçu.

Voir ce qui est en retard

« Quelles factures sont en retard ? » L’assistant liste les factures impayées dont l’échéance est dépassée.

Travailler entre plusieurs espaces de travail

« Liste mes espaces de travail et passe à Northwind Studio. » Poursuivez ensuite avec des demandes de factures ou de dépenses.

Connexion et sécurité

Votre compte, vos droits.

La connexion utilise OAuth avec votre compte QuickBilling, et le serveur distant n’accepte pas les clés d’API
Chaque appel s’exécute avec les droits de votre compte, y compris pour modifier et supprimer des enregistrements
Vérifiez ce que votre assistant propose avant de confirmer une modification
Supprimez la connexion dans votre client MCP pour couper l’accès
Ce qu’un assistant fait des données qu’il reçoit relève de la politique de son fournisseur, voir la section sur les assistants IA de la politique de confidentialité

Dépannage

Problèmes de configuration courants.

Le client ne parvient pas à se connecter

Vérifiez que votre client gère les serveurs MCP distants avec connexion OAuth et que l’URL est exactement https://mcp.quickbilling.io/mcp.

La connexion ne se termine pas

Supprimez le serveur de votre client, ajoutez-le de nouveau et suivez l’invite de connexion avec votre compte QuickBilling.

Mauvaises données d’espace de travail

Demandez à l’assistant quel espace de travail est actif, puis faites-lui lister vos espaces de travail et choisir le bon.

Plus d’aide : https://quickbilling.io/contact, info@quickbilling.io