使用个人访问令牌进行身份验证

个人访问令牌 (PAT) 是用户作用域的令牌，具有可配置的生命周期（最长一年）。当您需要比交互式登录提供的令牌更长的令牌时，或者当您无法以交互方式运行uipath auth ，但仍需要以用户身份进行身份验证时，这些设置非常有用。

创建 PAT 时，您必须从Orchestrator API 访问资源中选择涵盖您所需的 MCP 操作的权限。

先决条件

• 您在包含 MCP 服务器的文件夹中具有Automation User 、 Automation Developer或Folder Administrator角色。这些角色包括MCPServers.View权限。

生成个人访问令牌

1. 转到 UiPath，选择您的用户图标，然后选择首选项。

2. 导航到“个人访问令牌” ，然后选择“生成新令牌” 。

3. 输入名称和到期日期。

4. 在“作用域”下，从“Orchestrator API 访问权限”资源中选择以下权限：

   • OR.Execution ：对于列出工具为必要项。MCP 服务器调用 Orchestrator ListReleases API 来解析流程元数据，并且该端点需要此作用域。
   • OR.Jobs ：执行工具所必需的。将流程作为工具运行的所有 MCP 服务器类型（UiPath、Coded 和 Command）都会调用 Orchestrator StartJobs API，该 API 需要此作用域。

5. 选择“保存”并立即复制令牌。

   重要提示：

   令牌仅显示一次。如果现在不复制，则必须生成新令牌。

结果

该令牌现在可在 MCP 服务器发出的 HTTP 请求的Authorization标头中使用。

使用个人访问令牌

要使用令牌调用 MCP 服务器：

curl -X POST "https://cloud.uipath.com/{org}/{tenant}/agenthub_/mcp/{folderKey}/{slug}" \
  -H "Authorization: Bearer <your-PAT>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"initialize","params":{...},"id":1}'

令牌特征

• 不透明令牌，其受众为UiPath.Orchestrator 。
• 可配置的到期时间（最长一年）。
• 访问权限是 PAT 作用域与用户文件夹级别角色权限的交集。
• 适用于任何 HTTP 客户端（cURL、Postman、MCP 检查器、自定义代码）。

限制

• PAT 与特定用户身份绑定。如果已停用用户，则 PAT 将停止工作。
• PAT 只能由具有 UiPath 交互式访问权限的用户创建。
• Integration Service 活动不支持 PAT 身份验证。MCP 连接成功，但依赖 Integration Service 连接的工具调用失败。