测试 MCP 服务器

使用 UiPath MCP Insightor、开源 MCP Insightor、cURL 或 Postman，在任何 AI 客户端外部直接测试 UiPath MCP 服务器。

在将 MCP 服务器连接到 AI 客户端之前，请直接测试连接和工具行为。通过“AI 客户端外部测试”，您可以确定问题源自 MCP 服务器、其身份验证还是 AI 客户端。

使用 UiPath MCP 检查器 进行测试

UiPath MCP 检查器在 Orchestrator 中运行，无需单独设置。

访问检查器

1. 在“MCP 服务器”页面上，选择一个 MCP 服务器。

2. 选择“检查器”图标。

   

调用工具

1. 从列表中选择一个工具。

2. 输入工具的输入参数。

3. 选择“调用”以检查结果。

   

使用 MCP 检查器 (CLI) 进行测试

MCP Insightor是一个开源工具，可通过可流式 HTTP 连接到任何 MCP 服务器。

先决条件

• 安装 Node.js 以运行 npx 命令。
• MCP 服务器 URL，可从 Orchestrator 中的“MCP 服务器”页面获取。
• 持有者令牌。对于最简单的选项，请使用个人访问令牌 (PAT) 。有关其他受支持的令牌类型，请查看MCP 服务器身份验证。

1. 从终端运行以下命令。这在 macOS、Linux 和 Windows（PowerShell 7 或 Git Bash）上相同：

   npx @modelcontextprotocol/inspector@0.22.0
   

   该命令将在浏览器中打开检查器网页用户界面。

2. 输入 MCP 服务器 URL。

3. 选择可流式传输的 HTTP作为传输类型。

4. 在“身份验证”部分中，以Bearer <token>格式输入令牌。

5. Select Connect.

   

结果

连接后，您可以：

• 列出工具，以验证所有工具是否具有正确的 JSON 架构。
• 调用工具以使用测试输入来执行工具并检查响应。
• 观看会话，以实时查看 initialize → initialized → request 的生命周期。
• 验证架构，以在类型不匹配到达 LLM 之前捕获它们。

使用 cURL 测试

使用 cURL 发送原始 JSON-RPC 请求，并检查完整的请求/响应周期（包括标头）。

先决条件

• 持有者令牌。查看MCP 服务器身份验证以获取支持的方法。
• MCP 服务器 URL，可从 Orchestrator 中的“MCP 服务器”页面获取。

1. 将令牌和服务器 URL 设置为环境变量：

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

2. 初始化 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"}
       }
     }'
   

   使用 -v 标志查看响应标头，并保存 mcp-session-id 标头值。每个后续请求都需要它。

   备注：

   UiPath MCP 服务器支持协议版本 2025-06-18。发送 2025-11-25（最新的 MCP 规范版本）也许可以，因为服务器会使用其支持的版本进行响应，但请使用 2025-06-18 以避免不支持的行为。

3. 发送已初始化的通知：

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

   服务器返回 202 Accepted 而非正文。服务器在处理工具请求之前需要此通知。

4. 列出可用工具：

   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. 调用工具：

   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. 关闭会话：

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

使用 Postman 测试

Postman 在本地支持 MCP 请求。

1. 在您的集合中创建一个 MCP 请求。
2. 选择“HTTP”作为传输，代表“可流式传输的 HTTP”。
3. 输入 MCP 服务器 URL。
4. 在“授权”选项卡中，使用您的令牌配置“持有者令牌”身份验证。
5. Select Connect.

Postman 会自动处理会话生命周期，包括 initialize 和 notifications/initialized。

提示：

要手动发送原始 JSON-RPC 请求，例如，要单独控制每个请求和响应，请将 Postman 作为普通 REST 客户端，并遵循与使用 cURL 测试相同的请求流。