使用交互式登录 (CLI) 进行身份验证

交互式登录专为需要快速访问以测试 MCP 服务器的本地开发者而设计。此方法中的客户端是在开发计算机上运行的 UiPath CLI（ uipath命令行工具）。

运行uipath auth时，CLI 会在默认浏览器中打开 UiPath 云登录页面。进行身份验证后，CLI 会将生成的持有者令牌保存到当前目录中的.env文件中。然后，您可以将此令牌包含在发送至 MCP 服务器端点的 HTTP 请求的Authorization标头中。

交互式登录适用于以下场景：

• MCP 服务器的本地开发和测试。
• 使用 cURL、Postman 或 MCP 检查器进行快速 API 测试。
• 在具有完整用户权限的情况下调试 MCP 工具调用。
• 人类开发者位于终端前的任何场景。

它不适用于无人值守或自动化场景。在这种情况下，请改用外部应用程序。对于 IDE 集成，请使用MCP OAuth 流程。

先决条件

• UiPath CLI 已在开发计算机上安装。
• 您在包含 MCP 服务器的文件夹中拥有具有Automation User 、 Automation Developer或Folder Administrator角色的帐户。

身份验证并调用 MCP 服务器

1. 对 UiPath 进行身份验证：

   uipath auth
   

   CLI 将打开您的默认浏览器。登录 UiPath Cloud 以完成身份验证。CLI 会将生成的持有者令牌作为.env文件保存到当前目录中的UIPATH_ACCESS_TOKEN中。

2. 将令牌导出到 shell 环境：

   export UIPATH_ACCESS_TOKEN=$(grep UIPATH_ACCESS_TOKEN .env | cut -d= -f2)
   

3. 使用导出的令牌调用 MCP 服务器：

   curl -X POST "https://cloud.uipath.com/{org}/{tenant}/agenthub_/mcp/{folderKey}/{slug}" \
     -H "Authorization: Bearer $UIPATH_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"jsonrpc":"2.0","method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}},"id":1}'
   

结果

MCP 服务器验证令牌并响应initialize请求。然后，您可以在每个请求中使用相同的Authorization标头发送后续 MCP 协议消息。

令牌特征

• 类型： JWT
• 受众：包括OrchestratorApiUserAccess
• 颁发者： UiPath Identity Server ( {env}.uipath.com/identity_ )
• 过期时间：一小时。不会自动刷新，请重新运行uipath auth以获取新令牌。

令牌可授予：

• 访问已登录用户具有角色分配的所有文件夹。
• 用户在这些文件夹中拥有的所有权限（继承自其角色）。
• 与 Integration Service 活动兼容（存在用户上下文）。

适用的 MCP 服务器类型

此身份验证方法适用于所有 MCP 服务器类型：UiPath、编码、命令、自托管、远程和平台。