---
title: "使用 Claude Code、Codex 或 Cursor 建置"
description: "安裝 ThunderPhone Agent Skills、連接 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-Hant/guides/thunderphone-mcp-server)。