Retell MCP Serverのご紹介

RetellはModel Context Protocol（MCP）に対応しました。これにより、すでにお使いのAIツールから音声エージェントを直接構築・管理できます。対象には、Cursor、Claude Desktop、Claude Code、Codex系ツールなど、MCP対応クライアントが含まれます。

単一のMCP接続で、あなたのアシスタントはRetellプラットフォームと直接連携し、次のことができます。

• エージェントの作成と更新
• 通話の開始
• 電話番号の管理
• ナレッジベースの紐づけ
• QAの実行

すでにRetellをAPIやSDK経由でお使いの場合、MCPは同じプラットフォームを、よりシンプルでエージェントに扱いやすいインターフェースで提供するものです。

Retell MCP Serverでできること

Retell MCP Serverは、Retellプラットフォームへの直接アクセスを提供します。要するに、Retell MCP ServerはあなたのAIエージェントを音声スタックの実働インターフェースに変え、エージェントの作成、通話の開始、電話番号の更新、ナレッジベースの管理、QAの実行といった音声ワークフロー全体にわたって、実際にアクションを起こせるようにします。すべて1つの接続からです。より具体的には、次のように役立ちます。

エージェント

• エージェントの作成
• エージェントの更新
• バージョンの公開
• エージェントの一覧表示
• バージョンの取得

通話

• 電話・Web通話の開始
• 通話詳細の取得
• 通話の一覧表示
• 通話メタデータの更新
• 通話の削除
• QAとレビューの実行

電話番号

• 番号のインポート
• 番号のプロビジョニング
• 番号の一覧表示
• 番号詳細の取得

ナレッジベース

• ナレッジベースの作成
• ソースの紐づけ
• ソースの削除
• ナレッジベースの一覧表示

音声

• 音声の一覧表示
• 音声のクローン
• コミュニティ音声の検索

チャット

• チャットの作成
• チャットエージェントの作成
• チャットの終了
• チャットメタデータの更新

テストとQA

• テストケースの作成
• テストの実行
• QA実行の一覧表示
• QAの再実行
• スコアの送信

アラートとWebhook

• アラートルールの作成
• アラートルールの一覧表示
• インシデントの一覧表示
• webhookのテスト

なぜ重要なのか

本番環境で音声AIを構築するには、いまだにコンテキストの切り替えが多すぎます。エージェント、Retellのダッシュボード、ドキュメント、スクリプト、QAツールの間を行き来する代わりに、Retell MCP Serverはこれらのワークフローを単一のインターフェースにまとめ、音声エージェントの構築・テスト・管理をより速く、より簡単にします。

仕組み

セットアップはシンプルです。MCPクライアントがRetellのホスト型MCPエンドポイントにHTTPで接続し、RetellのAPIキーで認証し、ツールを呼び出します。tools/listを通じて、利用可能なツールを自動的に検出することもできます。含まれる情報は次のとおりです。

• ツール名
• 説明
• JSON入力スキーマ

そのため、あらゆるアクションをハードコードする代わりに、あなたのエージェントはどんなRetellツールが存在するかをすでに把握しており、それらを正しく使う方法も知っています。

始めるために必要なもの

次のものを用意してください。

• Retell APIキー
• Cursor、Claude Desktop、Claude Code、CodexなどのMCP対応クライアント
• Retell MCPサーバーのURL：https://mcp.retellai.com

認証フォーマット：

Authorization: Bearer <RETELL_API_KEY>

シンプルなセットアップ

ほとんどのMCPクライアントは、HTTP経由のリモートMCPサーバーをサポートしています。

次を使用します。

• URL：https://mcp.retellai.com
• ヘッダー：Authorization: Bearer

セットアップ例

Cursor

開く：Command Palette → Cursor Settings → MCP → Add new global MCP server

追加：

{
  "mcpServers": {
    "retell": {
      "url": "https://mcp.retellai.com",
      "headers": {
        "Authorization": "Bearer <RETELL_API_KEY>"
      }
    }
  }
}

Claude Desktop

開く：Settings → Developer → Edit Config

追加：

{
  "mcpServers": {
    "retell": {
      "command": "npx",
      "args": [
        "mcp-remote@latest",
        "https://mcp.retellai.com",
        "--header",
        "Authorization:Bearer <RETELL_API_KEY>"
      ]
    }
  }
}

Claude Code

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

Codex

これを~/.codex/config.tomlに追加します。

[mcp_servers.retell]
url = "https://mcp.retellai.com"
bearer_token_env_var = "RETELL_API_KEY"

