Vapi クライアント MCP

クライアントレベルの Vapi インバウンド応答アシスタントをプロビジョニングするためのローカル stdio MCP サーバーです。ホスト型の Vapi MCP ツールセットではなく、Vapi REST API をラップします。

最初のテンプレートは即座に応答し、自身を AI と識別し、発信者名、折り返し番号、理由、折り返し時間帯を取得してから、利用可能な転送先を提案するか、明確に説明された折り返しを提案します。通話終了データは公開ウェブフックに送信するか、後で CRM 処理するために Vapi に保持できます。

実装内容

クライアントレコードは clients/<slug>.json に保存されます。これらには Vapi リソース ID と機密ではないビジネス設定が含まれ、Vapi キーやプロバイダー認証情報は決して含まれません。これらの JSON ファイルは、ビジネスメタデータ自体をコミットしても問題ない場合、設定 as コードに適しています。

Related MCP server: RetellAI MCP Server

インストールと実行

Node.js 20 以降が必要です。

cd /home/blaine/projects/vapi-mcp
npm install
npm run check
npm run build
export VAPI_API_KEY="your private server-side Vapi key"
npm start

このサーバーは stdio 上で MCP を話すため、標準出力はプロトコルメッセージ用に予約されています。ログは標準エラーに出力されます。

MCP ホストの場合は、examples/mcp-client.json をコピーし、絶対パスを置き換え、実際のキーをホストのプライベート設定またはシークレットマネージャーにのみ配置してください。チェックインされた例と .env.example にはプレースホルダーのみが含まれています。このプロジェクトは .env ファイルを自動的に読み込みません。

最初のクライアントワークフロー

ツールを次の順序で呼び出します:

1. provision_client

2. set_structured_outputs

3. attach_phone

4. attach_tools (転送、折り返し、カレンダー、CRM アクション用)

5. smoke_test_call

6. list_client_status

provision_client 引数の例:

{
  "clientSlug": "acme-hvac",
  "businessName": "Acme HVAC",
  "trade": "HVAC",
  "timezone": "America/New_York",
  "businessHours": "Monday-Friday 08:00-17:00; closed federal holidays",
  "transferNumber": "+12125550123",
  "crm": "GoHighLevel",
  "webhookUrl": "https://example.com/webhooks/vapi/end-of-call"
}

outputDefinitions がない場合、set_structured_outputs は templates/inbound-answering.json からスキーマをインストールします。以下を抽出します:

• callerName

• callbackNumber

• reason

• callbackWindow

• transferOutcome

• complete

既存の番号をバインドする:

{
  "clientSlug": "acme-hvac",
  "phoneNumberId": "00000000-0000-4000-8000-000000000000"
}

または、プロバイダー固有の POST /phone-number ボディを phoneConfiguration として渡します。サーバーは指定された assistantId をクライアントのアシスタント ID で上書きします。生の Twilio、Telnyx、Vonage、SIP シークレットよりも Vapi 認証情報 ID を優先してください。一時的な MCP 引数はクライアントレコードに書き込まれません。

attach_tools は完全な Vapi POST /tool 定義、既存のツール UUID、またはその両方を受け入れます。これにより、独自の狭いローカルスキーマを発明する代わりに、Vapi のプロバイダー固有のツールユニオンが意図的に保持されます。Vapi ツールの応答が成功した場合のみ、その ID がアシスタントに添付されます。

スモークパス

smoke_test_call は実際の発信通話を作成するため、Vapi およびキャリアの料金が発生する可能性があります。confirmBillableCall が正確に true の場合のみ実行されます。

{
  "clientSlug": "acme-hvac",
  "customerNumber": "+12125550999",
  "waitSeconds": 45,
  "confirmBillableCall": true
}

waitSeconds: 0 の場合、ツールはキューに入った通話を即座に返します。1〜55 秒の場合、GET /call/:id をポーリングし、現在のステータス、終了理由、トランスクリプト、利用可能な場合は構造化データを返します。承認された番号に対してのみテストし、適用される通話、録音同意、プライバシー規則に従ってください。

テンプレートの動作と制限

テンプレートはアシスタントのファーストメッセージを使用するため、開示は即座に行われます。プロンプトは音声による意図ルーティングを使用し、ツール確認なしで転送、予約、折り返し、CRM 書き込みが成功したと主張しないようにモデルに指示します。開閉ステータスが不明な場合、推測するのではなく折り返しをキャプチャします。

含まれる時間はプロンプトコンテキストであり、決定的な休日/カレンダーエンジンではありません。実際の転送と折り返しの実行には、添付された Vapi ツールが必要です。ウェブフックは公開されており、Vapi end-of-call-report ペイロードを受け入れられる必要があります。

検証

npm run check

フォーカスされたテストでは、8 つの MCP ツールすべてを列挙し、テンプレートコントラクトを検査し、モック Vapi クライアントに対して REST ワークフローを実行し、ベアラーキーの編集を検証します。このリポジトリには秘密鍵、プロビジョニングされた番号、同意済みの宛先が含まれていないため、実際の Vapi 通話は行われません。

ソース

実装は、アシスタント、電話番号、カスタムツール、構造化出力、通話、サーバーイベント に関する Vapi の現在の公式ドキュメントに従っています。