使用 MCP 服务器配置外部工具

为Delegate添加、管理和配置 MCP 服务器，包括自定义服务器、settings.json、和 MCP Apps。

MCP 是一种开放式协议，用于将 AI 助手连接到外部数据源和工具。与 Integration Service 连接器不同，MCP 服务器可以是远程（托管在其他地方，通过 HTTP 访问）或本地（在您的计算机上运行的程序）。

大多数 MCP 服务器不需要手动配置 — 请参阅MCP 服务器参考，了解 Orchestrator 支持的目录和第三方市场，这两个市场都可以一键添加服务器。

添加自定义 MCP 服务器

对于目录或市场中没有的服务器，请从加载项和集成→ MCP 服务器中手动添加。

远程 MCP 服务器

远程 MCP 服务器在其他位置托管，并通过 HTTP 访问：

1. 选择“添加 MCP 服务器” → “远程” 。
2. 输入服务器详细信息：
   • URL ：端点地址（例如https://api.example.com/mcp ）
   • 标题：友好名称（例如“公司 API”）
   • 标头（可选）：身份验证标头（如果需要）
3. 选择“保存”。
4. 切换至“已启用”即可激活。

配置示例：

{
  "type": "remote",
  "url": "https://internal-api.company.com/mcp",
  "enabled": true,
  "title": "Company Data API",
  "headers": {
    "Authorization": "<your-access-token>"
  }
}

本地 MCP 服务器

本地 MCP 服务器在您的计算机上作为进程运行：

1. 选择“添加 MCP 服务器” → “本地” 。
2. 输入服务器详细信息：
   • 标题: 友好名称
   • 命令: 要运行的可执行文件（例如node 、 python 、 /path/to/server ）
   • 参数: 命令行参数
   • 工作目录：运行命令的位置
   • 环境变量：流程的键值对
3. 选择“保存”。
4. 切换至“已启用”即可激活。

配置示例

文件系统 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"
  }
}

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": "<your-github-token>"
    },
    "cwd": "/Users/username"
  }
}

管理 MCP 服务器

从加载项和集成→ MCP 服务器，您可以打开或关闭已配置的服务器、编辑其配置或将其删除。禁用服务器会停止智能体使用其工具，但不会停止已在运行的本地服务器进程 — 您可能需要自行停止该进程。

智能体如何发现 MCP 工具

启用 MCP 服务器后，智能体将连接到该服务器，服务器报告其可用工具，并且这些工具将在对话中可用——无需手动注册。您可以用自然语言引用它们，例如：“使用文件系统工具列出我的 Documents 文件夹。”

MCP Apps：内联交互式界面

MCP Apps是模型上下文协议的扩展程序，可让工具返回交互式界面（表单、仪表板、图表、数据表），而不仅仅是文本。当已连接的 MCP 服务器的工具支持时，Delegate 会在对话的沙盒框架中内联呈现该界面：界面可以调用服务器自己的工具并接收更新，但无法访问其自身框架以外的任何内容。表单已预先填充实用值，因此您只需更改重要的内容，而无需描述聊天中的每个字段。

给定的 MCP 服务器是否提供此功能取决于该服务器——并非每个服务器都实现了此扩展程序。

管理员可以在策略级别监管 MCP 服务器 — 请参阅“使用 Automation Ops 进行监管”中的MCP 服务器。

高级：通过settings.json 进行连接管理

超级用户可以直接在settings.json中管理 MCP 服务器连接 — 该mcpServers列表与用户界面读取和写入相同：

{
  "mcpServers": [
    {
      "type": "remote",
      "url": "https://api.example.com/mcp",
      "enabled": true,
      "title": "Example API",
      "headers": {
        "Authorization": "<your-access-token>"
      }
    },
    {
      "type": "local",
      "enabled": true,
      "serverId": "my-local-server",
      "title": "Local Tools",
      "config": {
        "command": "python",
        "args": ["/path/to/server.py"],
        "env": { "API_KEY": "<your-api-key>" },
        "cwd": "/path/to/working/dir"
      }
    }
  ]
}

仅在您熟悉 JSON 时编辑settings.json — 无效语法会阻止加载应用程序。务必在编辑前进行备份。请参阅设置文件位置。

有关连接的安全注意事项和数据流信息，请参阅本地安全配置。

后续步骤

• MCP 服务器参考— Orchestrator 目录和第三方市场
• 连接到热门业务应用程序— 适用于托管 SaaS 集成
• 使用例程重复工作— 保存使用您已连接工具的工作流
• 与团队共享技能—查找为互连服务构建的技能