Blogs
/
Claude CodeとClaude Fable 5.2で音声エージェントを構築する方法

Claude CodeとClaude Fable 5.2で音声エージェントを構築する方法

Retell
AI Voice Agent Platform
Published 
November 17, 2026
9
 min read
Claude CodeとClaude Fable 5.2で音声エージェントを構築する方法
About this article
1つのコマンドでClaude CodeをRetell AIのMCPサーバーに接続し、Claude Fable 5.2にターミナルから電話エージェントの構築・テスト・レビューを任せる方法を解説します。
ブログ一覧へ戻る
See Retell AI in action
Start free
トップへ戻る

Claude Codeを使えば、ターミナルから実際に動作する電話エージェントを構築できます。1つのコマンドでRetell AIのMCPサーバーに接続し、作りたいエージェントを普段の言葉で説明するだけで、Claude CodeがRetell APIを通じてエージェントを作成し、テストケースを書き、通話をレビューします。本ガイドでは、Anthropicが2026年11月9日にリリースしたモデルClaude Fable 5.2を使ってこの一連のループを解説し、途中で手動承認すべきポイントも紹介します。

本ガイドはRetell AIが公開しており、使用するMCPサーバーもRetell自身のものです。

セットアップの全体像

構成要素は3つです。Claude Codeはターミナル上で動作し、作業を計画します。mcp.retellai.comにあるRetellのMCPサーバーが、Retell APIへのアクセスを提供します。Retellワークスペースには、APIが操作するエージェント、電話番号、テスト、通話履歴が格納されています。

MCPサーバーはAPIのendpointごとにツールを用意するのではなく、3つのツールのみを公開しているため、ツール一覧がモデルのコンテキストウィンドウに収まる程度にコンパクトに保たれます。Claude Codeはこれらを順番に使います。まず利用可能なendpointを一覧表示し、必要なendpointの入力スキーマを読み取り、それを呼び出します。スキーマにない引数が含まれている場合、サーバーはその引数名を示すエラーを返し、APIは呼び出しません。

Claude CodeがRetellワークスペースにアクセスする仕組みを示す図。左側はターミナル上のClaude Codeで、モデルClaude Fable 5.2を実行し、普段の言葉で書かれたリクエストを読み取り、必要なRetellのendpointを計画し、各呼び出しについて承認を求めます。Claude CodeはHTTP経由のMCPで、AuthorizationヘッダーにAPIキーを付けて、mcp.retellai.comのRetell MCPサーバーに接続します。このサーバーには順番に使われる3つのツールがあります。list_api_endpointsは作業に必要なendpointを見つけ、get_api_endpoint_schemaはそのendpointの入力スキーマを読み取り、invoke_api_endpointは引数をスキーマと照合したうえでRetell APIを呼び出します。Retell APIはRetellワークスペース内のエージェント、電話番号、ナレッジベース、音声、テスト、通話を操作します。エージェントが通話に応答する際は、Fable 5.2ではなくRetellのリストにあるモデルを使用します。
Claude Codeが作業を計画し、承認後にRetellのMCPサーバーが各API呼び出しを実行します。図:Retell AI(2026年11月)、RetellのMCPサーバードキュメントに基づく。

始める前に1点確認しておきましょう。Claude Fable 5.2は構築を担うモデルであり、電話で応答するモデルではありません。作成したエージェントはRetell独自のリストにあるモデルで通話に応答し、2026年11月10日時点でFable 5.2はそのリストに含まれていません(リストにはRetell独自のモデルTell-1も含まれています)。この役割分担については音声エージェント向けClaude Fable 5.2:適する場面と適さない場面で解説しています。

ClaudeでRetellエージェントを構築する3つの方法

MCPサーバーを使ったClaude Codeは、3つのルートのうちの1つです。それぞれ向いている人が異なります。

