跳转到主要内容
MCP（Model Context Protocol，模型上下文协议）是一种开放协议，用于标准化 AI 应用与外部工具和数据源之间的连接方式。你可以把它理解为 AI 世界的”USB 接口”——就像 USB 让各种外设即插即用一样，MCP 让 AI 能够以统一的方式调用各类外部服务。 在没有 MCP 之前，AI 助手只能基于对话上下文回答问题。接入 MCP 后，QoderWork 可以直接操作你的日历、查询文档、获取地图信息等，真正成为一个能”动手做事”的助手。

​
工作原理

MCP 采用客户端-服务端架构：
  • MCP 客户端：即 QoderWork，负责发起请求并展示结果。
  • MCP 服务端：由各服务提供方（如钉钉、高德地图等）部署，负责执行具体操作并返回数据。
当你在 QoderWork 中提出需求时，AI 会自动判断是否需要调用某个 MCP 服务，然后通过协议完成调用并将结果呈现给你——你只需像平时一样用自然语言描述需求即可。

​
添加 MCP 服务

打开 QoderWork 桌面客户端，进入设置 → MCP 服务，点击右上角的 + 添加，可以看到两种添加方式：
mcp

​
粘贴 JSON 配置

适合从 MCP 市场直接复制 JSON 配置的场景。
  1. 点击 + 添加 → 粘贴 JSON 配置。
  2. 在弹出的对话框中，粘贴从 MCP 市场复制的 JSON 配置。
  3. 点击 导入 完成添加。
JSON 配置的格式示例： 
{
  "mcpServers": {
    "服务名称": {
      "type": "streamable-http",
      "url": "https://mcp-server-url.example.com/sse",
      "headers": {
        "Authorization": "Bearer your-token"
      }
    }
  }
}

​
手动填写配置

适合手动填写服务配置的场景。点击 + 添加 → 手动填写配置，在弹出的「添加 MCP 服务器」对话框中，首先从服务器类型下拉菜单中选择类型。不同类型对应不同的配置表单：

​
Streamable HTTP / SSE

远程托管的 MCP 服务，通过 URL 访问。大多数 MCP 市场提供的服务都属于此类型，配置简单，推荐优先使用。
  • 服务器名称：为该服务起一个易于辨识的名称。
  • 服务器地址：粘贴从 MCP 市场复制的 URL 链接。
  • Headers（可选）：如果服务需要认证，点击 + 添加 Header 填写请求头（如 Authorization: Bearer your-token）。也可以点击 粘贴 从剪贴板批量导入。
Streamable HTTP 是 SSE 的升级版本，功能更强大。如果 MCP 市场提供的是 Streamable Http URL，选择 Streamable HTTP 类型即可。

​
STDIO

本地运行的 MCP 服务，通过命令行启动。适合开发者使用本地工具或命令行集成的场景，需要本地已安装对应的运行环境（如 Node.js、Python 等）。
  • 服务器名称：为该服务起一个易于辨识的名称。
  • 命令：粘贴完整的启动命令，如 npx -y @modelcontextprotocol/server-filesystem。
  • 环境变量（可选）：服务运行时需要的环境变量（如 API Key、Access Token 等）。点击 + 添加变量 逐条添加键值对，也可以点击 粘贴 从剪贴板批量导入。
填写完成后，点击 添加 即可。
粘贴 JSON 配置和手动填写配置怎么选？ 粘贴 JSON 配置会自动解析配置中的所有字段（类型、地址、认证等），一步到位；手动填写配置需要逐项填写，但更灵活。两种方式效果一致，选择方便的即可。

​
管理 MCP 服务

添加完成后，MCP 服务会出现在 MCP 服务 页面的自定义服务区域中。你可以：
  • 通过开关启用或禁用某个服务。
  • 展开服务查看其提供的工具列表。
  • 点击编辑图标修改配置，或点击删除图标移除服务。
