View as Markdown
Open in
使用 Claude Code、Codex 或 Cursor 進行開發
安裝 ThunderPhone Agent Skills、連接 ThunderPhone MCP 伺服器,並為編碼智能體提供最新產品文件。
ThunderPhone 為編碼智能體提供三個層次:
| 層次 | 為智能體提供的功能 |
|---|---|
| Agent Skills | 涵蓋智能體、提示、電話號碼、通話、工具、webhook、知識庫、測試、活動、小工具、即時框架及遷移的專門程序。 |
| MCP | 已驗證的工具涵蓋智能體、電話號碼、通話、測試、知識庫、工具/webhook、活動、語音、匯入及文件,並會隨推出逐步增加;呼叫 tools/list 取得即時目錄。 |
| 原始文件 | 提供產品行為及 API 詳情的最新 Markdown 原始檔。 |
Skills 說明如何完成工作。MCP 讓編碼智能體檢查並操作你的組織。原始文件則為已載入 Skill 以外的問題提供參考資料。
在專案中安裝
此區塊會安裝 Skills、讓目前 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_KEYCursor 會從 .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}"
}
}
}
}範例工作階段:雙語牙科診所接待員
- 要求編程智能體載入
create-agent、thunderphone-prompt-builder、build-tool-integration、add-knowledge及test-agent。指示它先制定計劃,暫時不要建立資源。 - 向它提供已核實的診所資料、支援的任務、升級處理規則及兩種所需語言地區設定。要求它檢查即時語音目錄及支援語言,而非自行虛構語音或語言地區設定。
- 要求它根據通用原則及資料建立一個正式環境提示。智能體應切換至來電者支援的語言、保持簡潔語音、每次只問一條問題,並避免預設來電者回應的腳本。
- 要求它定義一個範圍明確的預約工具,並只附加接待員所需的知識。部署前測試工具成功、沒有可用時段、無效輸入、逾時及轉交真人處理。
- 為兩種語言、打斷、修正、資料缺失、知識問題、預約失敗及升級處理產生情境。執行測試、檢查逐字稿及工具證據、修正最小範圍的通用規則,然後重新執行同一組測試。
- 檢閱確切草稿及測試證據,然後明確授權部署及附加電話號碼。轉移真實流量前,以每種語言進行一次受控音訊通話。
使用 Python 或 TypeScript SDK 提交具類型的 REST 請求。
當建立工作需要可預測的負載、版本化測試資料、大量編排,或需要目前 MCP 工具清單未提供的操作時,請使用 REST 而非 MCP。API 起點為 https://api.thunderphone.com/v1;請參閱
API 簡介 及
MCP 指南。