---
title: "使用 Claude Code、Codex 或 Cursor 构建"
description: "安装 ThunderPhone 智能体技能，连接 ThunderPhone MCP 服务器，并为编程智能体提供最新的产品文档。"
---

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

| 层级 | 为智能体提供的能力 |
| --- | --- |
| [智能体技能](https://github.com/thunderphone/skills) | 面向智能体、提示词、号码、通话、工具、Webhook、知识库、测试、营销活动、小组件、实时框架和迁移的专门操作流程。 |
| MCP | 经过身份验证的工具涵盖智能体、号码、通话、测试、知识库、工具/Webhook、营销活动、语音、导入和文档，并会随着功能陆续推出；调用 `tools/list` 获取实时目录。 |
| [原始文档](https://thunderphone.com/docs/llms.txt) | 有关产品行为和 API 详情的最新 Markdown 源文件。 |

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

## 在项目中安装

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

```bash
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，请将最后一条命令替换为：

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

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

```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` 键下使用同一服务器：

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

<Warning>
  组织 API 密钥可以读取组织数据并执行已启用的操作。请将其保存在密钥管理器中，将访问范围限定为目标项目，并在批准前审核会修改数据的工具调用。
</Warning>

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

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

使用 [Python 或 TypeScript SDK](/api-reference/sdks) 发出带类型的 REST 请求。

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