CallNode

CallNode MCP 服务

在你的 AI 助手中使用 CallNode 电话号码。

CallNode 在以下地址托管了一个 Model Context Protocol（MCP）服务：

https://mcp.callnode.io/mcp

从 claude.ai、Claude Desktop、ChatGPT、Claude Code、Cursor 或 VS Code 登录，然后勾选助手可以使用的号码。之后，它可以：

• 读取你的通话和消息记录；
• 发送短信和彩信；
• 按姓名呼叫或发送短信给电话簿联系人；
• 开启通话功能后，拨打由 CallNode 语音 Agent 接听的电话。

该服务由 CallNode 托管，因此无需安装或运行任何内容。此代码库仅包含连接信息：客户端配置、注册表条目和本 README。

• 它能做什么，简而言之： https://callnode.io/integrations/mcp
• 所有工具、权限、限制和错误代码： https://callnode.io/docs/mcp

连接前

1. 在 https://callnode.io/signup 创建账户（开始使用无需信用卡）并获取一个号码。自助开通的号码为美国和加拿大的本地号码及免费电话号码。
2. 打开 Dashboard → MCP Server，开启 MCP access，并勾选助手可以使用的号码。每个连接共用这份列表；未勾选的号码无法读取，也无法用于发送。

连接

你只需向客户端提供服务 URL。客户端会将你带到 CallNode 授权页面，你只需批准即可。不会创建令牌，也无需将任何机密信息粘贴到文件或 shell 中。

在授权页面上，你可以取消勾选权限（例如发送权限）、选择实时或测试连接，并设置每小时发送上限。之后，该连接会显示在 Dashboard → MCP Server 下，你可以随时在那里撤销连接。

claude.ai 和 Claude Desktop

1. 打开 Settings → Connectors，然后选择 Add custom connector。
2. 输入 https://mcp.callnode.io/mcp 作为服务 URL，然后继续。客户端 ID 和密钥字段留空。
3. Claude 会打开 CallNode 登录页面。按提示登录，查看号码和权限，然后批准。
4. 返回 Claude，在聊天中启用该连接器。

ChatGPT

1. 在 Settings → Connectors → Advanced 下启用 Developer mode，然后选择 Create。
2. 输入 https://mcp.callnode.io/mcp 作为 MCP 服务 URL，并选择 OAuth 作为身份验证方式。无需客户端 ID 或密钥，因为 ChatGPT 会自行注册。
3. 在 CallNode 登录页面上批准，然后将连接器添加到聊天中。

Claude Code

你可以在项目中使用此代码库中的 .mcp.json，也可以运行以下命令一次：

claude mcp add --transport http callnode https://mcp.callnode.io/mcp

在 Claude Code 中输入 /mcp，选择 callnode，然后选择 Authenticate。在浏览器中批准。

VS Code（Copilot Agent 模式）

1. 在工作区中保存 .vscode/mcp.json，然后启动 callnode 服务。VS Code 会打开 CallNode 授权页面；请批准。
2. 在 Copilot Chat 中选择 Agent 模式，并勾选 callnode 工具。

Cursor

1. 在项目中保存 .cursor/mcp.json，或将相同条目保存到 ~/.cursor/mcp.json，然后重新加载 Cursor。
2. 在 Settings → MCP 中，服务会显示 Needs login。点击它并在浏览器中批准。

无需浏览器登录

对于无法通过浏览器登录的自动化场景，请在控制面板中创建令牌连接。各客户端的代码片段见 https://callnode.io/docs/mcp#clients。

工具

每个工具都受你授予的权限控制。没有相应权限的连接完全看不到该工具。

工具	权限	功能
list_numbers	numbers:read	已启用的号码、各号码可执行的操作，以及是否有自己的语音 Agent。
get_number	numbers:read	一个已启用的号码。不包括 webhook 地址、路由或凭据。
list_calls	calls:read	已启用号码的通话记录，按时间从新到旧排列。不含通话转录。
get_call	calls:read	一条通话记录，包括通话结束方式。对于通过 MCP 发起的通话：包括摘要、结果和转录。
place_call	calls:place	发起通话。CallNode 语音 Agent 会根据你的指示执行通话，或由该号码自己的语音 webhook 执行。默认关闭。
list_messages	messages:read	已启用号码的 SMS/MMS 历史记录。
get_message	messages:read	一条消息及其投递状态。
send_message	messages:send	向号码或通过姓名查找的电话簿联系人发送文本或图片消息。
list_phone_book	phonebook:read	你的电话簿：你自己的线路及其标签。
add_phone_book_contact	phonebook:manage	准备一个条目并返回链接。只有你可以认证并保存该条目。
remove_phone_book_contact	phonebook:manage	移除一个电话簿条目。
get_balance	account:read	你的预付余额和自动充值设置。
get_updates	messages:read	自上次检查以来收到的新短信（以及连接有权读取通话时的通话），并可选择等待最多 20 秒。

send_message 和 place_call 被标记为会联系他人且无法撤销的操作（destructiveHint），因此支持工具提示的客户端会在执行前征求你的确认。

安全与限制

• 号码。 只有你勾选的号码才会显示，任何令牌都无法扩大此列表。
• 规则与 API 相同。 发送消息和拨打电话遵循与 CallNode API 相同的规则：
  • 遵守退订请求和 STOP 回复；
  • 短信和通话须在收件人当地时间上午 8 点至晚上 9 点之间进行，但你自己的已认证电话簿线路除外；
  • 发送号码必须已注册为可发送消息；
  • 通话需要通过企业验证，并受勿拨名单、目的地限制和并发通话上限约束；
  • 你的余额必须足以支付每次发送。
• 每个连接的限制：
  • 默认每小时发送 30 条，可设置为 1 至 200 条；
  • 60 秒内向同一收件人发送相同文本，只会发送一次；
  • 每小时拨打 10 次，同一主叫号码与被叫号码组合在 60 秒内绝不会重复拨打；
  • 每分钟调用 120 次工具。
• 语音 Agent 会表明自己是代表你的企业拨打电话的 AI 助手，绝不会声称自己是人类。它无法转接电话或收取银行卡信息。
• 不可信内容。 消息正文和来电者提供的文本会被标记为不可信内容并传递给助手，因此试图向助手发出指令的文本会被视为数据。
• 活动日志。 每次工具调用，无论获准还是拒绝，都会显示在仪表板的“最近活动”中。消息内容绝不会存储在那里。
• 撤销。 被撤销的连接在下次请求时会遭到拒绝。登录凭据在 90 天未重新登录后失效。
• 测试连接会执行所有规则，然后模拟发送消息或拨打电话。不会有任何内容离开平台，也不会产生费用。

定价

MCP 服务不收取费用。短信和通话费用按你的常规费率从预付余额中扣除；由 CallNode 语音 Agent 执行的通话还会按分钟收取语音费用。所有费率请见 https://callnode.io/pricing。

支持

• 帮助：[email protected]
• 安全问题报告：[email protected]
• 隐私：https://callnode.io/privacy
• 条款：https://callnode.io/terms
• 安全：https://callnode.io/security

此仓库中的文件

文件	用途
server.json	官方 MCP 注册表条目（io.callnode/mcp）
.mcp.json	Claude Code
.vscode/mcp.json	VS Code
.cursor/mcp.json	Cursor

这些文件根据 MIT 许可证发布。CallNode 服务本身受 CallNode 条款约束。