Connecter un client IA via MCP
Ajoutez Xuda comme serveur MCP distant à Claude, Cursor ou tout autre client compatible MCP.
Cette page concerne le côté client : faire dialoguer Claude, Cursor ou tout autre client qui parle MCP avec votre compte Xuda. Pour le protocole lui-même, le nommage des outils, le cycle de vie des sessions et la forme des erreurs, voir MCP.
Ce dont vous avez besoin
Une seule chose : une clé API. Créez-en une depuis l'espace Développeurs du compte (l'accès complet atteint tout ce que le propriétaire de la clé peut atteindre, l'accès personnalisé n'atteint qu'un ensemble autorisé de méthodes), voir Authentification. Il n'y a pas d'identifiant MCP séparé : la même clé fonctionne en REST simple sur /cpi/<method> et via MCP.
Chaque clé API de compte, et la clé émise automatiquement pour chaque machine Full Stack VPS, pointent vers la même adresse : https://xuda.ai/mcp. Une clé Full Stack VPS expose en plus les outils de plugin installés sur cette machine à côté des méthodes de l'écosystème, voir Full Stack VPS.
Connecter un client
Cursor lit son extrait dans .cursor/mcp.json (projet) ou dans ses réglages MCP globaux. Claude Desktop et claude.ai ajoutent un serveur distant depuis les Réglages, sous Connecteurs : un nom, l'URL et le même en-tête Authorization. Tout autre client MCP n'a besoin que des deux mêmes informations : un point d'accès HTTP en streaming à https://xuda.ai/mcp, et la clé sur chaque requête sous la forme Authorization: Bearer YOUR_API_KEY.
La page Développeurs, Clés API de chaque compte a une carte Connecter sous la liste des clés. Son sélecteur de format fait passer un bloc entre .env, Next.js, MCP, cURL, Node.js et PHP, chacun déjà rempli avec le point d'accès et la première clé de la liste, que l'en-tête du bloc nomme. Le format .env contient XUDA_MCP_URL à côté de la base REST et de la clé, et le format MCP est la commande Claude Code ci-dessus. La clé s'affiche masquée jusqu'à ce que vous la révéliez ; Copier prend toujours la vraie valeur.
Ce que l'agent reçoit à la connexion
La première requête d'une nouvelle connexion est un appel MCP initialize. La réponse de Xuda contient un champ instructions construit à partir du guide LLM de Studio, le même modèle de document de prog, la même référence d'attributs xu-* et les mêmes règles de workflow que sur cette page, fusionnés à partir des registres vivants de la plateforme pour qu'il ne décrive jamais une règle que le validateur déployé n'applique pas réellement. La plupart des clients MCP transmettent instructions directement dans le contexte du modèle, donc l'agent sait déjà comment un prog Studio est construit avant son premier appel d'outil, sans briefing séparé.
Deux outils valent la peine d'être appelés directement plutôt que de se fier à ce qui est arrivé à la connexion : get_studio_guide relit n'importe quelle rubrique à la demande (components, tables, programs, javascript, attributes, anatomy, gotchas), et get_prog_examples renvoie des progs d'exemple fonctionnels et choisis sur lesquels modeler une construction.
Un point d'accès dédié pour un programme d'API
Les méthodes ci-dessus forment tout le catalogue du compte derrière une seule clé. Quand vous voulez qu'un système externe atteigne exactement un point d'accès d'un projet, déployez-le : Déployer > Déploiements > Serveur liste Serveur MCP à côté de Cron, Api, Node et Emitter. Son étape Paramètres de lancement choisit l'un des programmes api du projet comme cible, puis les étapes habituelles de centre de données, de niveau de performance et de nommage le livrent comme son propre point d'accès. Voir Votre premier déploiement pour les parties communes de cet assistant, et API pour ce qu'est un programme api.
mcp figure aujourd'hui parmi les types de déploiement bêta de la plateforme, à côté de router, android et emitter.