Voipstudio MCP
公式VoIPstudio MCPサーバーは、対応するAIアシスタントに、認可されたVoIPstudioアカウントデータ（録音、通話詳細記録、ライブ通話、ボイスメールを含む）への安全なアクセスを提供し、通話アクティビティの照会、パターンの分析、エージェントのパフォーマンス問題の特定、QAや運用レポートの平易な英語での生成を可能にします。
Voipstudio MCPで何ができますか？
- フィルタ付きで通話録音を取得 —
get_recordingsを使用して、日付、エージェント、CXスコアで録音をリクエストします。CXアドオンが有効な場合は、文字起こしと要約も含まれます。 - 通話詳細レコードを分析 — ボリューム統計、コスト分析、通話時間の分布、エージェントのアクティビティ概要を取得するために使用します。
- ライブ通話をリアルタイムで監視 — アクティブな通話と、どのエージェントが対応しているかを確認します。
- ボイスメールメッセージを取得 — 発信者、日付、再生済みステータスなどのフィルタを使用してボイスメールを取得します。
- 音声の直接ダウンロードリンクを取得 — 特定の録音に対する期限付きのMP3 URLを取得します。
ドキュメント
AI - 人工知能 - VoIPstudio MCP サーバー
VoIPstudio MCP（Model Context Protocol）サーバーは、Claude AI に録音、CDR、ライブ通話、ボイスメールなど、VoIPstudio アカウントデータへの直接的かつ安全なアクセスを提供します。接続後、Claude は通話の照会、パターンの分析、エージェントのパフォーマンス問題の可視化、QA レポートの生成を、カスタム開発なしで平易な英語で行えます。
CX Addon を追加すると、各録音には文字起こし、要約、感情分析、アクション項目、CX スコアが事前に付与されて届きます。これにより、Claude が行う AI 処理が大幅に削減され、トークン使用量を抑え、コストをより予測しやすくします。
API キーの取得
MCP サーバーは VoIPstudio API トークンを使用して認証します。各キーは特定のユーザーにスコープされるため、Claude はそのユーザーがアクセスできるデータのみにアクセスできます。
キーを生成するには：
- 管理ダッシュボードで、トークンを生成したいユーザーを開きます。
- API キー セクションに移動します。
- キーの名前を入力します — 例：
Claude MCP。 - 追加 をクリックします。
- 目のアイコン をクリックして API キー /
user_tokenを表示します。この値をコピーします。 - 詳細を表示またはキーを削除するには、歯車アイコン をクリックして 詳細を表示 を選択します。
注： API キーは、7日間（デフォルトのタイムアウト）に少なくとも1回使用される限り有効です。必要に応じて、追加 をクリックする前に長いタイムアウト（または無制限）を設定してください。
REST API ドキュメント を参照
Claude への接続
VoIPstudio は現在 Claude.ai のコネクタディレクトリに掲載されていません。カスタム MCP サーバーとして手動で追加します。
MCP サーバー URL
[!info] MCP サーバー URL https://mcp.voipstudio.workers.dev/sse
手順（Claude.ai）
- Claude.ai で、設定 → 統合（またはプランに応じてコネクタパネル）に移動します。
- カスタム MCP サーバーを追加（または同等のオプション）を選択します。
- 上記の MCP サーバー URL を入力します。
- 認証を求められたら、VoIPstudio API キーを提供します。
- 接続を保存して承認します。
これで 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 Addon
CX Addon がない場合、録音は生のメタデータとして届きます。Claude は各通話を自分で文字起こしして分析する必要があり、録音ごとに大量のトークンを消費します。
CX Addon を使用すると、VoIPstudio が文字起こし、要約、感情分析、アクション抽出、CX スコアリングを自社のインフラ上で処理します。通話ごとの料金や文字起こしの制限がない固定月額コスト で提供されます。Claude は完成したインテリジェンスを受け取り、すぐに推論できます。
| CX Addon なし | CX Addon あり | |
|---|---|---|
| 文字起こし | Claude が音声を取得して文字起こし/翻訳する必要あり | ✓ 含まれる、話者分離済み |
| 要約 | Claude が生成する必要あり | ✓ 含まれる |
| 感情分析 | Claude が推測する必要あり | ✓ 含まれる |
| アクション項目 | Claude が抽出する必要あり | ✓ 含まれる |
| CX スコア | 利用不可 | ✓ 各通話で 1〜10 |
| おおよそのトークン/通話 | 10,000〜15,000 | 300〜500 |
| コストモデル | 変動する AI 支出 | 固定月額サブスクリプション |
CX Addon で解放されるフィールド
| フィールド | 型 | 説明 |
|---|---|---|
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 Addon が有効な場合、各レコードには文字起こし、要約、感情分析、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 Addon なしでも利用可能です。
パラメータ： 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 フィールド。
[!info] 情報 音声 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 Addon なしで Claude が分析する各通話では、Claude が音声コンテンツを処理し、独自の文字起こしと分析を生成する必要があります。CX Addon はこれを VoIPstudio に完全にオフロードします：
VoIPstudio が処理する内容（固定月額コスト、無制限の通話）：
- 音声の文字起こし
- 話者分離
- 通話の要約
- 感情の分類
- アクション項目の抽出
- CX スコアリング
Claude が受け取る内容： 推論、比較、レポート作成にすぐ使用できる、クリーンで構造化されたテキストフィールド。
つまり、単一セッションで数百件の通話を Claude に分析させることができ、トークンコストはわずかで済みます。大規模な QA、トレンド分析、エージェントコーチングレポートを、予測不能な AI 支出なしで実用的に実行できます。