用途
ClawdCall MCP Server 旨在让 AI 智能体通过 Model Context Protocol（MCP）访问 ClawdCall 面向智能体的电话执行 API。其公开的工作流限定为：发送注册 OTP、验证注册 OTP、发起预期外呼、获取通话记录。
主要能力
该服务器暴露以下 ClawdCall 面向智能体的接口：
- POST /cc/signup/send-otp
- POST /cc/signup/verify-otp
- POST /external/v1/agent/outbound?conversionFlag=1
- GET /cc/v1/calls/{id}/transcript
支持的流程包括：发送注册 OTP、验证注册 OTP、发起预期外呼、获取通话记录。远程 MCP 客户端可连接到 Streamable HTTP 端点，该端点会公布 OAuth 受保护资源元数据；现有 ClawdCall 集成也可以根据智能体文档使用 API 密钥。另有本地 Stdio 包可通过 npm 安装到本地 MCP 客户端。
使用方式
本地 Stdio 包：将已发布的 npm 包添加到本地 MCP 客户端。 环境变量：CLAWDCALL_API_KEY 是外呼和获取通话记录所必需的；注册 OTP 工具不需要已有密钥。若要路由到暂存或自托管 API，可使用相应环境变量。
安全首次测试步骤（官方提供）：
- 打开 ClawdCall 智能体设置。
- 从兼容的智能体客户端连接托管端点或本地包。
- 要求智能体用有界任务呼叫你本人或预期的内部接收者。
- 在允许通话前确认目的地和任务。
- 查看返回的状态、通话记录证据、摘要或结构化结果。
复制粘贴示例：examples 目录包含有界首次呼叫工作流，适用于 OpenAI Agents SDK、LangGraph 支持的智能体、签名 webhook 到呼叫告警、航班变更决策交接。代码示例将接收者放在操作员控制的环境变量中；智能体生成的输入无法更改电话号码，实际生效的操作需要明确批准或选择加入。
发现元数据：server.json 包含 Official MCP Registry 元数据。另有智能体可读文档和 OpenAPI 描述。
适用场景
适合在用户同意前提下发起预期外呼，并检索通话记录、摘要和结果的场景，例如内部任务交接或航班变更决策交接等有界呼叫流程。
限制
ClawdCall 不适用于冷呼叫、机器人呼叫、批量外联、紧急用途、政治外联或敏感建议工作流。在其 API 契约中尚未出现相关路由之前，不应为智能体、号码购买、短信、会话、语音或通用 webhook 添加 MCP 工具。
