Testen von MCP-Servern

Testen Sie einen UiPath-MCP-Server direkt außerhalb eines KI-Clients mit dem UiPath-MCP-Instanzer, dem Open-Source-MCP-Instanz, cURL oder Postman.

Bevor Sie einen MCP-Server mit einem KI-Client verbinden, testen Sie die Verbindung und das Tool-Verhalten direkt. Durch Testen außerhalb eines KI-Clients können Sie isolieren, ob ein Problem vom MCP-Server, seiner Authentifizierung oder dem KI-Client stammt.

Testen mit dem UiPath MCP-Instanz

Der UiPath-MCP-Instanz wird innerhalb von Orchestrator ausgeführt und erfordert keine separate Einrichtung.

Greifen Sie auf den Injector zu

1. Wählen Sie auf der Seite MCP-Server einen MCP-Server.

2. Wählen Sie das Prüfsymbol aus.

   

Rufen Sie ein Tool auf

1. Wählen Sie ein Tool aus der Liste aus.

2. Geben Sie die Eingabeparameter des Tools ein.

3. Wählen Sie Aufrufen aus, um das Ergebnis zu überprüfen.

   

Testen mit dem MCP-Instanz (CLI)

Der MCP-Instanz ist ein Open-Source-Tool, das sich über streambare HTTP mit einem beliebigen MCP-Server verbindet.

Voraussetzungen

• Node.js wird installiert, um den Befehl npx auszuführen.
• Die MCP-Server-URL, verfügbar auf der Seite MCP-Server im Orchestrator.
• Ein Bearer-Token. Verwenden Sie für die einfachste Option ein persönliches Zugriffstoken (PAT). Informationen zu anderen unterstützten Tokentypen finden Sie unter MCP-Serverauthentifizierung.

1. Führen Sie über ein Terminal den folgenden Befehl aus. Unter macOS, Linux und Windows (PowerShell 7 oder Git Bash) ist es identisch:

   npx @modelcontextprotocol/inspector@0.22.0
   

   Der Befehl öffnet die Injector-Webbenutzeroberfläche in Ihrem Browser.

2. Geben Sie die MCP-Server-URL ein.

3. Wählen Sie Streamable HTTP als Transporttyp aus.

4. Geben Sie im Abschnitt Authentifizierung das Token im Format Bearer <token> ein.

5. Select Connect.

   

Ergebnis

Sobald die Verbindung hergestellt ist, können Sie:

• Listen Sie Tools auf, um zu überprüfen, ob alle Ihre Tools mit korrekten JSON-Schemas angezeigt werden.
• Rufen Sie Tools auf, um Tools mit Testeingaben auszuführen und Antworten zu überprüfen.
• Beobachten Sie die Sitzung, um den Lebenszyklus initialize → initialized → request in Echtzeit zu sehen.
• Validieren Sie Schemas, um Typkonflikte zu erkennen, bevor sie ein LLM erreichen.

Testen mit cURL

Verwenden Sie cURL, um unformatierte JSON-RPC-Anforderungen zu senden und den vollständigen Anforderungs-/Antwortzyklus einschließlich Header zu überprüfen.

Voraussetzungen

• Ein Bearer-Token. Überprüfen Sie die MCP-Server-Authentifizierung auf unterstützte Methoden.
• Die MCP-Server-URL, verfügbar auf der Seite MCP-Server im Orchestrator.

1. Legen Sie das Token und die Server-URL als Umgebungsvariablen fest:

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

2. Initialisieren Sie die MCP-Sitzung:

   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"}
       }
     }'
   

   Verwenden Sie das Flag -v, um Antwortheader anzuzeigen, und speichern Sie den Headerwert mcp-session-id. Jede nachfolgende Anforderung benötigt es.

   Hinweis:

   UiPath-MCP-Server unterstützen die Protokollversion 2025-06-18. Das Senden von 2025-11-25 (der neuesten MCP-Spezifikationsversion) funktioniert möglicherweise, da der Server mit der von ihm unterstützten Version antwortet, aber verwenden Sie 2025-06-18, um nicht unterstütztes Verhalten zu vermeiden.

3. Senden Sie die initialisierte Benachrichtigung:

   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"}'
   

   Der Server antwortet mit 202 Accepted und ohne Text. Der Server benötigt diese Benachrichtigung, bevor er Toolanforderungen verarbeitet.

4. Listen Sie die verfügbaren Tools auf:

   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. Ein Tool aufrufen:

   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. Sitzung schließen:

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

Testen mit Postman

Postman unterstützt MCP-Anforderungen nativ.

1. Erstellen Sie eine MCP-Anforderung in Ihrer Sammlung.
2. Wählen Sie HTTP als Transport für Streamable HTTP aus.
3. Geben Sie die MCP-Server-URL ein.
4. Konfigurieren Sie auf der Registerkarte Autorisierung die Bearer-Token -Authentifizierung mit Ihrem Token.
5. Select Connect.

Postman verarbeitet den Sitzungslebenszyklus, einschließlich initialize und notifications/initialized, automatisch.

Tipp:

Um stattdessen unformatierte JSON-RPC-Anforderungen manuell zu senden, z. B. um jede Anforderung und Antwort einzeln zu steuern, verwenden Sie Postman als einfachen REST-Client und folgen Sie dem gleichen Anforderungsablauf wie Testen mit cURL.