- 概述
- 快速入门
- 信任与合规
- 监管
- 功能
- 制图工具
- Delegate for Testing
- 参考
- 故障排除
将 Delegate 连接到业务应用程序,使用 Integration Service 连接器实现托管 SaaS 集成,或使用 MCP 服务器实现自定义和本地工具连接。
本指南介绍如何将 Delegate 连接到您的业务应用程序和服务。Delegate 支持两种连接方法:用于托管 SaaS 集成的 Integration Service 连接器,以及用于自定义或本地工具连接的 MCP(模型上下文协议)服务器。
Integration Service 连接
Integration Service 为热门业务应用程序提供经过身份验证的安全连接。当您连接 Integration Service 连接器时,Delegate 可以:
- 在已连接的应用程序中读取和写入数据
- 使用您的权限代表您执行操作
- 在无需您共享密码的情况下访问数据
- 在后台运行,无需浏览器自动化
可用的集成
Delegate 支持 Integration Service 目录中的所有连接器,而不仅仅是固定子集。一些常见示例:
| 服务 | Delegate 可以执行的操作 |
|---|---|
| Microsoft Outlook | 阅读电子邮件,发送消息,管理日历,创建任务 |
| Gmail | 阅读电子邮件,发送消息,搜索对话 |
| Google 日历 | 读取活动、创建会议、查看空闲时间 |
| Google 云端硬盘 | 列出、读取和管理文件 |
| Google 文档 | 创建和编辑文档 |
| Slack | 读取频道、发布消息、管理会话 |
| Microsoft Teams | 读取频道、发布消息、查看提及情况 |
| Jira | 阅读问题,创建工单,更新状态,添加注释 |
| Confluence | 读取页面、搜索内容、创建文档 |
| GitHub | 读取存储库、问题、拉取请求;创建问题 |
| Salesforce | 读取和更新记录,创建任务,查看商机 |
先决条件
- Integration Service 必须在您的 UiPath 租户中可用。
创建连接
要创建 Integration Service 连接,请执行以下步骤:
- 打开“设置” → “连接” (或Integration Service )。
- 选择“添加连接”或“连接” 。
- 选择要连接的服务。
- 系统会将您重定向到该服务的 OAuth 授权页面。
- 使用该服务的现有帐户登录。
- 授予请求的权限。
- 您系统将返回到 Delegate,且连接已确认。
结果:连接显示在列表中,状态指示器为绿色。现在,您可以在 Delegate 中按名称引用此服务。
连接筛选器模式
控制 Delegate 可以访问的连接:
| Mode | 描述 | 用于以下情况 |
|---|---|---|
| 个人 | 仅您创建的连接 | 单独工作,测试 |
| 全部 | 租户/组织中的所有连接 | 团队环境、共享资源 |
要更改:设置 → 连接 → 筛选器下拉列表
注意:在“全部”模式下,您可以使用团队成员创建的连接,但只能在已连接的应用程序中查看您有权访问的数据。
测试连接
创建连接后:
- 该连接将显示在带有状态指示器的列表中。
- 绿色 = 已连接并正在运行。
- 黄色 = 已连接,但权限可能有限。
- 红色 = 连接失败或已过期。
要测试:让 Delegate 执行一个简单的操作:“列出我在 Outlook 中的未读电子邮件”或“显示我今天的日历”。
撤销连接
要撤销连接并删除Delegate对服务的访问权限,请执行以下步骤:
- 打开设置→连接。
- 找到要删除的连接。
- 选择断开连接或回收站图标。
- 确认断开连接。
结果:该连接将从列表中删除。在您重新连接之前,Delegate 将无法再访问该服务。
注意:这将删除 Delegate 的访问权限,但不会删除您的服务帐户。要完全撤销,请同时在服务自身设置中删除授权(例如,Google 帐户 → 安全 → 第三方应用程序)。
刷新过时的连接
在以下情况下,连接可能过期或失效:
- 您的密码已更改
- 该服务已撤销第三方访问权限
- 您组织已更改的安全策略
症状:Delegate 报告“连接失败”或“身份验证错误”
待修复
- 前往“设置”→“连接”。
- 查找失败的连接。
- 选择“重新连接”或“刷新” 。
- 再次完成 OAuth 流程。
MCP(模型上下文协议)服务器
MCP 是一种开放式协议,用于将 AI 助手连接到外部数据源和工具。与 Integration Service 连接器(由 UiPath 管理)不同,MCP 服务器可以:
- 远程: 您通过 URL 连接的托管服务
- 本地: 在您的计算机上运行的程序
何时使用 MCP 以及 Integration Service
下表介绍了每种连接方法的使用场景。
| 用例 | 推荐方法 |
|---|---|
| 热门 SaaS(Outlook、Slack、Salesforce) | Integration Service |
| 自定义内部 API | MCP 远程服务器 |
| 本地数据库或文件 | MCP 本地服务器 |
| 不带 Integration Service 连接器的专有工具 | MCP(任一类型) |
| 实验性或测试版集成 | MCP |
添加远程 MCP 服务器
远程 MCP 服务器在其他位置托管,可通过 HTTP 访问:
- 打开设置→ MCP 服务器。
- 选择“添加服务器” 。
- 选择“远程” 。
- 输入服务器详细信息:
- URL :端点地址(例如
https://api.example.com/mcp) - 标题: 友好名称(例如“公司 API”)
- 标头(可选):身份验证标头(如果需要)
- URL :端点地址(例如
- 选择“保存”。
- 切换至“已启用”即可激活。
示例配置
{
"type": "remote",
"url": "https://internal-api.company.com/mcp",
"enabled": true,
"title": "Company Data API",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
{
"type": "remote",
"url": "https://internal-api.company.com/mcp",
"enabled": true,
"title": "Company Data API",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
添加本地 MCP 服务器
本地 MCP 服务器在您的计算机上作为进程运行:
- 打开设置→ MCP 服务器。
- 选择“添加服务器” 。
- 选择“本地” 。
- 输入服务器详细信息:
- 标题: 友好名称。
- 命令: 要运行的可执行文件(例如
node、python、/path/to/server) - 参数: 命令行参数
- 工作目录:运行命令的位置
- 环境变量:流程的键值对
- 选择“保存”。
- 切换至“已启用”即可激活。
配置示例
示例:文件系统 MCP 服务器
{
"type": "local",
"enabled": true,
"serverId": "filesystem-mcp",
"title": "Local Filesystem Access",
"config": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/Documents"],
"env": {},
"cwd": "/Users/username"
}
}
{
"type": "local",
"enabled": true,
"serverId": "filesystem-mcp",
"title": "Local Filesystem Access",
"config": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/username/Documents"],
"env": {},
"cwd": "/Users/username"
}
}
示例:GitHub MCP 服务器
{
"type": "local",
"enabled": true,
"serverId": "github-mcp",
"title": "GitHub Integration",
"config": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxx"
},
"cwd": "/Users/username"
}
}
{
"type": "local",
"enabled": true,
"serverId": "github-mcp",
"title": "GitHub Integration",
"config": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-github"],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxxxxxxxxxxx"
},
"cwd": "/Users/username"
}
}
管理 MCP 服务器
在设置 → MCP 服务器中,您可以:
- 启用/禁用:打开/关闭单个服务器
- 编辑:修改配置(URL、命令、参数)
- 删除:删除服务器配置
- 测试: 验证服务器是否正确响应
注意:更改会立即生效。禁用服务器会阻止 Delegate 使用其工具,但不会停止正在运行的本地进程——您可能需要手动终止该进程。
Delegate 如何发现 MCP 工具
当启用 MCP 服务器时:
- Delegate 连接到服务器(远程为 HTTP,本地为 STdio)。
- 服务器报告其可用工具和功能。
- 工具将显示在“Delegate 的可用功能”中。
- 您可以用自然语言引用它们:“使用文件系统工具列出我的 Documents 文件夹”。
无需手动注册—MCP 工具会自动发现。
管理员可以在策略级别监管 MCP 服务器 — 请参阅“使用 Automation Ops 进行监管”中的MCP 服务器。
高级:通过“设置”管理连接
超级用户可以直接在 settings.json 中管理 MCP 连接:
{
"mcpServers": [
{
"type": "remote",
"url": "https://api.example.com/mcp",
"enabled": true,
"title": "Example API",
"headers": {
"Authorization": "Bearer token123"
}
},
{
"type": "local",
"enabled": true,
"serverId": "my-local-server",
"title": "Local Tools",
"config": {
"command": "python",
"args": ["/path/to/server.py"],
"env": {"API_KEY": "secret"},
"cwd": "/path/to/working/dir"
}
}
]
}
{
"mcpServers": [
{
"type": "remote",
"url": "https://api.example.com/mcp",
"enabled": true,
"title": "Example API",
"headers": {
"Authorization": "Bearer token123"
}
},
{
"type": "local",
"enabled": true,
"serverId": "my-local-server",
"title": "Local Tools",
"config": {
"command": "python",
"args": ["/path/to/server.py"],
"env": {"API_KEY": "secret"},
"cwd": "/path/to/working/dir"
}
}
]
}
注意:仅在您熟悉 JSON 时才编辑settings.json 。无效语法会阻止加载 Delegate。务必在编辑前进行备份。
有关连接的安全注意事项和数据流信息,请参阅本地安全配置。
后续步骤
了解如何:
- 使用例程重复工作— 保存使用您已连接工具的工作流
- 使用 Delegate Store 共享工作— 为您的关联服务查找预构建技能
- 查看“设置参考— 完整配置选项”