Voipstudio MCP Server

AI - 人工知能 - VoIPstudio MCP サーバー¶

VoIPstudio MCP（モデルコンテキストプロトコル）サーバーは、Claude AI に VoIPstudio アカウントデータ（録音、CDR、ライブ通話、ボイスメールなど）への直接的かつ安全なアクセスを提供します。接続後、Claude は通話のクエリ、パターン分析、エージェントパフォーマンスの問題の表面化、QA レポートの平易な英語での生成を、カスタム開発なしで行えます。

CX アドオンを追加すると、各録音にはトランスクリプト、要約、センチメント、アクションアイテム、CX スコアが事前に付与された状態で届きます。これにより、Claude が必要とする AI 作業が大幅に削減され、トークン使用量を抑え、コストの予測可能性が高まります。

API キーの取得方法¶

MCP サーバーは VoIPstudio API トークンを使用して認証します。各キーは特定のユーザーにスコープされるため、Claude はそのユーザーがアクセスできるデータにのみアクセス可能です。

キーを生成する手順:

1. 管理ダッシュボードで、トークンを生成したいユーザーを開きます。
2. API キー セクションに移動します。
3. キーの名前を入力します（例: Claude MCP）。
4. 追加 をクリックします。
5. 目のアイコン をクリックして API キー / user_token を表示します。この値をコピーします。
6. 詳細を表示したりキーを削除するには、歯車アイコン をクリックし、詳細を表示 を選択します。

注意: API キーは、少なくとも 7 日に 1 回（デフォルトのタイムアウト）使用される限り有効です。必要に応じて、追加をクリックする前に、より長いタイムアウト（または無制限）を設定してください。

REST API ドキュメントを参照

Claude への接続¶

VoIPstudio は現在、Claude.ai コネクタディレクトリに掲載されていません。カスタム MCP サーバーとして手動で追加します。

MCP サーバー URL¶

MCP サーバー URL

https://mcp.voipstudio.workers.dev/sse

手順 (Claude.ai)¶

1. Claude.ai で、設定 → 統合（またはプランに応じてコネクタパネル）に移動します。
2. カスタム MCP サーバーを追加（または同等のもの）を選択します。
3. 上記の MCP サーバー URL を入力します。
4. 認証を求められたら、VoIPstudio API キーを入力します。
5. 保存して接続を承認します。

これで、Claude は任意の会話で VoIPstudio ツールを呼び出せるようになります。セッションで初めてツールが呼び出される際、Claude はデータ共有の確認を求めます。常に許可 をクリックすると、今後のセッションでこのプロンプトをスキップできます。

Anthropic API (開発者向け)¶

const response = await fetch("https://api.anthropic.com/v1/messages", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-Api-Key": "YOUR_ANTHROPIC_API_KEY"
  },
  body: JSON.stringify({
    model: "claude-sonnet-4-6",
    max_tokens: 1024,
    mcp_servers: [{
      type: "url",
      url: "https://mcp.voipstudio.workers.dev/sse",
      name: "voipstudio",
      authorization_token: "YOUR_VOIPSTUDIO_API_KEY"
    }],
    messages: [{
      role: "user",
      content: "Show me agents with a CX score below 6 this week"
    }]
  })
});

他の AI プラットフォームへの接続¶

外部 MCP をサポートするほとんどの AI プラットフォームは、同じ URL と API キーを使用して VoIPstudio MCP サーバーに接続できます。正確な設定手順はプラットフォームによって異なります。プラットフォームの統合または設定で、外部 MCP サーバー、カスタム MCP、またはリモート MCP というラベルの付いたオプションを探してください。

CX アドオン¶

CX アドオンがない場合、録音は生のメタデータとして届きます。Claude は各通話を自身で文字起こし・分析する必要があり、録音ごとにかなりのトークンを消費します。

CX アドオンを使用すると、VoIPstudio が自社インフラストラクチャ上で文字起こし、要約、センチメント分析、アクション抽出、CX スコアリングを通話ごとの料金なし、文字起こし制限なしの固定月額料金で処理します。Claude は完成されたインテリジェンスを受け取り、即座に推論できます。

CX アドオンなし	CX アドオンあり
トランスクリプト	Claude が音声を取得し文字起こし/翻訳する必要あり	✓ 含む、話者ダイアライゼーション
要約	Claude が生成する必要あり	✓ 含む
センチメント	Claude が推測する必要あり	✓ 含む
アクションアイテム	Claude が抽出する必要あり	✓ 含む
CX スコア	利用不可	✓ 全通話で 1–10
概算トークン/通話	10,000–15,000	300–500
コストモデル	変動 AI 費用	固定月額サブスクリプション

CX アドオンでアンロックされるフィールド¶

フィールド	型	説明
transcript	string	単語レベルの完全なトランスクリプト
transcript_speakers	object	話者ダイアライズされたトランスクリプトセグメント
summary	string	通話結果の簡潔な要約
sentiment	string	顧客センチメント: positive, neutral, negative
cx_score	number (1–10)	顧客体験スコア
metadata.timeline	array	通話から抽出された重要な瞬間とアクションアイテム

ツールリファレンス¶

MCP 統合のシンプルさにより、複雑な API を理解する必要はなく、代わりにシンプルなプロンプトで AI プラットフォームが Voipstudio から提供されたデータを理解し、適切な応答を返すのを支援できます。

ただし、より技術的なユーザーは「内部」で何が起こっているのか知りたい場合もあるため、以下は MCP サーバー機能の一部のリファレンスガイドです。

get_recordings¶

通話録音を返します。CX アドオンが有効な場合、各レコードにはトランスクリプト、要約、センチメント、CX スコア、タイムラインが含まれます。アドオンがない場合、これらのフィールドは null を返します。

パラメータ