Claude Code + Retell MCPサーバーClaude内のRetell AIコネクタRetellダッシュボード
作業場所ターミナルまたはIDEWeb版ClaudeまたはClaude Desktopのチャットブラウザ
サインインリクエストヘッダー内のRetell APIキーOAuth経由のRetellログインRetellログイン
アクセス範囲キーで許可されたRetell APIのendpoint(非推奨のものを除く)チャット内ウィジェット付きの専用ツール52種(2026年10月時点)すべての設定
エージェントの種類APIがサポートするすべてシングルプロンプトエージェントのみすべて
最適な用途開発者、一括変更、スクリプト化・反復したい作業全般説明するだけで1つのエージェントを構築・編集会話フロー、インテグレーション、視覚的なレビュー

出典:RetellのMCPサーバードキュメントおよびClaudeコネクタドキュメント(2026年11月10日閲覧)。

Claude CodeをRetell MCPサーバーに接続する

Retellアカウント、Retell APIキー、そしてClaude Codeのインストールが必要です。RetellダッシュボードでAPIキーを作成し、この作業に必要な権限のみを付与してください。

ターミナルで次のコマンドを実行します。プレースホルダーはご自身のキーに置き換えてください:

claude mcp add --transport http retell https://mcp.retellai.com \
  --header "Authorization: Bearer <RETELL_API_KEY>"

Claude Codeを起動し、/mcpを実行してretellサーバーが接続されていることを確認します。次に/modelを実行し、プランに含まれていればClaude Fable 5.2を選択します。Claude Codeのドキュメントによると、Fable 5.2にはClaude Code v2.1.321以降が必要です。またAnthropicのリリース記事によれば、開発者はClaude Platform上でclaude-fable-5-2としてこのモデルを呼び出せます。

キーは会話に含めないでください。上記のコマンドまたはクライアントの設定に記述し、プロンプトには決して貼り付けないようにします。

エージェントを説明し、Claude Codeに作成させる

まずは読み取りから始めましょう。何かを変更する前に、接続が機能していることを確認できます:

Retellのエージェントを一覧表示し、それぞれの役割を要約してください。

次に、作りたいエージェントを説明します。担当業務、口調、絶対にしてはいけないこと、どのタイミングで人間に通話を引き継ぐかを具体的に伝えましょう:

Northside Dentalという歯科医院向けのシングルプロンプト音声エージェントを
作成してください。診療時間と保険に関する質問に答え、クリーニングの
予約を取り、請求に関する質問は受付(+14155550123)に転送します。
毎回の通話の冒頭で、AIアシスタントであることを伝えてください。
エージェントのモデルにはClaude 5.5 Sonnetを使用してください。
何かを作成する前に、プロンプトを見せてください。

Claude Codeはプロンプトの下書きを作成し、必要なendpointのスキーマを調べ、各API呼び出しについて承認を求めます。承認する前に、作成されたプロンプトを読んでください。ここでこそ高性能なモデルが真価を発揮します。プロンプトこそがエージェントそのものであり、曖昧なプロンプトからは曖昧な通話しか生まれません。

電話をかける前にテストケースを書く

Retellのシミュレーションテストは、AIがシミュレートする発信者とのテキスト会話でエージェントを実行し、設定した成功基準に照らして各実行を合格・不合格で評価します。シングルプロンプト、マルチプロンプト、会話フローのいずれのエージェントにも対応し、実際の電話はかけません。Claude Codeにテストスイートを書かせましょう:

Northside Dentalエージェント用のシミュレーションテストケースを8つ作成してください。
クリーニングを予約する新規患者、途中で話を遮って日付を2回変更する発信者、
転送が必要な請求に関する質問、本物の人間と話しているのか尋ねる発信者、
エージェントが断るべき医療アドバイスを求める人をカバーしてください。
それぞれに明確な成功基準を設定し、実行して失敗したものを見せてください。

保存したケースはリグレッションテストスイートになります。プロンプトを変更するたびに、その変更が発信者に届く前に再実行してください。

エージェントを電話番号に割り当て、自分の電話にかけてみる

シミュレーションはロジックを検証します。実際の通話では、音声、話すテンポ、割り込みへの対応を確認できます。Claude Codeに電話番号を一覧表示させ、エージェントをいずれかに割り当て、自分宛てに電話をかけさせましょう:

Retellの電話番号と、それぞれに割り当てられているエージェントを見せてください。
エージェントが割り当てられていない番号にNorthside Dentalエージェントを割り当て、
+14155550199に電話をかけさせてください。

