MCP Server

🚀 Vapi MCP Server

VapiのModel Context Protocolサーバーを使用すると、関数呼び出しを通じてVapi APIと統合することができます。

🚀 クイックスタート

Claude Desktopのセットアップ

1. Claude Desktopを開き、CMD + ,を押して設定に移動します。
2. 開発者タブをクリックします。
3. 設定の編集ボタンをクリックします。
4. これにより、ファイルエクスプローラーでclaude_desktop_config.jsonファイルが開きます。
5. Vapiダッシュボード（https://dashboard.vapi.ai/org/api-keys）からVapi APIキーを取得します。
6. claude_desktop_config.jsonファイルに以下を追加します。詳細はこちらを参照してください。
7. 設定ファイルを編集した後、Claude Desktopを再起動します。

{
  "mcpServers": {
    "vapi-mcp-server": {
      "command": "npx",
      "args": [
          "-y",
          "@vapi-ai/mcp-server"
      ],
      "env": {
        "VAPI_TOKEN": "<your_vapi_token>"
      }
    }
  }
}

💻 使用例

Claude Desktopでの使用例

1. Vapiダッシュボード（https://dashboard.vapi.ai/phone-numbers）を使用して電話番号を作成またはインポートします。
2. Vapiダッシュボード（https://dashboard.vapi.ai/assistants）で既存の「Appointment Scheduler」テンプレートを使用して新しいアシスタントを作成します。
3. Claude DesktopがVapi MCPサーバーを使用するように設定し、Claude Desktopアプリを再起動します。
4. Claudeに通話の開始または予約を依頼します。以下に例を示します。

例1: 即時通話の依頼

I'd like to speak with my ShopHelper assistant to talk about my recent order. Can you have it call me at +1234567890?

例2: 将来の通話の予約

I need to schedule a call with Mary assistant for next Tuesday at 3:00 PM. My phone number is +1555123456.

リモートSSE接続

Server-Sent Events (SSE) トランスポートを介してVapiのMCPサーバーに接続するには：

• 任意のMCPクライアントからhttps://mcp.vapi.ai/sseに接続します。
• リクエストヘッダーにVapi APIキーをベアラートークンとして含めます。
• ヘッダーの例：Authorization: Bearer your_vapi_api_key_here

この接続により、ローカルサーバーを実行せずにリモートでVapiの機能にアクセスできます。

🔧 技術詳細

開発

# 依存関係のインストール
npm install

# サーバーのビルド
npm run build

claude_desktop_config.jsonを更新して、ローカルサーバーを使用するようにします。

{
  "mcpServers": {
    "vapi-local": {
      "command": "node",
      "args": [
        "<path_to_vapi_mcp_server>/dist/index.js"
      ],
      "env": {
        "VAPI_TOKEN": "<your_vapi_token>"
      }
    },
  }
}

テスト

このプロジェクトには2種類のテストがあります。

単体テスト

単体テストでは、Vapiへの実際のAPI呼び出しを行わずにMCPサーバーをテストするためにモックを使用します。

# 単体テストの実行
npm run test:unit

エンドツーエンドテスト

エンドツーエンドテストでは、Vapiへの実際のAPI呼び出しを伴う完全なMCPサーバーを実行します。

# Vapi APIトークンの設定
export VAPI_TOKEN=your_token_here

# エンドツーエンドテストの実行
npm run test:e2e

注意: エンドツーエンドテストでは、環境に有効なVapi APIトークンを設定する必要があります。

すべてのテストの実行

すべてのテストを一度に実行するには：

npm test

📚 ドキュメント

参考資料

• VAPI Remote MCP Server
• VAPI MCP Tool
• Model Context Protocol
• Claude Desktop

サポートされるアクション

Vapi MCPサーバーは、以下の統合ツールを提供します。

アシスタントツール

• list_assistants：すべてのVapiアシスタントをリストします。
• create_assistant：新しいVapiアシスタントを作成します。
• get_assistant：IDでVapiアシスタントを取得します。

通話ツール

• list_calls：すべてのVapi通話をリストします。
• create_call：発信通話を作成します。
• get_call：特定の通話の詳細を取得します。

⚠️ 重要提示

create_callアクションは、即時実行または将来の時間に通話を予約することをサポートしています。

電話番号ツール

• list_phone_numbers：すべてのVapi電話番号をリストします。
• get_phone_number：特定の電話番号の詳細を取得します。