连接 AI 助手 (MCP)

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

端点： https://mcp.youraiconnector.com/mcp
身份验证： 您的 DM Champ API 密钥（作为 X-API-Key 请求头发送）
要求： 拥有 API 访问权限的套餐。创建 API 密钥 →

您的 API 密钥作用于您自己的账户，具有与 API 其他部分相同的权限——如果您使用的是代理计划（见下文），它还可以读取您管理的客户账户。请像对待密码一样妥善保管它。您可以随时在“设置”→“集成”→“API 密钥”中撤销它，这将立即切断助手的访问权限。

Claude Code

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 供您的团队使用：

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

Claude Desktop

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

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

重启 Claude Desktop。DM Champ 工具将出现在工具菜单中。

ChatGPT

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

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

URL： https://mcp.youraiconnector.com/mcp
身份验证： 自定义请求头
请求头名称： X-API-Key
请求头值： 您的 DM Champ 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）无需单独的客户端即可使用 DM Champ 工具：

{
  "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 执行这些操作，后者涵盖的范围更广。

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

为您的助手提供帮助文档

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

查找或生成您的 API 密钥

此连接使用的 API 密钥位于 Settings → Integrations → API Key（设置 → 集成 → API 密钥）——这是一个独立的版块，与 Webhooks 分开。请参阅 API Access 获取具体步骤。

故障排除

“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 ——生成或轮换此连接使用的密钥。
Webhooks ——此基于拉取的 MCP 连接的基于推送的对应功能。

连接 AI 助手 (MCP) #

Claude Code #

Claude Desktop #

ChatGPT #

Cursor 及其他 MCP 客户端 #

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

您可以做什么 #

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

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

查找或生成您的 API 密钥 #

故障排除 #

后续步骤 #