次に設定します。

export RETELL_API_KEY="<RETELL_API_KEY>"

その他のMCPクライアント

お使いのクライアントがリモートMCPのURLとヘッダーをサポートしている場合は、次を使用します。

• URL：https://mcp.retellai.com
• ヘッダー：Authorization: Bearer

プロンプト例

接続すると、あなたのアシスタントはすぐにRetellと連携し始められます。

次のようなプロンプトを試してみてください。

• 「私のエージェントを一覧表示して、それぞれが何をするか要約して。」
• 「インバウンド営業の選別用に新しいエージェントを作成して、公開して。」
• 「直近20件の通話を見せて、QAスコアの低いものにフラグを立てて。」
• 「ナレッジベースを作成して、これらのソースを紐づけて、私のエージェントがそれを使うように更新して。」
• 「この電話番号をインポートして、私のエージェントに割り当てて。」
• 「この通話でQAを再実行して、失敗理由を要約して。」

さて、ここがMCPが本当に力を発揮できる面白いところです。あなたはもはやアシスタントとチャットしているだけではありません。実際のプラットフォームアクセスを与えることで、音声エージェントをその場で構築・テスト・分析・改善する手助けをさせられるのです。

チームが気に入る理由

Retell MCP Serverはチームを次のように支援します。

• AIクライアントを離れることなく、より速く構築できる
• ダッシュボードとAPIの手間を減らせる
• プロトタイプから本番へより速く移行できる
• 手作業を減らしてQAと運用を回せる
• 音声インフラを、開発者がすでに使っているツールの近くに保てる

開発者にとっては、手作業の連携作業を削減します。プロダクトチームにとっては、テストと反復を高速化します。運用チームにとっては、通話、QA、日々のエージェントワークフローの管理を容易にします。

セキュリティと安全な使い方

LLMを運用ツールに接続することは大きな力ですが、リスクも伴います。最大のリスクはプロンプトインジェクションです。つまり、トランスクリプト、ユーザーメッセージ、ナレッジベースのドキュメントといった信頼できないコンテンツに、あなたが求めていないことをモデルにさせようとする隠れた指示が含まれ得るということです。ほとんどのMCPクライアントは「ツール実行前に確認する」機能をサポートしています。

それをオンにしておいてください。

ベストプラクティス

MCPは、あなたのアシスタントに実際のオペレーターアクセスを与えるものと考えてください。

推奨事項：

• 最小権限を使う — 必要な権限だけを持つAPIキーを作成してください。
• キーをプロンプトに入れない — APIキーはクライアント設定またはシークレットに保存してください。チャットに貼り付けないでください。
• 読み取り優先のワークフローを好む — 更新や削除の前に、現在の状態を取得してください。
• 破壊的なアクションはレビューする — deleteやpublishのようなアクションは、明確なユーザーの意図を要求すべきです。
• 機密データに注意する — 通話ログやトランスクリプトにはPIIが含まれ得ます。必要なものだけを公開してください。
• 可能な限り本番以外の環境を使う — 本番システムに接続する前に、開発環境で始めてください。

トラブルシューティング

うまく動かない場合、まず確認すべきことは次のとおりです。

ツールが表示されない

• MCPサーバーのURLが正しいことを確認してください
• Authorizationヘッダーが正しく設定されていることを確認してください
• クライアントがRetell MCPエンドポイントに到達できることを確認してください

401 Unauthorized

• ヘッダーがAuthorization: Bearer <RETELL_API_KEY>であることを確認してください
• APIキーが有効で正しいことを確認してください

ツール呼び出しエラー

• より小さい、またはよりシンプルな入力で再試行してください
• 返されたエラーメッセージで詳細を確認してください
• 多くのMCPクライアントは構造化されたツールエラーを直接表示するため、問題の特定に役立ちます

Retell MCPで構築を始める

Retell MCP Serverは、チームがすでに使っているAIツールからRetellを簡単に利用できるようにします。つまり、ツール間の切り替えが減り、反復が速くなり、本番の音声エージェントを構築・管理するより直接的な方法が得られます。

すでにRetellをお使いなら、MCPはより速いワークフローをもたらします。Retellが初めてなら、始めるための最もシンプルな方法の一つです。クライアントを接続し、APIキーを追加し、構築を始めましょう。さあ、行きましょう！

サポートが必要ですか？

問題が発生した場合や、さらなるMCP機能をリクエストしたい場合は、support@retellai.comまでご連絡ください。