将 Ringhum 连接到 Claude 及其他 AI 工具（MCP）

Ringhum 提供一个 MCP 服务器。MCP（模型上下文协议）是 AI 应用使用外部工具的一种标准方式。将 Ringhum 连接到 Claude 或 ChatGPT 等 AI 应用后，您就可以用自然语言询问工作区相关问题。例如："总结昨天未接的来电"、"本周有哪些来电者要求回电？"或"将我们的新营业时间添加到常见问题中"。AI 应用遵循与 Ringhum API 相同的规则和权限。

您需要准备

• 服务器网址： https://ringhum.com/mcp，也可以在开发者页面的 MCP 服务器卡片中找到，并带有复制按钮。
• 一个支持远程 MCP 服务器的 AI 应用，例如 Claude、ChatGPT、Claude Code、Cursor、Windsurf 或 VS Code。
• 工作区中的所有者或管理员角色。只有所有者和管理员可以连接应用或创建 API 密钥。

有两种连接方式。登录方式最简单，适合 Claude 和 ChatGPT 等聊天应用；API 密钥适合需要输入网址和请求头的开发者工具。

只读或读写权限

您可以决定 AI 应用能执行的操作范围。

在只读权限下，会更改内容的工具根本不会提供给该应用。

重要： 授予修改权限后，AI 应用可以向您的客户发送真实消息和拨打真实电话。Ringhum 会将这些工具标记为会影响工作区之外的内容，并将删除操作标记为破坏性操作，因此大多数 AI 应用会在执行前请求您的确认。请在批准之前仔细查看该应用即将执行的操作。

通过登录方式连接 Claude

1. 在 Claude 中（网页版、桌面版或移动端），打开设置 → 连接器，选择添加自定义连接器。
2. 粘贴网址 https://ringhum.com/mcp 并保存。
3. 点击连接，系统会打开一个 Ringhum 页面，如提示请登录。
4. 在连接页面，选择该应用可使用的工作区。
5. 在可执行的操作下，选择仅查询或查询并修改。
6. 点击允许，随后您会返回 Claude。

该应用永远不会看到您的密码。Claude 中的具体菜单名称可能会随时间变化，请在其设置中查找"连接器"或"集成"。

ChatGPT： 在设置 → 应用与连接器中将该网址添加为自定义连接器（MCP 服务器），然后点击连接并按照步骤 3 至 6 操作。

Claude Code： 运行以下命令，然后运行 /mcp 并选择身份验证。

claude mcp add --transport http ringhum https://ringhum.com/mcp

授权后，只要您持续使用该连接，它就会自动续期。如果 90 天内未使用该应用，则需要重新连接。

使用 API 密钥连接

适用于允许设置请求头的工具，或您不想登录的情况。

1. 在开发者页面创建一个 API 密钥，只读连接只需勾选读取，需要修改权限则同时勾选读取和写入。参见 API 密钥与权限范围。
2. 在您的应用中添加该服务器，并将密钥放入 Authorization 请求头。

Claude Code：

claude mcp add --transport http ringhum https://ringhum.com/mcp \
  --header "Authorization: Bearer ck_live_…"

Cursor（~/.cursor/mcp.json）、Windsurf 和 Claude Desktop：

{
  "mcpServers": {
    "ringhum": {
      "url": "https://ringhum.com/mcp",
      "headers": { "Authorization": "Bearer ck_live_…" }
    }
  }
}

VS Code（.vscode/mcp.json）：

{
  "servers": {
    "ringhum": {
      "type": "http",
      "url": "https://ringhum.com/mcp",
      "headers": { "Authorization": "Bearer ck_live_…" }
    }
  }
}

只能运行本地服务器的应用可以通过 npx mcp-remote https://ringhum.com/mcp --header "Authorization: Bearer ck_live_…" 连接。

工具涵盖的范围

Ringhum API 中的每个操作都作为一个工具提供：您的账户和用量、助手、电话号码、通话和转录、联系人、预约和空闲情况、订单和商品、客房预订、收件箱、短信和 WhatsApp 消息、营销活动、webhook、公司资料、服务项目、常见问题和知识库、未能回答的问题、付款链接、评价邀请、收入和垃圾电话防护。唯一的例外是通话录音，它不作为工具提供。

每个工具都会执行对应的 API 请求，因此同样受到相应的方案限额、校验规则和速率限制约束。工具调用同样计入 API 每分钟 120 次请求的限额。完整的工具列表见 /docs 中 API 参考文档的 MCP 部分。

查看和断开已连接的应用

通过登录方式连接的应用会列在开发者页面的已连接的 AI 应用下，显示连接者、其访问权限（仅读取或读取并修改）以及最近使用时间。

要移除某个应用，点击断开连接并确认，它会立即失去访问权限，需要重新批准才能再次使用。要更改应用的访问权限，请先断开连接，再以另一种权限重新连接。

对于使用 API 密钥建立的连接，请在 API 密钥下撤销该密钥。

故障排查

"只有工作区的所有者和管理员可以连接应用。" 请让工作区所有者连接该应用，或将您设为管理员。参见邀请您的团队。

"登录请求已过期，请从您的 AI 应用重新开始连接。" 授权页面打开时间过长，请从 AI 应用重新开始。

应用提示未获授权，或要求您重新登录。 该应用已断开连接、密钥已被撤销，或您已不再是该工作区的成员，请重新连接。

应用无法执行修改操作。 该连接使用的是只读权限，或其 API 密钥缺少写入权限。

应用查看的是错误的工作区。 让它调用 who_am_i 进行检查。每个连接只使用一个工作区，请断开连接并重新连接以选择另一个工作区。