页面下方的内置服务区域展示了 QoderWork 预置的 MCP 服务（如浏览器、Notion、Linear 等），同样可以通过开关控制启用状态。

​
实战示例：接入钉钉 MCP

以钉钉 MCP 为例，演示从获取服务到在 QoderWork 中使用的完整流程。

​
第 1 步：进入钉钉 MCP 市场

  1. 打开浏览器，访问 钉钉 MCP 市场。
  2. 如未登录，请先完成登录。
  3. 在 MCP 广场中浏览可用的服务，可以使用搜索框按关键词搜索（如”文档”、“日历”、“地图”），或通过分类筛选。带有「平台精选」标签的是官方推荐的高质量 MCP。
  4. 点击感兴趣的 MCP 卡片进入详情页，查看介绍和支持的工具列表。
常用的钉钉官方 MCP 服务： 钉钉文档、钉钉日历、钉钉通讯录、钉钉待办、钉钉群聊、高德地图、钉钉 AI 表格等。

​
第 2 步：获取配置信息

在 MCP 详情页右侧，找到使用 MCP 区域。这里提供了两种配置信息，任选其一即可： 方式一：复制 JSON Config
  1. 在使用 MCP 区域下方，找到 JSON Config 部分。
  2. 点击右上角的 复制 按钮，将完整的 JSON 配置复制到剪贴板。
复制到的内容类似如下格式： 
{
  "mcpServers": {
    "钉钉文档": {
      "type": "streamable-http",
      "url": "https://mcp-gw.dingtalk.com/mserver/cb3be2c510...key=1b3bf5..."
    }
  }
}
方式二：复制 Streamable Http URL
  1. 在使用 MCP 区域上方，找到 Streamable Http URL 部分。
  2. 点击右侧的 复制 按钮，将服务的 URL 地址复制到剪贴板。

​
第 3 步：在 QoderWork 中添加

打开 QoderWork 桌面客户端，进入 设置 → MCP 服务，点击右上角 + 添加。根据上一步复制的内容，选择对应的添加方式： 如果复制的是 JSON Config：
  1. 点击 + 添加 → 粘贴 JSON 配置。
  2. 在弹出的「粘贴 JSON 配置」对话框中，将复制的 JSON 配置粘贴到输入框。
  3. 点击 导入。
如果复制的是 Streamable Http URL：
  1. 点击 + 添加 → 手动填写配置。
  2. 在弹出的「添加 MCP 服务器」对话框中，填写以下内容：
    • 服务器类型：选择 Streamable HTTP。
    • 服务器名称：输入一个易于辨识的名称，如 钉钉文档。
    • 服务器地址：粘贴复制的 URL 链接。
    • Headers：钉钉 MCP 一般无需额外配置，留空即可。
  3. 点击 添加。
添加完成后，该服务会出现在 MCP 服务 页面的自定义服务区域中。如果服务名称左侧显示绿色圆点，说明连接成功。可以展开查看该服务提供的工具列表。

​
第 4 步：验证是否接入成功

在 QoderWork 对话中直接尝试使用该服务，验证是否正常工作：
  • 接入了「钉钉文档」→ 试试说：“帮我找一下名为 XX 的文档”
  • 接入了「高德地图」→ 试试说：“帮我查一下北京的天气”
  • 接入了「钉钉日历」→ 试试说：“帮我创建一个明天上午 10 点的日程”
如果 QoderWork 正常调用 MCP 服务并返回结果，说明接入成功。

​
常见问题

Q：添加后 MCP 不工作怎么办？ 请依次检查：
  1. 确认 JSON 配置或 URL 链接复制完整、格式正确。
  2. 确认网络连接正常（部分 MCP 需要特定网络环境）。
  3. 确认对应服务是否需要额外的授权或登录操作。
  4. 尝试在 MCP 服务页面中删除后重新添加。
Q：MCP 服务调用有延迟怎么办？ MCP 服务的响应时间取决于服务提供方。大多数服务能在数秒内返回结果。如持续超时，建议检查网络环境或联系服务提供方。