ChatRail

ChatRail MCP 服务

通过 Claude、Cursor、VS Code 以及任何其他 Model Context Protocol 客户端操作 ChatRail 工作区。无需离开编辑器，即可检查 WhatsApp 连接的健康状况、查找群组、追踪消息发送失败的原因、管理定时消息以及重放 webhook 投递。

ChatRail 是面向开发者的 WhatsApp API：通过 HTTP 使用你已有的号码收发 WhatsApp 消息。完整参考文档请参阅 MCP 文档。

从设计上保护隐私

• 任何工具都不会返回消息正文、收件人电话号码或凭据。
• 更改状态的工具会先返回预览，只有再次调用并传入 confirm: true 时才会应用更改。
• 每次调用都限定在一个工作区内，并记录在其审计日志中。

两种连接方式

1. 使用 OAuth 的托管服务（推荐）

将支持远程 MCP 服务的任意客户端指向：

https://www.chatrail.dev/v1/mcp

客户端会打开一个浏览器窗口，由工作区所有者、管理员或开发者批准访问。 无需安装任何内容，也无需复制密钥。

Claude Code

claude mcp add --transport http chatrail https://www.chatrail.dev/v1/mcp

Cursor（~/.cursor/mcp.json）

{
  "mcpServers": {
    "chatrail": { "url": "https://www.chatrail.dev/v1/mcp" }
  }
}

VS Code（.vscode/mcp.json）

{
  "servers": {
    "chatrail": { "type": "http", "url": "https://www.chatrail.dev/v1/mcp" }
  }
}

2. 使用 API 密钥的本地 stdio 服务

适用于只能运行本地服务的客户端，或你更愿意使用 API 密钥的情况。此软件包会在你的计算机上运行，并将请求转发到托管服务。

1. 在 ChatRail 控制面板中，创建具有 mcp:read 作用域的工作区 API 密钥。如果助手需要重新安排、取消、添加反应或重放，请添加 mcp:write。
2. 将服务添加到你的客户端。

Claude Desktop（claude_desktop_config.json）

{
  "mcpServers": {
    "chatrail": {
      "command": "npx",
      "args": ["-y", "chatrail-mcp"],
      "env": { "CHATRAIL_API_KEY": "cr_live_..." }
    }
  }
}

该软件包以 chatrail-mcp 的名称发布在 npm 上，因此 npx 会从 注册表获取它。如果你需要尚未发布的版本，可以直接从 代码库运行：

"args": ["-y", "github:chatrail/chatrail_mcp"]

Docker

docker build -t chatrail-mcp .
docker run -i --rm -e CHATRAIL_API_KEY=cr_live_... chatrail-mcp

变量	必需	说明
CHATRAIL_API_KEY	调用工具时必需	具有 mcp:read（以及可选的 mcp:write）权限的工作区 API 密钥。
CHATRAIL_MCP_URL	否	覆盖端点。默认值为 https://www.chatrail.dev/v1/mcp。

即使没有密钥，服务仍会启动并列出其工具，因此你可以在注册前查看。

工具

工具	作用域	功能
list_connections	读取	工作区中的所有 WhatsApp 连接及其状态和健康状况。
get_connection	读取	单个连接的状态、健康状况和近期状态历史记录。
list_whatsapp_groups	读取	已连接号码可见的群组，包括 ID 和参与者数量。
get_whatsapp_group	读取	单个群组的名称、描述、设置和成员数量。
list_messages	读取	近期消息及其投递状态。
get_message	读取	单条消息及其投递时间线。
explain_message_failure	读取	对消息发送失败原因的结构化说明。
list_scheduled_messages	读取	等待发送的消息，按发送时间从近到远排列。
list_webhook_deliveries	读取	近期 webhook 投递及其结果。
reschedule_message	写入	更改定时消息的发送时间。先预览。
cancel_scheduled_message	写入	取消尚未发送的消息。先预览。
react_to_message	写入	设置或移除消息上的表情反应。先预览。
replay_webhook	写入	重新排队投递失败或跳过的 webhook。先预览。

套餐

ChatRail Core + AI 和 Team 套餐包含 MCP 访问权限。请参阅 价格。

开发

npm install
npm run build
CHATRAIL_API_KEY=cr_test_... node dist/index.js

未配置 API 密钥时，提供的工具目录为 tools.json。它从托管服务导出，应在托管工具发生变化时更新。

Agent 技能

ChatRail 发布了一个技能文件，告知 Agent 何时使用 ChatRail、用户需要进行哪些设置、如何发送和接收，以及发送规则。此 MCP 服务管理工作区，无法发送消息，因此该技能指向用于发送消息的 REST API。

将这一行提供给你的 Agent：

Read https://www.chatrail.dev/SKILL.md and follow it to set up ChatRail.

或者使用 skills CLI 安装，该 CLI 可从 GitHub 仓库安装 Agent 技能：

npx skills add chatrail/chatrail_mcp

或者手动将其复制到 Claude Code：

mkdir -p ~/.claude/skills/chatrail
curl -fsSL https://www.chatrail.dev/SKILL.md -o ~/.claude/skills/chatrail/SKILL.md

规范文件位于 https://www.chatrail.dev/SKILL.md。此仓库中也有一份副本，位于 skills/chatrail/SKILL.md，以便从 GitHub 安装技能的工具能够找到它。

链接

• 网站：https://www.chatrail.dev
• MCP 文档：https://www.chatrail.dev/mcp
• API 参考：https://www.chatrail.dev/api-reference
• 身份验证：https://www.chatrail.dev/auth.md
• Agent 技能：https://www.chatrail.dev/SKILL.md

许可证

MIT