Comprendre le connecteur MCP Billabex

En bref

Le connecteur MCP relie un assistant compatible aux données et actions Billabex sans lui transmettre votre mot de passe. Le client découvre les capacités du serveur distant, puis OAuth vous fait choisir le compte et les permissions accordées. Commencez par un accès en lecture, testez-le sur une organisation connue et n’ajoutez l’écriture que pour un besoin identifié.

Résultat attendu

Votre client IA se connecte au serveur officiel Billabex, s’authentifie par OAuth et peut exécuter un premier contrôle en lecture.

Avant de commencer

Utilisez un client qui accepte les serveurs MCP distants protégés par OAuth.
Récupérez l’URL du connecteur depuis Paramètres > Intégrations dans Billabex, jamais depuis un message non vérifié.

Procédure

Dans Billabex, ouvrez Paramètres > Intégrations et copiez l’URL officielle du connecteur MCP.
Dans votre client IA, ajoutez un serveur MCP distant nommé Billabex et collez cette URL.
Lancez la connexion OAuth, connectez-vous à Billabex et vérifiez l’organisation affichée.
Accordez mcp:read pour commencer ; n’accordez mcp:write que si l’assistant doit réellement modifier des données.
Demandez au client de lister vos organisations ou de résumer un compte connu, puis comparez la réponse à Billabex.

Ce que fait Billabex

Le client communique avec le serveur MCP distant et passe par OAuth avant d’accéder à Billabex. Les outils, ressources et prompts disponibles dépendent des scopes accordés. L’URL sert à la configuration du client ; ce n’est pas une page destinée à être ouverte directement dans un navigateur.

Si le résultat n’est pas celui attendu

N’utilisez pas l’ouverture de l’URL dans un navigateur comme test de santé du connecteur.
Si l’authentification ne se termine pas, déconnectez puis reconnectez le client une seule fois.
Ne transmettez jamais de mot de passe, jeton OAuth ou en-tête Authorization au support.

Sources officielles

Introduction au protocole MCP