Aller au contenu
Vérifié

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.

Un seul point d'accès pour toutes les clés

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

claude mcp add --transport http xuda https://xuda.ai/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"
{
  "mcpServers": {
    "xuda": {
      "url": "https://xuda.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}
{
  "mcpServers": {
    "xuda": {
      "type": "http",
      "url": "https://xuda.ai/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

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.

Le tableau de bord l'écrit pour vous

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.

Type de déploiement bêta

mcp figure aujourd'hui parmi les types de déploiement bêta de la plateforme, à côté de router, android et emitter.