> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 钉钉 MCP 接入

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

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

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

<Tip>
  **常用的钉钉官方 MCP 服务：** 钉钉文档、钉钉日历、钉钉通讯录、钉钉待办、钉钉群聊、高德地图、钉钉 AI 表格等。
</Tip>

### 第 2 步：获取配置信息

在 MCP 详情页右侧，找到**使用 MCP** 区域。这里提供了两种配置信息，任选其一即可：

**方式一：复制 JSON Config**

1. 在**使用 MCP** 区域下方，找到 **JSON Config** 部分。
2. 点击右上角的 **复制** 按钮，将完整的 JSON 配置复制到剪贴板。

复制到的内容类似如下格式：

```json theme={null}
{
  "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 桌面客户端，进入左侧导航的「**扩展**」→「**连接器**」，点击右上角 **+ 添加**。根据上一步复制的内容，选择对应的添加方式：

**如果复制的是 JSON Config：**

1. 点击 **+ 添加** → **粘贴 JSON 配置**。
2. 在弹出的「通过 JSON 导入」对话框中，将复制的 JSON 配置粘贴到输入框。
3. 点击 **导入**。

**如果复制的是 Streamable Http URL：**

1. 点击 **+ 添加** → **手动填写配置**。
2. 在弹出的「添加 MCP 服务器」对话框中，填写以下内容：
   * **服务器类型**：选择 **Streamable HTTP**。
   * **服务器名称**：输入一个易于辨识的名称，如 `钉钉文档`。
   * **服务器地址**：粘贴复制的 URL 链接。
   * **Headers**：钉钉 MCP 一般无需额外配置，留空即可。
3. 点击 **添加**。

添加完成后，该服务会出现在「**连接器**」页面的「**已安装**」 → **自定义** 中。如果服务名称左侧显示绿色圆点，说明连接成功。可以展开查看该服务提供的工具列表。

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

在 QoderWork 对话中直接尝试使用该服务，验证是否正常工作：

* 接入了「钉钉文档」→ 试试说："帮我找一下名为 XX 的文档"
* 接入了「高德地图」→ 试试说："帮我查一下北京的天气"
* 接入了「钉钉日历」→ 试试说："帮我创建一个明天上午 10 点的日程"

如果 QoderWork 正常调用 MCP 服务并返回结果，说明接入成功。

## 下一步

<CardGroup cols={2}>
  <Card title="连接器" icon="plug" href="/zh/qoderwork/connectors">
    连接浏览器、日历、Microsoft 365、钉钉等外部系统
  </Card>

  <Card title="技能" icon="wand-magic-sparkles" href="/zh/qoderwork/skills">
    通过技能扩展 QoderWork 的能力
  </Card>
</CardGroup>