使用 Claude Code、Codex 或 Cursor 建置

安裝 ThunderPhone Agent Skills、連接 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 指南。