注意点が3つあります。通話は実際の電話につながり、他の通話と同様に課金されるため、承認プロンプトで発信先の番号を確認してください。また、発信通話にはRetellアカウントでのKYCが必要です。さらに、すでにエージェントが割り当てられている番号の場合、そのエージェントを置き換えるとその番号に応答する相手が変わるため、事前に現在の設定を確認してください。

通話をレビューし、プロンプトを改訂する

何件か通話をしたら、Claude Codeに読み返させましょう:

Northside Dentalエージェントの直近20件の通話を取得してください。
うまく終わらなかった通話を原因別にグループ化し、それぞれ問題が起きた
ターンを引用して、プロンプトの変更案を提示してください。まだ何も変更しないでください。

同意できるプロンプトの変更を承認し、シミュレーションスイートを再実行して公開します。構築、テスト、通話、レビュー、改訂というこのループこそが作業のすべてであり、Claude Codeが最も時間を短縮できる部分です。

Claude CodeがRetellエージェントで実行する4段階のループを示す図。各段階にリクエスト例、Claude Codeの動作、確認事項を記載しています。1. エージェントの構築:Claude Codeがプロンプトを書いてエージェントを作成します。承認前にプロンプトを読みます。2. 電話なしでのテスト:評価付きのシミュレーションテストケースを作成し、テキスト会話として実行します。成功基準が重視する内容と一致しているか確認します。3. 自分の電話にかける:エージェントを番号に割り当てて電話をかけます。発信先の番号と、どのエージェントが置き換わるかを確認します。4. 通話のレビュー:通話と通話後分析を読み、変更案を作成します。同意できる変更のみ承認します。4段階目から1段階目へ点線の矢印が戻り、「プロンプトを改訂し、テストケースを再実行して公開」と記されています。
構築、テスト、通話、レビューのループと、各段階で行うべき確認。図:Retell AI(2026年11月)、RetellのMCPサーバーおよびシミュレーションテストのドキュメントに基づく。
依頼内容Claude CodeがMCPサーバーを通じて行うこと承認の要否
「エージェントを一覧表示して」エージェントとそのバージョンを読み取る低リスク、読み取りのみ
「〜するエージェントを作成して」プロンプトを書き、エージェントを作成する必要。まずプロンプトを読む
「テストケースを書いて実行して」シミュレーションテストケースを作成・実行し、失敗を報告する必要
「自分の番号に割り当てて」番号を一覧表示し、エージェントを割り当てる必要。どのエージェントが置き換わるか確認
「自分の電話にかけて」電話をかける必要。発信先の番号を確認
「最近の通話をレビューして」通話を一覧表示し、各通話の文字起こし、レイテンシ、通話後分析を読み取る低リスク。ただし文字起こしには個人データが含まれる場合あり
「古いエージェントを削除して」削除用のendpointを呼び出す必要。削除は取り消せないものとして扱う

有効にしておくべき承認

Claude CodeからのすべてのAPI呼び出しは、invoke_api_endpointという1つのツールを経由します。このツールを常に許可する設定にすると、削除や公開を含め、キーでアクセスできるすべてのendpointを許可することになります。Retellのドキュメントでは、各呼び出しを個別に承認し、endpointと引数を確認することを推奨しており、私たちもこの手順を省略することはおすすめしません。

  • 作業に必要な最小限の権限を持つキーを使用する。通話レビューには読み取り専用キーで十分です。
  • 書き込む前に読み取る。エージェントを更新・削除する前に、Claude Codeに現在のエージェントを取得させます。
  • 文字起こしは信頼できないテキストとして扱う。発信者は、モデルに向けた指示を含め、何でも話す可能性があります。通話レビューのセッションに、ご自身の確認なしでエージェントを変更できる承認を持たせないでください。
  • 可能な限り個人データを含めない。必要な場合を除き、文字起こし全文ではなく失敗の要約を依頼しましょう。

Claude Fable 5.2でなければならないのか?

いいえ。MCPサーバーはClaude Codeで実行できるあらゆるモデルで動作します。Anthropic自身もリリース記事で「ほとんどのコーディングおよびナレッジタスクでは、日常的に使える最も強力なモデルであるClaude Opus 5.5から始めることを推奨します」と明言しています。FableとMythosは、最も野心的で自由度の高い技術的作業向けに設計されたモデルとして位置づけられています。

