使用 Claude Code、Codex 或 Cursor 构建

安装 ThunderPhone 智能体技能，连接 ThunderPhone MCP 服务器，并为编程智能体提供最新的产品文档。

ThunderPhone 为编程智能体提供三层支持：

技能说明如何完成工作。MCP 允许编程智能体检查并操作您的组织。原始文档为已加载技能之外的问题提供源材料。

在项目中安装#

此代码块会安装技能，使密钥可供当前 shell 使用，并将项目范围的 MCP 服务器添加到 Claude Code。请从您的密钥管理器中读取真实值以替换占位符；不要将密钥粘贴到代码仓库或聊天中。

npx skills add thunderphone/skills
export THUNDERPHONE_API_KEY='replace-with-value-from-your-secret-manager'
claude mcp add --transport http --scope project \
  --header 'Authorization: Bearer ${THUNDERPHONE_API_KEY}' \
  thunderphone https://api.thunderphone.com/v1/mcp

对于 Codex，请将最后一条命令替换为：

codex mcp add thunderphone \
  --url https://api.thunderphone.com/v1/mcp \
  --bearer-token-env-var THUNDERPHONE_API_KEY

Cursor 从 .cursor/mcp.json 读取项目配置：

{
  "mcpServers": {
    "thunderphone": {
      "type": "http",
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
      }
    }
  }
}

VS Code 在 .vscode/mcp.json 中的 servers 键下使用同一服务器：

{
  "servers": {
    "thunderphone": {
      "type": "http",
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${env:THUNDERPHONE_API_KEY}"
      }
    }
  }
}

示例会话：双语牙科接待员#

1. 要求编码智能体加载 create-agent、 thunderphone-prompt-builder、build-tool-integration、add-knowledge 和 test-agent。告知它先制定计划，暂时不要创建资源。
2. 向其提供经过验证的诊所事实、支持的任务、升级规则以及所需的两种语言区域设置。要求它检查实时语音目录和支持的语言，而不是自行编造语音或区域设置。
3. 要求它根据通用原则和事实构建一个生产环境提示词。该智能体应切换为来电者支持的语言，保持简洁表达，一次只提一个问题，并避免使用来电者回应脚本。
4. 要求它定义一个范围明确的预约工具，并且仅附加接待员所需的知识。在部署前测试工具成功、无可用时段、无效输入、超时和人工转接。
5. 为两种语言、打断、更正、缺失信息、知识问题、预约失败和升级生成场景。运行这些场景，检查转录内容和工具证据，修复最小范围的通用规则，然后重新运行同一组场景。
6. 审核确切草稿和测试证据，然后明确授权部署和号码绑定。在迁移真实流量之前，分别使用每种语言进行一次受控音频通话。

使用 Python 或 TypeScript SDK 发出带类型的 REST 请求。

当构建需要确定性负载、版本化测试夹具、批量编排，或需要执行当前 MCP 工具列表中不存在的操作时，请使用 REST 而不是 MCP。API 起始地址为 https://api.thunderphone.com/v1；请参阅 API 简介 和 MCP 指南。