---
title: "Claude Code、Codex、Cursorで構築"
description: "ThunderPhone Agent Skillsをインストールし、ThunderPhone MCPサーバーに接続して、コーディングエージェントに最新の製品ドキュメントを提供します。"
---

ThunderPhone は、コーディングエージェント向けに 3 つのレイヤーを提供します。

| レイヤー | エージェントに提供するもの |
| --- | --- |
| [Agent Skills](https://github.com/thunderphone/skills) | エージェント、プロンプト、番号、通話、ツール、ウェブフック、ナレッジ、テスト、キャンペーン、ウィジェット、リアルタイムフレームワーク、移行に対応した集中的な手順。 |
| MCP | 認証済みツールは、提供開始に応じてエージェント、番号、通話、テスト、ナレッジ、ツール/ウェブフック、キャンペーン、音声、インポート、ドキュメントをカバーします。現在のカタログは `tools/list` を呼び出して確認してください。 |
| [生ドキュメント](https://thunderphone.com/docs/llms.txt) | 製品の動作と API の詳細に関する最新の Markdown ソース。 |

Skills は作業の進め方を説明します。MCP を使用すると、コーディングエージェントが組織を確認し、操作できます。生ドキュメントは、読み込まれた Skill の対象外となる質問のためのソース資料を提供します。

## プロジェクトにインストールする

このブロックは Skills をインストールし、現在のシェルでキーを使用可能にして、プロジェクトスコープの 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. 検証済みの診療所情報、対応タスク、エスカレーションルール、必要な2つのロケールを渡します。音声やロケールを推測で作成せず、利用可能な音声カタログと対応言語を確認させます。
3. 一般原則と事実に基づく、本番用プロンプトを1つ作成するよう依頼します。エージェントは発信者が対応可能な言語に切り替え、発話を簡潔に保ち、一度に1つの質問をし、発信者の応答を決め打ちしたスクリプトを避ける必要があります。
4. 範囲を限定した予約ツールを定義し、受付担当者に必要なナレッジのみを追加させます。デプロイ前に、ツールの成功、空き枠なし、無効な入力、タイムアウト、人間への引き継ぎをテストします。
5. 両方の言語、割り込み、訂正、不足情報、ナレッジに関する質問、予約失敗、エスカレーションのシナリオを生成します。実行後、トランスクリプトとツールの証跡を確認し、最小限の一般ルールを修正して、同じセットを再実行します。
6. 正確なドラフトとテストの証跡を確認し、デプロイと電話番号の接続を明示的に承認します。実際のトラフィックに移行する前に、各言語で制御された音声通話を発信します。

型付きRESTリクエストには [PythonまたはTypeScript SDK](/api-reference/sdks) を使用します。

ビルドで決定論的なペイロード、バージョン管理されたフィクスチャ、一括オーケストレーション、または現在のMCPツール一覧にない操作が必要な場合は、MCPではなくRESTを使用します。APIは `https://api.thunderphone.com/v1` から開始します。[APIの概要](/api-reference/introduction) と
[MCPガイド](/ja/guides/thunderphone-mcp-server) を参照してください。