RetellAI MCP Server について
RetellAI MCP Server は、RetellAI の音声サービスを操作するための MCP サーバーです。AI アシスタントから通話、音声エージェント、電話番号、音声の管理を行えます。MCP クライアントから RetellAI の音声機能を設定または利用したい方に向けたものです。
主な機能
- 01通話の作成、一覧取得、詳細取得、削除
- 02音声エージェントの作成と更新
- 03電話番号の表示と設定
- 04利用可能な音声オプションの取得
活用シーン
- 01アカウント内の電話番号や音声エージェントの一覧取得
- 02発信電話や Web 通話の作成
- 03異なる LLM 設定での音声エージェントの構成
MCP 対応
本プロジェクトは MCP サーバーであり、RetellAI の通話、エージェント、電話番号、音声に関するツールを MCP クライアントに公開して、AI アシスタントから RetellAI サービスを操作できるようにします。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
24掲載時のツール一覧 · 3 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| metadata | object | いいえ | |
| toNumber | string | はい | 発信先の電話番号 |
| direction | enum | いいえ | inbound | outbound |
| fromNumber | string | はい | 発信元の電話番号 |
| optInSignedUrl | boolean | いいえ | |
| overrideAgentId | string | いいえ | この通話に限り、指定した Agent ID のエージェントを使用します |
| overrideAgentVersion | number | いいえ | この通話に限り、指定したバージョンのエージェントを使用します |
| retellLlmDynamicVariables | object | いいえ | キーと値のペア形式で LLM に渡す動的変数 |
| optOutSensitiveDataStorage | boolean | いいえ |
詳細
RetellAI MCP サーバー
これは RetellAI 向けの Model Context Protocol(MCP)サーバー実装で、AI アシスタントが RetellAI の音声サービスを利用できるようにします。
機能
RetellAI MCP サーバーは、次のツールを提供します。
- 通話管理:電話通話とウェブ通話の作成および管理
- エージェント管理:異なる LLM 設定を使用した音声エージェントの作成および管理
- 電話番号管理:電話番号の取得および設定
- 音声管理:さまざまな音声オプションへのアクセスと使用
Claude Desktop の設定
Claude Desktopを開き、CMD + ,を押してSettingsに移動します。Developerタブをクリックします。Edit Configボタンをクリックします。- ファイルエクスプローラーで
claude_desktop_config.jsonファイルが開きます。 - Retell ダッシュボード(https://dashboard.retellai.com/apiKey)から Retell API キーを取得します。
- 次の内容を
claude_desktop_config.jsonファイルに追加します。詳しくはこちらをご覧ください。 - 設定ファイルを編集した後、Claude Desktop を再起動します。
{
"mcpServers": {
"retellai-mcp-server": {
"command": "npx",
"args": ["-y", "@abhaybabbar/retellai-mcp-server"],
"env": {
"RETELL_API_KEY": "<your_retellai_token>"
}
}
}
}
トラブルシューティング:「利用可能なツールがありません」
Claude Desktop にサーバーは表示されるものの、ツールが表示されない場合は、パッケージを最新バージョンにアップグレードしてください。
npx -y @abhaybabbar/retellai-mcp-server@latest
この問題は通常、古いインストール環境での依存関係やバージョンの不一致が原因です。
使用例:
- RetellAI に登録しているすべての電話番号を一覧表示する
- 登録しているすべてのエージェントを一覧表示する
- ピザ配達エージェントについて詳しく教えて
- エージェントの作成と通話の例:
- 地元のピザ店に電話するエージェントを作成してください。会話は短く、要点を押さえるようにしてください。
- マルゲリータピザを注文する
- 代金は着払いの現金で支払います
- に届けてもらう
- エージェントには私のふりをしてもらいます。私の名前は<your_name>です
- 米国の電話番号を使って、地元のピザ店の<phone_number>に発信する
リポジトリの設定
-
依存関係をインストールします。
npm i -
RetellAI API キーを記載した
.envファイルを作成します。RETELL_API_KEY=your_api_key_here -
サーバーを実行します。
node src/retell/index.js
利用可能なツール
通話ツール
list_calls:すべての Retell 通話を一覧表示しますcreate_phone_call:新しい電話通話を作成しますcreate_web_call:新しいウェブ通話を作成しますget_call:特定の通話の詳細を取得しますdelete_call:特定の通話を削除します
エージェントツール
list_agents:すべての Retell エージェントを一覧表示しますcreate_agent:新しい Retell エージェントを作成しますget_agent:ID を指定して Retell エージェントを取得しますupdate_agent:既存の Retell エージェントを更新しますdelete_agent:Retell エージェントを削除しますget_agent_versions:Retell エージェントのすべてのバージョンを取得します
電話番号ツール
list_phone_numbers:すべての Retell 電話番号を一覧表示しますcreate_phone_number:新しい電話番号を作成しますget_phone_number:特定の電話番号の詳細を取得しますupdate_phone_number:電話番号を更新しますdelete_phone_number:電話番号を削除します
音声ツール
list_voices:利用可能なすべての Retell 音声を一覧表示しますget_voice:特定の音声の詳細を取得します
ライセンス
MIT
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。