パラメータ	型	デフォルト	説明
filters	array	—	フィルターオブジェクト — フィルタリングを参照
limit	number	10	ページあたりのレコード数 (最大 1000)
page	number	1	ページ番号

レスポンスフィールド

フィールド	型	説明
id	number	一意の録音 ID
call_id	number	CDR call_id にリンク
timestamp	string	録音開始 (UTC, YYYY-MM-DD HH:mm:ss)
caller	string	発信者番号
called	string	着信者番号
src_name	string	エージェント名 (発信元)
dst_name	string	宛先名
duration	number	秒単位の通話時間
type	string	I \= インバウンド, O \= アウトバウンド
context	string	通話コンテキスト (例: LOCAL_USER, QUEUE)
transcript	string	null
transcript_speakers	object	null
summary	string	null
sentiment	string	null
cx_score	number	null
metadata.timeline	array	null

例 – 今週の低い CX スコア

Claude に依頼: "今週の CX スコアが 6 未満だったすべての録音をエージェントごとにグループ化し、各通話で何が問題だったかの要約とともに表示してください。"

Claude は次のようにツールを呼び出します:

{
  "filters": [
    { "property": "calldate", "operator": "gte", "value": "2026-06-09 00:00:00" },
    { "property": "cx_score",  "operator": "lt",  "value": 6 }
  ],
  "limit": 100
}

get_cdrs¶

通話詳細レコード – すべての通話レグの生ログ。ボリューム統計、コスト分析、通話時間分布、エージェントアクティビティサマリーに使用します。CX アドオンなしで利用可能です。

パラメータ: get_recordings と同じ (filters, limit, page)

主なレスポンスフィールド

フィールド	型	説明
call_id	number	一意の通話識別子
calldate	string	通話開始タイムスタンプ (UTC)
src_name	string	エージェント / 発信者名
dst_name	string	宛先名
billsec	number	課金対象秒数
duration	number	呼び出し時間を含む総秒数
disposition	string	CONNECTED, NO ANSWER, BUSY, FAILED
charge	number	通話料金
type	string	I \= インバウンド, O \= アウトバウンド
src_ua	string	発信元デバイス / ソフトフォンユーザーエージェント
labels	array	VoIPstudio で適用されたカスタムタグ

get_live_calls¶

アカウント上のすべてのアクティブな通話のリアルタイムスナップショットを返します。パラメータは不要です。

例: "現在進行中の通話はいくつあり、どのエージェントが対応していますか？"

get_voicemails¶

ボイスメールメッセージを取得します。他のツールと同じ filters、limit、page インターフェースです。

フィルタリング可能な主なフィールド: src、dst、calldate、duration、listened

get_recording_audio¶

特定の録音の MP3 音声の直接ダウンロード URL を返します。

パラメータ: id (number) — get_recordings レスポンスの id フィールド。

情報

音声 URL は時間制限付きです。速やかに使用し、長期間キャッシュしないでください。

フィルタリングとページネーション¶

すべてのリストツールは、オプションの filters 配列を受け入れます。各フィルターオブジェクトには 3 つのプロパティがあります:

プロパティ	説明
property	フィルタリングするフィールド名 (例: calldate, cx_score, src_name)
operator	eq, ne, lt, lte, gt, gte, in, like, notlike
value	文字列、数値、または配列 (in 演算子の場合)

一般的な例¶

日付範囲

[
  { "property": "calldate", "operator": "gte", "value": "2026-06-01 00:00:00" },
  { "property": "calldate", "operator": "lte", "value": "2026-06-30 23:59:59" }
]

CX スコアのしきい値

[{ "property": "cx_score", "operator": "gte", "value": 8 }]

特定のエージェント

[{ "property": "src_name", "operator": "eq", "value": "Jane Ryder" }]

接続された通話のみ

[{ "property": "disposition", "operator": "eq", "value": "CONNECTED" }]

5 分を超えるインバウンド通話

[
  { "property": "type",     "operator": "eq",  "value": "I" },
  { "property": "billsec",  "operator": "gt",  "value": 300 }
]

ユースケース¶

エージェント QA レポート¶

"今月の各エージェントの QA サマリーをください — CX スコア平均、一般的な苦情テーマ、要約付きの最低スコア 3 通話。"

コールセンターのボリューム統計¶

"今週の日別通話ボリュームは？平均処理時間と、応答されなかった通話数は？"

センチメントトレンド分析¶

"先月と比較して顧客センチメントは改善していますか、それとも低下していますか？ネガティブなセンチメントと相関する通話トピックは？"

不在着信フォローアップリスト¶

"過去 24 時間のすべての不在インバウンド通話を発信者 ID 付きでリストアップし、コールバックの優先順位を付けられるようにしてください。"

コストと請求のレビュー¶

"今四半期、最も高額なアウトバウンド通話を行った内線番号はどれですか？"

ライブ運用チェック¶

"現在通話中のエージェントは何人で、20 分以上継続している通話はありますか？"

トークン効率¶

CX アドオンなしで Claude が各通話を分析する場合、Claude は音声コンテンツを処理し、独自の文字起こしと分析を生成する必要があります。CX アドオンはこれを完全に VoIPstudio にオフロードします:

VoIPstudio が処理するもの (固定月額料金、無制限の通話):

• 音声文字起こし
• 話者ダイアライゼーション
• 通話要約
• センチメント分類
• アクションアイテム抽出
• CX スコアリング

Claude が受け取るもの: 推論、比較、レポート作成の準備が整ったクリーンで構造化されたテキストフィールド。

これにより、Claude に 1 回のセッションで数百の通話を分析するよう依頼でき、トークンコストはごくわずかで済み、大規模な QA、トレンド分析、エージェントコーチングレポートが予測不可能な AI 費用なしで実用的になります。