Test des serveurs MCP

Testez un serveur MCP UiPath directement, en dehors de tout client AI, à l'aide de l'Inspecteur MCP UiPath, de l'Inspecteur MCP open source, cURL ou Postman.

Avant de connecter un serveur MCP à un client IA, testez directement la connexion et le comportement de l’outil. Le test en dehors d’un client d’IA vous permet d’isoler si un problème provient du serveur MCP, de son authentification ou du client d’IA.

Tester avec l’inspecteur MCP UiPath

L’inspecteur MCP UiPath s’exécute dans Orchestrator et ne nécessite aucune configuration distincte.

Accéder à l’inspection

1. À la page Serveurs MCP, sélectionnez un serveur MCP.

2. Sélectionnez l'icône Inspecteur.

   

Appeler un outil

1. Sélectionnez un outil dans la liste.

2. Saisissez les paramètres d'entrée de l'outil.

3. Sélectionnez Invoquer pour inspecter le résultat.

   

Tests avec l’inspecteur MCP

L’ inspection MCP est un outil open source qui se connecte à n’importe quel serveur MCP via HTTP Streamable.

Prérequis

• Node.js est installé pour exécuter la commande npx.
• L'URL du serveur MCP, disponible à partir de la page Serveurs MCP dans Orchestrator.
• Un jeton de porteur. Pour l’option la plus simple, utilisez un jeton d’accès personnel. Pour obtenir d’autres types de jetons pris en charge, consultez la section Authentification du serveur MCP.

1. Depuis un terminal, exécutez la commande suivante. C'est la même chose sur macOS, Linux et Windows (PowerShell 7 ou Git Bash):

   npx @modelcontextprotocol/inspector@0.22.0
   

   La commande ouvre l'interface utilisateur Web de l'administrateur dans votre navigateur.

2. Saisissez l’URL du serveur MCP.

3. Sélectionnez HTTP Streamable comme type de transport.

4. Dans la section Authentification , saisissez le jeton au format Bearer <token>.

5. Select Connect.

   

Résultat

Une fois connecté, vous pouvez:

• Répertoriez des outils pour vérifier que tous vos outils apparaissent avec des schémas JSON corrects.
• Appelez des outils pour exécuter des outils avec des entrées de test et inspecter les réponses.
• Regardez la session pour voir le cycle de vie initialize → initialized → request en temps réel.
• Validez les schémas pour détecter les incompatibilités de type avant qu’ils ne parviennent à un LLM.

Tester avec cURL

Utilisez cURL pour envoyer des requêtes JSON-RPC brutes et inspecter le cycle complet de la demande/réponse, y compris les en-têtes.

Prérequis

• Un jeton de porteur. Consultez la section Authentification du serveur MCP pour connaître les méthodes prises en charge.
• L'URL du serveur MCP, disponible à partir de la page Serveurs MCP dans Orchestrator.

1. Définissez le jeton et l'URL du serveur en tant que variables d'environnement:

   TOKEN="your-bearer-token"
   SERVER_URL="https://cloud.uipath.com/{org}/{tenant}/agenthub_/mcp/{folder}/{slug}"
   

2. Initialisez la session MCP:

   curl -v -X POST "$SERVER_URL" \
     -H "Authorization: Bearer $TOKEN" \
     -H "Content-Type: application/json" \
     -H "Accept: application/json, text/event-stream" \
     -d '{
       "jsonrpc": "2.0",
       "id": 1,
       "method": "initialize",
       "params": {
         "protocolVersion": "2025-06-18",
         "capabilities": {},
         "clientInfo": {"name": "curl-test", "version": "1.0"}
       }
     }'
   

   Utilisez l'indicateur -v pour voir les en-têtes de réponse et enregistrez la valeur de l'en-tête mcp-session-id. Chaque requête ultérieure en aura besoin.

   Remarque :

   Les serveurs MCP UiPath prennent en charge la version 2025-06-18 du protocole. L'envoi de 2025-11-25 (la dernière version spécifique au protocole MCP) peut fonctionner, car le serveur répond avec la version qu'il prend en charge, mais utilisez 2025-06-18 pour éviter un comportement non pris en charge.

3. Envoyez la notification initialisée:

   curl -X POST "$SERVER_URL" \
     -H "Authorization: Bearer $TOKEN" \
     -H "Content-Type: application/json" \
     -H "mcp-session-id: $SESSION_ID" \
     -d '{"jsonrpc": "2.0", "method": "notifications/initialized"}'
   

   Le serveur répond avec 202 Accepted et sans corps. Le serveur requiert cette notification avant de traiter les requêtes d’outils.

4. Dressez la liste des outils disponibles:

   curl -X POST "$SERVER_URL" \
     -H "Authorization: Bearer $TOKEN" \
     -H "mcp-session-id: $SESSION_ID" \
     -H "Content-Type: application/json" \
     -d '{
       "jsonrpc": "2.0",
       "id": 2,
       "method": "tools/list"
     }'
   

5. Appelez un outil:

   curl -X POST "$SERVER_URL" \
     -H "Authorization: Bearer $TOKEN" \
     -H "mcp-session-id: $SESSION_ID" \
     -H "Content-Type: application/json" \
     -d '{
       "jsonrpc": "2.0",
       "id": 3,
       "method": "tools/call",
       "params": {
         "name": "add",
         "arguments": {"a": 5, "b": 3}
       }
     }'
   

6. Fermer la session:

   curl -X DELETE "$SERVER_URL" \
     -H "Authorization: Bearer $TOKEN" \
     -H "mcp-session-id: $SESSION_ID"
   

Tester avec Postman

Postman prend en charge les requêtes MCP de manière native.

1. Créez une requête MCP dans votre collection.
2. Sélectionnez HTTP comme transport pour HTTP Streamable.
3. Saisissez l’URL du serveur MCP.
4. Dans l'onglet Autorisation , configurez l'authentification du jeton du porteur avec votre jeton.
5. Select Connect.

Postman gère automatiquement le cycle de vie des sessions, y compris initialize et notifications/initialized.

Astuce :

Pour envoyer des requêtes JSON-RPC brutes à la place, par exemple pour contrôler chaque requête et réponse individuellement, utilisez Postman en tant que client REST simple et suivez le même flux de requêtes que Tester avec cURL.