MCP
Claude・Claude Code・Cursor・ChatGPT などの
MCP の
接続先#
- URL:
https://api.voicast.jp/mcp - 方式: Streamable HTTP
(POST だけ。 状態を 持たない) - 認証: ブラウザでの
ログイン (OAuth 2.1・PKCE) 。 API キーは /v1のREST API で 使います
Claude Code#
claude mcp add --transport http voicast https://api.voicast.jp/mcpClaude Code で/mcp を
Claude(claude.ai・Claude Desktop)#
設定のhttps://api.voicast.jp/mcp を
Cursor#
プロジェクトの.cursor/mcp.json~/.cursor/mcp.json)
{
"mcpServers": {
"voicast": { "url": "https://api.voicast.jp/mcp" }
}
}VS Code#
.vscode/mcp.json に
{
"servers": {
"voicast": { "type": "http", "url": "https://api.voicast.jp/mcp" }
}
}ChatGPT#
設定でhttps://api.voicast.jp/mcp、
ログインと許可#
ブラウザでは
- 許可した
アプリは、 管理画面の アカウントの 設定の 「接続中の アプリ」 に 並び、 そこから 取り消せます。 - アカウントは
管理画面で 作ります。 まだ 無いときは https://app.voicast.jp/login で 作ってから、 MCP の URL を 追加します。 - アクセストークンは
1 時間、 リフレッシュトークンは 30 日で、 クライアントが 自動で 更新します。
ツール#
組織・API キー・請求#
| ツール | できる |
要る |
|---|---|---|
whoami・list_organizations |
ログイン中の |
— |
create_organization |
組織の |
— |
update_organization |
組織名の |
owner |
list_projects・list_environments |
プロジェクトとenvironment_id) |
viewer |
list_members |
メンバーの |
viewer |
invite_member |
メンバーの |
admin |
list_api_keys・create_api_key・revoke_api_key |
API キーの |
admin |
get_tools_secret・rotate_tools_secret |
ツールの |
admin |
set_retention |
環境のget_retention・list_environments) |
admin |
get_billing |
契約・残高・オートチャージ・ |
admin |
create_topup |
チャージの |
owner |
get_billing_portal |
請求の |
owner |
set_spending_cap |
オートチャージの |
owner |
環境の中#
list_projects でenvironment_id を
| ツール | できる |
同じ |
|---|---|---|
list_agents・get_agent |
エージェントの |
GET /v1/agents |
list_agent_versions |
エージェント設定の |
GET /v1/agents/{id}/versions |
list_agent_templates |
エージェントのcreate_agent に |
GET /v1/agent-templates |
create_agent・update_agent・delete_agent |
エージェントの |
POST・PUT・DELETE /v1/agents |
try_tool |
エージェントのagent_id が |
POST /v1/tools/try |
list_tenants・get_tenant |
テナントの |
GET /v1/tenants |
create_tenant・update_tenant |
テナントの |
POST・PATCH /v1/tenants |
rotate_tenant_secret・delete_tenant |
接続シークレットの |
POST /v1/tenants/{id}/secret・DELETE /v1/tenants/{id} |
list_calls・get_call・get_call_by_provider・get_transcript |
会話のcursor)billed_yen |
GET /v1/calls |
create_session |
Web・アプリのclient_token・ice_servers) |
POST /v1/sessions |
create_webhook_portal_link |
Webhook のlocale で |
POST /v1/webhooks/portal |
get_usage |
利用の |
GET /v1/usage |
list_connectors・list_connections |
連携先と、 |
GET /v1/connectors・/v1/connections |
get_connection |
連携 1 つ |
GET /v1/connections/{id} |
list_connection_options |
設定の{}) |
GET /v1/connections/{id}/options |
update_connection |
連携の |
PATCH /v1/connections/{id} |
create_connection |
URL とhttp) |
POST /v1/connections |
create_connect_link |
テナント |
POST /v1/tenants/{id}/connect-links |
delete_connection |
連携の |
DELETE /v1/connections/{id} |
get_retention |
会話の |
GET /v1/retention |
get_integration_guide |
組み込み方の |
— |
確認の要るツール#
revoke_api_key・rotate_tools_secret・delete_agent・delete_tenant・rotate_tenant_secret・delete_connection・set_spending_cap・set_retentionconfirm: true をconfirm: true を
try_tool はconfirm)
チャージcreate_topup)get_billing_portal)
エラー#
ツールのisError: true のcode(状態): 説明 と、
頼み方の例#
voicast にテストの環境の API キーを作って、.env の VOICAST_API_KEY に入れて歯科医院の受付のエージェントを作って。名前・電話番号・用件を聞き取り、急な痛みは人に引き継ぐ。声はきっぱりした女性(female-firm)でテナント clinic-123 を作って、さっきのエージェント設定を割り当てて。接続シークレットはサーバーの設定に保存してこのリポジトリの Twilio の着信の処理に、voicast につなぐ TwiML と、終わったあとの転送を足して(get_integration_guide を読んでから)昨日の会話で handoff になったものを一覧にして、理由ごとに数えて今月のテナントごとの利用の分数と金額を表にして残高を確かめて、1 万円をチャージする URL を出してCI・サーバーから使う#
ブラウザを/v1 のcreate_api_key か
制限#
- ログインでの
呼び出しは、 1 人あたり 1 分 300 回までです (超えると 429) 。 - ブラウザから
直接の 呼び出し ( Origin付き)は 受けません。 - MCP の
バージョンは 2025-11-25・2025-06-18・2025-03-26・2024-11-05に対応しています。