MCP
La même clé API, exposée à un agent IA sous forme d'un outil typé par méthode autorisée.
Xuda exécute un serveur Model Context Protocol sur /mcp, à côté de /cpi. Connectez-y un agent compatible MCP,
en vous connectant ou avec une clé API, et chaque méthode que cette clé a le droit d'appeler apparaît comme un
outil typé, sans intégration séparée à écrire pour les agents IA.
Se connecter
Il y a deux voies, et toutes deux aboutissent au même endroit : les droits d'une clé API.
Se connecter (connecteurs Claude et autres clients OAuth)
Ajoutez https://xuda.ai/mcp comme connecteur personnalisé dans Claude (Paramètres, Connecteurs, Ajouter un
connecteur personnalisé), laissez vides l'identifiant et le secret du client OAuth, puis appuyez sur Connecter. Claude ouvre
Xuda : connectez-vous si ce n'est pas déjà fait, et une fenêtre du tableau de bord demande avec laquelle de vos clés API la
connexion agit ; choisissez-en une et appuyez sur Connecter. Claude sur le web, Desktop, mobile et Cowork
partagent cette connexion, et tout autre compte Claude l'ajoute de la même façon. L'onglet Développeurs, MCP
du tableau de bord affiche l'adresse à coller, ces étapes et tout ce qui suit.
Claude Code se connecte de la même façon quand vous ajoutez le serveur sans en-tête, puis exécutez /mcp et
choisissez Authenticate :
La connexion n'a jamais de droits propres. Chaque appel d'outil s'exécute avec la clé que vous avez choisie, donc le mode d'accès de la clé, sa liste d'autorisation et sa révocation sont aussi ceux de la connexion : révoquez la clé sous Développeurs, Clés API et la connexion s'arrête, et la connexion suivante demande une autre clé. La page ne liste que vos propres clés actives ; si vous n'en avez aucune, créez-en une d'abord.
Pour les développeurs de clients, le serveur suit la spécification d'autorisation MCP :
Un appel à /mcp sans jeton utilisable répond 401 avec WWW-Authenticate: Bearer resource_metadata="...", ce qui permet à un client de trouver le reste. Les jetons d'accès durent une heure ; les jetons
d'actualisation durent 90 jours et sont remplacés à chaque utilisation. Une URI de redirection de bouclage (http://localhost ou
http://127.0.0.1) correspond sur n'importe quel port.
Une clé API dans un en-tête
La clé va dans un en-tête Authorization: Bearer, la même clé que vous utiliseriez comme api_key sur
/cpi. Il n'y a pas d'identifiant MCP distinct. Une requête sans en-tête Authorization, ou avec une clé
qui ne correspond à aucun document xuda_api_keys actif, est refusée avec 401 avant l'enregistrement du moindre outil.
Sessions
Le transport est du HTTP en flux continu : la première requête est un appel MCP initialize, qui ouvre une
session et renvoie un en-tête mcp-session-id ; chaque requête suivante sur cette connexion porte
le même en-tête et le même identifiant. Une session se ferme après 10 minutes sans requête. Une
requête sur une session fermée répond 404, et un client MCP démarre alors une nouvelle session de
lui-même.
Ce qui devient un outil
Les outils sont enregistrés au début de la session à partir du mode d'accès que la clé possède déjà :
- Accès complet : chaque méthode du catalogue qui n'est pas
privates'enregistre comme outil, résolue au moment de la connexion, donc une méthode ajoutée après la création de la clé est disponible sans aucun changement de la clé elle-même. - Accès personnalisé : seules les méthodes de la liste d'autorisation de la clé s'enregistrent.
Une session en cours suit sa clé : elle examine la clé chaque minute, et les modules et
plugins qui la sous-tendent toutes les cinq minutes, et quand l'ensemble des outils a changé elle envoie
notifications/tools/list_changed. Un client qui écoute (Claude le fait) lit la nouvelle liste sans
se reconnecter, donc une méthode que vous autorisez sur la clé parvient à un agent déjà connecté.
Chaque outil garde la forme de la méthode : le nom de l'outil est le nom de la méthode (get_account_projects,
dbs_read, ...), son titre est le nom de la méthode en casse de titre, sa description est la
description de la méthode, et son schéma d'entrée est construit champ par champ à partir des fields de la méthode ; les champs obligatoires
restent requis, tout le reste est facultatif. Un champ sans type reconnu devient quand même un
argument d'outil permissif plutôt que de casser toute la session, donc une méthode mal spécifiée
n'entraîne jamais le reste du catalogue avec elle.
Une clé limitée à un VPS Full Stack expose aussi les outils des plugins installés sur cette machine, en plus des méthodes de l'écosystème ci-dessus, de sorte qu'un agent peut atteindre à la fois la plateforme et ce que le développeur a construit sur la machine, en une seule session. Voir VPS Full Stack.
Appeler un outil
Un agent appelle un outil avec les mêmes arguments que décrivent les champs de la méthode. Xuda répond en
appelant la méthode en interne, comme le ferait /cpi/<method>, et renvoie à l'outil l'enveloppe
{code, data} de la méthode sous forme de texte. Un appel en échec revient quand même normalement au niveau MCP : le code
-1 et au-delà apparaît dans le résultat de l'outil exactement comme avec un appel REST simple, donc un agent le lit
comme votre propre gestion d'erreurs le ferait. Voir Erreurs.
Une requête qui échoue avant l'exécution de tout outil, un identifiant manquant ou refusé (401), une session
fermée (404, code -32001), un message MCP mal formé, revient sous forme d'erreur JSON-RPC
plutôt que de résultat d'outil :