# 连接 AI 助手 (MCP)

<span data-t="appName">DM Champ</span> 提供了一个官方的 **MCP 服务器** —— 这是一个模型上下文协议（Model Context Protocol）端点，让像 **Claude Code**、**Claude Desktop**、**ChatGPT**、**Cursor** 以及您自己的应用程序这样的 AI 助手能够直接驱动您的 <span data-t="appName">DM Champ</span> 账户。用简单的语言提问（例如“列出我正在进行的活动”、“添加此潜在客户”、“本周 AI 花费了多少？”），助手就会为您调用 <span data-t="appName">DM Champ</span> API。
它与[API 部分](../api/getting-started.md)中记录的 v1 API 相同，使用您自己的 API 密钥进行身份验证。MCP 服务器为我们已发布 API 规范中的每个操作构建了一个工具，因此它涵盖了 v1 API 的大部分（而非全部）功能：联系人、消息、营销活动、AI 代理、知识库、预约、分析、标签、列表和子账户。广播、自动化和交易目前尚不可作为 MCP 工具使用——请直接使用 REST API 处理这些功能。在它所公开的范围内，没有针对单个工具的权限设置，也没有默认的只读模式，因此 API 密钥即是全部的访问控制权限。

- **端点：** `https://mcp.youraiconnector.com/mcp`
- **身份验证：** 您的 <span data-t="appName">DM Champ</span> API 密钥（作为 `X-API-Key` 请求头发送）
- **要求：** 拥有 API 访问权限的套餐。[创建 API 密钥 →](api-access.md#generating-your-api-key)
> 您的 API 密钥作用于**您自己的账户**，具有与 API 其他部分相同的权限——如果您使用的是代理计划（见下文），它还可以读取您管理的客户账户。请像对待密码一样妥善保管它。您可以随时在“设置”→“集成”→“API 密钥”中撤销它，这将立即切断助手的访问权限。

## Claude Code

```bash
claude mcp add --transport http dm-champ https://mcp.youraiconnector.com/mcp \
  --header "X-API-Key: YOUR_API_KEY"
```

然后在 Claude Code 中运行 `/mcp` 以确认它显示 **dm-champ ✓ 已连接**。

默认情况下，服务器以 **local**（本地）范围添加（仅限您本人，仅限当前项目）。
使用 `--scope user` 使其在您的所有项目中可用，或使用 `--scope
project` to commit it to a repo's `.mcp.json` 供您的团队使用：

```json
{
  "mcpServers": {
    "dm-champ": {
      "type": "http",
      "url": "https://mcp.youraiconnector.com/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}
```

## Claude Desktop

编辑您的 `claude_desktop_config.json`（设置 → 开发者 → 编辑配置）并
添加：

```json
{
  "mcpServers": {
    "dm-champ": {
      "type": "http",
      "url": "https://mcp.youraiconnector.com/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}
```

重启 Claude Desktop。<span data-t="appName">DM Champ</span> 工具将出现在工具菜单中。
## ChatGPT

自定义 MCP 连接器适用于 ChatGPT Business、Enterprise 和 Pro 版本。工作区所有者或管理员必须先在工作区设置中开启 **开发者模式 / 自定义连接器** —— 否则，创建连接器的选项将不会出现。

然后使用以下信息创建连接器：

- **URL：** `https://mcp.youraiconnector.com/mcp`
- **身份验证：** 自定义请求头
- **请求头名称：** `X-API-Key`
- **请求头值：** 您的 <span data-t="appName">DM Champ</span> API 密钥
URL 必须以 `/mcp` 结尾。只粘贴 `https://mcp.youraiconnector.com` 是最常见的错误——ChatGPT 会检查该确切地址，发现其中没有任何内容，并显示 **"Unable to add connector URL"**（无法添加连接器 URL）。

## Cursor 及其他 MCP 客户端

大多数支持 MCP 的编辑器都使用上述相同的 `.mcp.json` 形式（带有 `url` 和 `X-API-Key` 标头的 HTTP 服务器）。添加一个指向 `dm-champ` 的 `https://mcp.youraiconnector.com/mcp` 服务器，并在标头中粘贴您的 API 密钥。

## Claude API（构建到您自己的应用程序中）

您可以通过 Claude API 的 MCP 连接器以编程方式连接此 MCP 服务器，这样您构建的代理（Agent）无需单独的客户端即可使用 <span data-t="appName">DM Champ</span> 工具：
```json
{
  "model": "claude-opus-4-8",
  "messages": [{ "role": "user", "content": "List my live campaigns" }],
  "mcp_servers": [
    {
      "type": "url",
      "name": "dm-champ",
      "url": "https://mcp.youraiconnector.com/mcp",
      "authorization_token": "YOUR_API_KEY"
    }
  ]
}
```

## 您可以做什么

在 MCP 服务器公开的 v1 API 部分中，助手会自动选择正确的工具：

- **营销活动：** 列出、创建、更新、暂停/恢复、检查机器人配置。
- **联系人：** 搜索、创建、标记、添加到列表、导入。
- **知识库 / 常见问题解答：** 添加、编辑、批量导入、批准 AI 建议。
- **消息：** 阅读对话、向联系人发送消息。
- **预约：** 列出、预订、取消。
- **任务：** 创建、完成、列出。
- **分析：** 消息统计、额度使用情况、AI 成本。
- **渠道：** 检查连接状态、启动连接流程。

## 询问有关您客户账户的信息（代理商）

一个连接即可覆盖您管理的所有账户。您无需为每个客户添加第二个连接：在代理计划中，助手可以读取您名下的任何客户账户，因此您可以在一次对话中询问所有客户的相关信息。

只需说出客户名称即可：

- “Bella's Bistro 有多少联系人？”
- “本周我每个客户的 AI 使用成本是多少？”
- “Northside Dental 有哪些正在进行的营销活动，他们的渠道状态如何？”

这涵盖了读取联系人、消息、聊天记录、营销活动、预约、任务、标签、事件、常见问题解答、知识库来源、电话号码、渠道、Webhook 和分析数据。在执行任何操作之前，我们会核实该账户确实属于您——如果请求的账户不存在，系统会返回“未找到”。如果不指定客户，助手将像往常一样读取您自己的账户。

**更改客户账户**的权限较为有限。设置 AI 智能体、自定义函数、WhatsApp 模板、入口点、渠道连接、营销活动状态以及购买号码等操作均适用于指定的客户；大多数其他写入操作仍会在您自己的账户下运行，因此请使用该客户自己的密钥或通过 [REST API](../agency/api-for-agencies.md) 执行这些操作，后者涵盖的范围更广。

对于**在同一个登录名下经营多家企业**的客户，这也是解决方案。为每家企业创建一个独立的账户，然后邀请该客户的电子邮件作为所有账户的团队成员：他们只需登录一次，即可通过侧边栏的账户选择器在不同品牌之间切换。

## 为您的助手提供帮助文档

MCP 服务器为助手提供了您的 **账户**；它并未提供此文档。如果您还希望它能正确回答“我该如何……”这类问题，请将其指向 `https://docs.dmchamp.com/llms.txt`（包含每个帮助页面的索引及其 Markdown 版本链接）或 `https://docs.dmchamp.com/llms-full.txt`（包含整个文档的单个 Markdown 文件）。两者均为公开，无需密钥，且会随文档的每次更改而重新构建。请参阅 [以 Markdown 格式阅读这些文档](../api/getting-started.md#reading-these-docs-as-markdown)。

## 查找或生成您的 API 密钥

此连接使用的 API 密钥位于 **Settings → Integrations → API Key**（设置 → 集成 → API 密钥）——这是一个独立的版块，与 Webhooks 分开。请参阅 [API Access](api-access.md#generating-your-api-key) 获取具体步骤。

## 故障排除

- **"Unable to add connector URL" (ChatGPT) / "connection refused"**（无法添加连接器 URL / 连接被拒绝）——地址末尾缺少 `/mcp`。请使用 `https://mcp.youraiconnector.com/mcp`，不要使用 `https://mcp.youraiconnector.com`。
- **`Needs authentication` / 401** ——您的 API 密钥缺失或错误。请使用有效的 `X-API-Key` 重新添加服务器。
- **工具返回 `403`** ——您的套餐或团队角色不允许执行该操作；MCP 服务器本身不强制执行额外限制，它与 API 执行相同的权限检查。
- **Tool not found**（未找到工具）——工具列表是根据 API 实时生成的，因此它始终与当前版本匹配；请重新连接以刷新。
- **您自己的域名出现安全或证书警告** ——仅将 DNS 记录指向我们是不够的：子域名还必须在仪表板中进行验证，才能提供安全连接。白标代理机构可以通过 **Settings → White Labeling**（设置 → 白标）下的 **Custom domain**（自定义域名）卡片，将 MCP 地址放置在他们自己的域名（例如 `mcp.youragency.com`）上——请先在您的注册商处添加 CNAME，然后在 **MCP domain (AI assistants)**（MCP 域名（AI 助手））模块中输入主机名并点击 **Verify**（验证），流程与您的其他品牌子域名相同。在验证完成之前，请使用上述标准地址——它是无品牌的，因此可以安全地与客户共享。

---

## 后续步骤

- [API Access](api-access.md) ——生成或轮换此连接使用的密钥。
- [Webhooks](webhooks.md) ——此基于拉取的 MCP 连接的基于推送的对应功能。