Aller au contenu principal

Studio MCP

L'écran Studio MCP vous permet d'enregistrer un serveur MCP, de lancer la découverte de ses outils et de lire les schémas d'entrée et de sortie versionnés de chaque outil. Chemin dans le portail : /studio/mcp. Il sert aux développeurs et aux administrateurs du tenant qui apportent un serveur d'outils métier aux agents.

Ce que montre l'écran​

  • À gauche, la liste des serveurs MCP visibles par la requête (GET /v1/mcp/servers), paginée, avec Nouveau en haut. Une liste vide affiche Aucun serveur MCP pour l'instant.
  • Sans serveur sélectionné : Enregistrer un serveur, un éditeur JSON vérifié en direct selon les champs du corps d'enregistrement : name (obligatoire, lettres minuscules, chiffres et tirets), url (obligatoire, commence par http:// ou https://), transport (sse ou streamable_http), allowed_tools, allowed_resources, owner.
  • Avec un serveur sélectionné :
    • une section titrée par le nom du serveur et son URL, le JSON du serveur et le bouton Découvrir les outils ;
    • Outils découverts : un tableau avec les colonnes Nom, Version, Statut, Portées, lu depuis GET /v1/mcp/catalog pour ce serveur ;
    • après un clic sur un outil : Schéma d'entrée et Schéma de sortie dans des éditeurs en lecture seule.

Actions​

Bouton ou actionCe qu'il faitAppel APIRôles
NouveauAffiche l'éditeur d'enregistrement avec le corps de départ new-mcp.AucunTout le monde
Clic sur un serveur de la listeAffiche le serveur et son catalogue d'outils.GET /v1/mcp/catalogTout utilisateur connecté
EnregistrerEnregistre le serveur, puis le sélectionne.POST /v1/mcp/serverstenant_admin, developer
Découvrir les outilsLance la découverte MCP (initialize, tools/list) : chaque outil nouveau ou modifié devient une version du catalogue en attente d'approbation.POST /v1/mcp/servers/{server_id}/discovertenant_admin, developer (et la relation éditeur sur le serveur)
Clic sur une ligne de Outils découvertsAffiche les schémas d'entrée et de sortie de l'outil.AucunTout utilisateur connecté
Réessayer (état d'erreur)Relit la liste ou le catalogue.GET /v1/mcp/servers ou GET /v1/mcp/catalogTout utilisateur connecté

Rôles​

Le portail active Enregistrer et Découvrir les outils pour STUDIO_WRITERS (tenant_admin, developer). Le Control Plane accepte tenant_admin, developer et application_owner sur les deux routes (WRITE_ROLES, services/control-plane/src/eai/domains/mcp/routes.py) ; la découverte demande aussi la relation éditeur sur le serveur.

Tâches courantes​

Enregistrer un serveur et découvrir ses outils​

  1. Ouvrir l'éditeur. Cliquez sur Nouveau. Résultat attendu : Enregistrer un serveur avec le corps de départ. En cas d'échec : rechargez la page.
  2. Remplir le corps. Le nom identifie le serveur ; l'URL est l'adresse où la passerelle le joint. Renseignez name, url et transport. Résultat attendu : Aucun problème détecté par l'éditeur. En cas d'échec : corrigez la ligne citée par le problème.
  3. Enregistrer. Cliquez sur Enregistrer. Résultat attendu : le message Serveur MCP enregistré et le serveur sélectionné. En cas d'échec : voir Dépannage.
  4. Découvrir. Le catalogue reste vide avant une découverte. Cliquez sur Découvrir les outils. Résultat attendu : le message Découverte terminée : les outils nouveaux ou modifiés attendent une approbation et les outils dans Outils découverts. En cas d'échec : vérifiez que l'URL répond au protocole MCP.

Lire le schéma d'un outil​

  1. Sélectionner le serveur. Cliquez dessus dans la liste. Résultat attendu : son catalogue. En cas d'échec : Aucun outil découvert signifie qu'aucune découverte n'a encore eu lieu.
  2. Cliquer sur l'outil. Résultat attendu : Schéma d'entrée et Schéma de sortie côte à côte. En cas d'échec : un objet vide {} signifie que le serveur n'a publié aucun schéma.

Dépannage​

SymptômeCauseCorrection
Enregistrer reste inactifJSON invalide, problème de schéma ou rôle manquant.Corrigez les problèmes ou demandez le rôle developer.
Erreur forbidden (403)Un rôle ou la relation éditeur sur le serveur manque.Demandez à un administrateur du tenant.
Erreur mcp_project_forbidden (403)Le serveur appartient à un autre projet que la requête.Travaillez dans le projet du serveur.
Aucun outil découvertAucune découverte lancée, ou le serveur ne liste aucun outil.Cliquez sur Découvrir les outils.
Un outil découvert ne peut pas être appeléLes outils nouveaux ou modifiés attendent une approbation.Approuvez la version de l'outil sur la page des serveurs MCP.

Pages liées​