短いプロンプトの1つのエージェントであれば、Opus 5.5で十分です。Fable 5.2を選ぶ価値があるのは、作業が大規模で自由度が高い場合です。たとえば、数十のエージェントのプロンプトを新しい基準に沿って書き直す、1か月分の失敗した通話をリグレッションテストスイートに変換する、動作を維持したままワークスペース間でエージェントを移行する、といったケースです。これらはベンチマーク結果ではなく、私たちの判断です。Anthropicは自社プラットフォームでFable 5.2の価格を入力100万tokenあたり$8、出力100万tokenあたり$40に設定しています。

よくある質問

Claude CodeはRetell AIに接続できますか?

はい。Retellはmcp.retellai.comでホスト型MCPサーバーを運用しており、Claude Codeはclaude mcp addコマンドと、AuthorizationヘッダーのRetell APIキーを使って接続します。Cursor、Claude Desktop、Codexなど他のMCPクライアントも同じサーバーに接続できます。

Retell MCPサーバーを使うにはClaude Fable 5.2が必要ですか?

いいえ。サーバーは、MCPクライアントが実行するモデルであれば何でも動作します。AnthropicはほとんどのコーディングおよびナレッジタスクについてClaude Opus 5.5から始めることを推奨しており、Fable 5.2は最も野心的で自由度の高い技術的作業向けと位置づけています。

音声エージェント自体をClaude Fable 5.2で動かせますか?

2026年11月10日時点では、Retellのモデルリストからは選択できません。エージェントはそのリストから選んだモデルで通話に応答します。リストにはClaude 5.5 Opus、Claude 5.5 Sonnet、Claude 5.5 Haikuが含まれます。Fable 5.2はClaude Codeからの構築、テスト、レビューを担当します。

Retell MCPサーバーとClaude向けRetell AIコネクタの違いは何ですか?

MCPサーバーはRetell APIキーでサインインし、Claude CodeやCursorなどのクライアントからRetell APIにアクセスします。コネクタはClaudeのコネクタディレクトリに掲載されており、OAuth経由でRetellログインを使ってサインインし、構築・デプロイ・テストの各ステップをチャット内のウィジェットとして表示します。コネクタで構築できるのはシングルプロンプトエージェントのみです。

Claude CodeにRetellアカウントの管理を任せても安全ですか?

安全性は、付与するキーと承認の設定次第です。最小限の権限を持つキーを使用し、invoke_api_endpointの呼び出しごとの承認を有効にしたままにして、削除または公開のendpointへの呼び出しは承認前に必ず確認してください。

Claude Code経由のテストに費用はかかりますか?

MCPサーバー経由の利用はRetell APIの利用にあたるため、発信した通話は他の通話と同様に課金されます。テストの費用についてはRetellのテスト料金ページをご覧ください。Claude Codeの利用料はAnthropicから請求され、サインイン方法に応じてClaudeプラン、利用クレジット、またはAPI料金が適用されます。

エージェントを1つ構築し、実際の通話で試す

Retellのプラットフォームデータによると、本番環境の通話時間の80%は、顧客が自ら構築・管理するエージェントで処理されています。Claude Codeはこのループをさらに短縮します。MCPサーバーのセットアップに従ってRetellでエージェントを1つ構築し、他のことを決める前に、実際の通話でその性能を判断してください。

ROI計算ツール
通話の自動化によるROIを試算

AI搭載の音声エージェントに切り替えることで、あなたのビジネスがどれだけ節約できるかをご確認ください。

完了しました! 
送信内容がメールに届いています
エラーが発生しました。フォームの送信中に問題が起きました。
   1
   8
20
エラーが発生しました。フォームの送信中に問題が起きました。

ROI結果

2,000

Total Human Agent Cost

$5,000
/month

AI Agent Cost

$3,000
/month

Estimated Savings

$2,000
/month

Estimate your monthly voice AI cost

$  0.11
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
Estimated monthly cost
$1,408
12,800 conversation minutes

Retellで、電話業務に革命を