ブログ · · 約 8 分で
音声 AI に外部のシステムを使わせる:MCP サーバーより API でつなぐ
電話の
要点
- MCP サーバーを
会話の AI に 直接つなぐと、 設定した 人が OAuth で ログインした トークンで、 その 環境の すべての 会話から 呼ぶ 作りに なります。 電話を かけてきた 誰もが、 その 人の 権限で 操作できる ことになります。 - 電話の
音声 AI には、 誰の 権限で 呼ぶかを 決められる API で つなぐのが 安全です。 voicast では、 URL と API キーの 連携か、 会話中の ツール (自社の サーバーで 受けて 呼ぶ) を 使います。 - どちらの
形でも、 待ち時間の 上限・ツールの 数の 絞り込み・ 書き換えの 前の 読み上げと 同意・返す量の 制限が、 チャットより 大事に なります。
電話の
会話中に外部のシステムを使う 3 つの形
音声 AI が
| 形 | 呼ぶ |
向いている |
|---|---|---|
| 会話中の |
自社の |
呼び先が |
| URL と |
連携の |
ほかの |
| MCP サーバーを |
設定した |
1 人の |
MCP は、
MCP サーバーを電話の AI に直接つなぐときの問題
誰の権限で呼ぶかが、ログインした人に固定される
リモートの
電話を
ツールの中身が、こちらの確認なしに変わる
MCP サーバーの
注釈は保証ではない
MCP のreadOnlyHint など)
API でつなぐ 2 つの方法
API で
1. URL と API キーの連携
相手の
2. 会話中のツール(自社のサーバーで受けて呼ぶ)
事業者
電話で外部のシステムを使うときの 4 つの注意
どちらの
- 待ち時間の
上限 : ツールを呼んでいる あいだ、 相手は 無音か 「お調べします」 の 声を 聞いて 待っています。 上限を 決めて 打ち切り、 間に 合わなければ 「担当者から 折り返します」 に 切り 替える 流れを 用意します。 - ツールの
数と : 全部の名前 操作を AI に 見せると、 AI は ツールを 選び間 違えやすくなり、 指示文も 長くなります。 通話の 用途に 要る ツールだけを 渡します。 - 書き換えの
前の : 予約を確認 作る ・取り消すなど、 相手の システムを 書き換える ツールは、 内容を 読み上げて 相手の 同意を 得てから 使います (聞き取った 内容の 読み上げ確認) 。 - 返す量: ツールの
結果は、 そのまま AI の 入力に なります。 長い 結果を 返すと、 返事が 遅くなるうえ、 AI が 要らない 情報を 話してしまう おそれが あります。 答えるのに 要る 項目だけを 返します。
voicast での作り方
voicast では、
URL とPOST /v1/connections で
curl https://api.voicast.jp/v1/connections \
-H "Authorization: Bearer $VOICAST_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "connector": "http", "secret": "<API キー>", "input": { "base_url": "https://api.example.com", "header": "Authorization" } }'保存したconnectors に{ "connection": "con_…", "actions": ["*"] } とtimeout を
会話中のtools に
"tools": [
{
"name": "create_booking",
"description": "予約を入れる。空きを伝えて、相手が日時を選んだら使う",
"url": "https://saas.example.com/voicast/tools",
"confirm": true,
"parameters": { "properties": { "start": { "type": "string" }, "name": { "type": "string" } }, "required": ["start", "name"] }
}
]voicast はcall.tenant.external_id で
なhttps://api.voicast.jp/mcp)
よくある質問
相手のシステムが MCP サーバーしか公開していないときは、どうしますか。
会話中の
URL と API キーの連携と、会話中のツールはどちらがよいですか。
相手の
ツールが失敗したら、AI は何と言いますか。
失敗や