mcpField
R
RetellAI MCP Server

RetellAI MCP Server

ローカル
npmjs.comコミュニケーション4029 週間前に更新

RetellAI MCP Server について

RetellAI MCP Server は、RetellAI の音声サービスを操作するための MCP サーバーです。AI アシスタントから通話、音声エージェント、電話番号、音声の管理を行えます。MCP クライアントから RetellAI の音声機能を設定または利用したい方に向けたものです。

主な機能

  1. 01通話の作成、一覧取得、詳細取得、削除
  2. 02音声エージェントの作成と更新
  3. 03電話番号の表示と設定
  4. 04利用可能な音声オプションの取得

活用シーン

  1. 01アカウント内の電話番号や音声エージェントの一覧取得
  2. 02発信電話や Web 通話の作成
  3. 03異なる LLM 設定での音声エージェントの構成

MCP 対応

本プロジェクトは MCP サーバーであり、RetellAI の通話、エージェント、電話番号、音声に関するツールを MCP クライアントに公開して、AI アシスタントから RetellAI サービスを操作できるようにします。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"retellai": {
"command": "npx",
"args": [
"-y",
"@abhaybabbar/retellai-mcp-server"
],
"env": {
"RETELL_API_KEY": "<RETELL_API_KEY>"
}
}
}
}
起動コマンドnpx -y @abhaybabbar/retellai-mcp-server
設定が必要な環境変数
RETELL_API_KEYシークレット

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npm@abhaybabbar/retellai-mcp-server

ツール

24

掲載時のツール一覧 · 3 週間前に更新

パラメーター型必須説明
metadataobjectいいえ
toNumberstringはい発信先の電話番号
directionenumいいえinbound | outbound
fromNumberstringはい発信元の電話番号
optInSignedUrlbooleanいいえ
overrideAgentIdstringいいえこの通話に限り、指定した Agent ID のエージェントを使用します
overrideAgentVersionnumberいいえこの通話に限り、指定したバージョンのエージェントを使用します
retellLlmDynamicVariablesobjectいいえキーと値のペア形式で LLM に渡す動的変数
optOutSensitiveDataStoragebooleanいいえ

詳細

RetellAI MCP サーバー

これは RetellAI 向けの Model Context Protocol(MCP)サーバー実装で、AI アシスタントが RetellAI の音声サービスを利用できるようにします。

機能

RetellAI MCP サーバーは、次のツールを提供します。

  • 通話管理:電話通話とウェブ通話の作成および管理
  • エージェント管理:異なる LLM 設定を使用した音声エージェントの作成および管理
  • 電話番号管理:電話番号の取得および設定
  • 音声管理:さまざまな音声オプションへのアクセスと使用

Claude Desktop の設定

  1. Claude Desktop を開き、CMD + , を押して Settings に移動します。
  2. Developer タブをクリックします。
  3. Edit Config ボタンをクリックします。
  4. ファイルエクスプローラーで claude_desktop_config.json ファイルが開きます。
  5. Retell ダッシュボード(https://dashboard.retellai.com/apiKey)から Retell API キーを取得します。
  6. 次の内容を claude_desktop_config.json ファイルに追加します。詳しくはこちらをご覧ください。
  7. 設定ファイルを編集した後、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

この問題は通常、古いインストール環境での依存関係やバージョンの不一致が原因です。

使用例:

  1. RetellAI に登録しているすべての電話番号を一覧表示する
  2. 登録しているすべてのエージェントを一覧表示する
  3. ピザ配達エージェントについて詳しく教えて
  4. エージェントの作成と通話の例:
    1. 地元のピザ店に電話するエージェントを作成してください。会話は短く、要点を押さえるようにしてください。
    2. マルゲリータピザを注文する
    3. 代金は着払いの現金で支払います
    4. に届けてもらう
    5. エージェントには私のふりをしてもらいます。私の名前は<your_name>です
    6. 米国の電話番号を使って、地元のピザ店の<phone_number>に発信する

リポジトリの設定

  1. 依存関係をインストールします。

    npm i
    
  2. RetellAI API キーを記載した .env ファイルを作成します。

    RETELL_API_KEY=your_api_key_here
    
  3. サーバーを実行します。

    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

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。