Relay

Relay MCP server

面向 Relay 的远程 Model Context Protocol 服务。Relay 是一款为团队打造的商务电话和短信应用，创立于蒙特利尔。

它让 Claude 或任何 MCP 客户端都能处理团队电话：列出通话和短信、读取通话转录、搜索和更新联系人、使用团队号码发送短信，以及起草呼叫路由流程。

端点	https://api.yesrelay.com/api/mcp
传输方式	Streamable HTTP（规范版本 2025-06-18），无状态
身份验证	Authorization: Bearer <Relay API key>
工具	16
方案	所有方案，包括免费方案
文档	https://yesrelay.com/en/api-docs

此仓库不包含服务端代码：服务由 Relay 托管。无需在服务端安装任何内容。

获取 API 密钥

1. 在 https://app.yesrelay.com 创建免费账号。
2. 在应用中打开 Administration，然后选择 Integrations & API，并创建密钥。
3. 密钥以 rk_live_ 开头，且只会显示一次。请将其保存在密钥管理器中。

在应用中撤销密钥后，MCP 和 REST 访问权限会立即同时失效。

连接客户端

Claude Code

claude mcp add --transport http relay https://api.yesrelay.com/api/mcp \
  --header "Authorization: Bearer rk_live_..."

Claude Desktop

通过 mcp-remote 配置 claude_desktop_config.json：

{
  "mcpServers": {
    "relay": {
      "command": "npx",
      "args": ["mcp-remote", "https://api.yesrelay.com/api/mcp",
               "--header", "Authorization:${AUTH}"],
      "env": { "AUTH": "Bearer rk_live_..." }
    }
  }
}

其他客户端

将其指向 https://api.yesrelay.com/api/mcp，并添加上述 Authorization 标头。

工具

通话和消息

工具	功能
relay_list_numbers	列出组织的团队及其电话号码
relay_list_calls	列出团队的近期通话，按时间从新到旧排序
relay_get_transcript	获取通话转录，以及 AI 摘要和待办事项
relay_list_messages	列出团队的近期短信，按时间从新到旧排序，可按联系人筛选
relay_send_sms	使用团队号码发送短信。会实际发送、计费且无法撤回

联系人和团队

工具	功能
relay_search_contacts	按名字、姓氏或公司搜索团队通讯录
relay_create_contact	向团队通讯录添加联系人
relay_update_contact	替换现有联系人的字段
relay_list_members	列出组织中的人员及其标识符

Flow（呼叫路由，适用于 Business 和 Scale 方案）

工具	功能
relay_list_flows	列出组织的呼叫流程
relay_get_flow	读取流程的实时图和草稿
relay_flow_schema	区块类型、预期字段和路由引擎规则
relay_create_flow	根据模板创建号码的流程
relay_save_flow_draft	替换草稿，不会改变来电者听到的内容
relay_check_flow	测试图，不会写入任何内容
relay_discard_flow_draft	丢弃草稿并恢复为当前实时版本

没有任何工具可以发布流程。Agent 可以起草并检查呼叫路径；由人员在应用中将其设为实时版本。

安全措施

通过 MCP 发送的短信会经过与在应用中发送的短信相同的检查：

拒绝代码	触发条件
recipient_opted_out	收件人曾向此团队回复 STOP（或 ARRET、UNSUBSCRIBE）
daily_limit_reached	已达到团队每日上限（客户自行设定的上限或自动设置的上限）
workspace_budget_reached	已达到团队支出上限
sending_suspended	断路器已暂停外发；接收功能仍会继续

可执行的操作也取决于你的方案：发送短信需要付费方案，Flow 工具需要 Business 或 Scale 方案。

限制

方案	每个密钥每分钟的请求数	密钥数量
Free	30	2
Paid	120	5

JSON-RPC 批次中的每条消息都计为一个请求。

故障排除

客户端显示读取错误，或 curl 报错 56（“chunk hex-length”）。 某些会检查 HTTPS 流量的防病毒软件会损坏 MCP 响应；我们发现 Avast 会出现这种情况。服务端的响应正常。请在防病毒软件的 HTTPS 扫描中排除 api.yesrelay.com，然后重试。

401 Invalid API key。 密钥缺失、已撤销或已过期。请在应用中创建新密钥。

另有以下服务

• REST API：https://api.yesrelay.com/api/v1，参考文档见 https://api.yesrelay.com/docs
• 用于通话和短信事件的签名 Webhook（HMAC SHA-256）

支持

[email protected]