Vapi MCP Server

Vapi MCP サーバー

Model Context Protocol を使用して、Vapi で AI 音声アシスタントや電話エージェントを構築できます。

セットアップ

MCP サーバーには Vapi API キーが必要です。Vapi ダッシュボードで取得してください。

ローカルサーバー（stdio）

ローカルの stdio サーバーに対応している任意の MCP クライアントを、次のコマンドを実行するように設定します。

npx -y @vapi-ai/mcp-server

サーバーの環境で VAPI_TOKEN を設定します。MCP クライアントの設定形式は異なりますが、サーバーの定義は一般的に次のようになります。

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

リモートサーバー（Streamable HTTP）

リモート MCP サーバーに対応しているクライアントは、直接接続できます。

• URL：https://mcp.vapi.ai/mcp
• ヘッダー：Authorization: Bearer your_vapi_api_key_here

クライアントごとの設定例

Claude Code

claude mcp add -e VAPI_TOKEN=your_vapi_token vapi -- npx -y @vapi-ai/mcp-server

Claude Desktop

上記のローカルサーバー設定を Claude Desktop の設定ファイルで使用します。代わりに stdio ブリッジ経由でホストされているサーバーに接続するには、次のようにします。

{
  "mcpServers": {
    "vapi": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.vapi.ai/mcp",
        "--header",
        "Authorization: Bearer ${VAPI_TOKEN}"
      ],
      "env": {
        "VAPI_TOKEN": "<your_vapi_token>"
      }
    }
  }
}

オプションのエージェントスキル

skill ディレクトリには、Agent Skills に対応した AI コーディングエージェント向けの再利用可能な手順が含まれています。ホストのスキルインストール手順に従ってインストールしてください。

Claude Code の場合：

mkdir -p ~/.claude/skills/vapi
curl -o ~/.claude/skills/vapi/SKILL.md https://raw.githubusercontent.com/VapiAI/mcp-server/main/skill/SKILL.md

---

使用例

音声アシスタントを作成する

MCP に対応したエージェントに次のように依頼します。

I want to build a voice assistant that can schedule appointments

発信する

Call +1234567890 using my appointment reminder assistant with these details:
- Customer name: Sarah Johnson
- Appointment date: March 25th
- Appointment time: 2:30 PM

将来の通話をスケジュールする

Schedule a call with my support assistant for next Tuesday at 3:00 PM to +1555123456

---

アシスタントのプロンプトで変数値を使用する

create_call アクションでは、assistantOverrides.variableValues を通じて動的変数を渡せます。アシスタントのプロンプトでは、二重波括弧を使用します：{{variableName}}。

変数を使ったプロンプトの例

Hello {{customerName}}, this is a reminder about your appointment on {{appointmentDate}} at {{appointmentTime}} with {{doctorName}}.

デフォルト変数

以下の変数は自動的に利用できます（渡す必要はありません）。

• {{now}} - 現在の日付と時刻（UTC）
• {{date}} - 現在の日付（UTC）
• {{time}} - 現在の時刻（UTC）
• {{month}} - 現在の月（UTC）
• {{day}} - 現在の日（UTC）
• {{year}} - 現在の年（UTC）
• {{customer.number}} - 顧客の電話番号

高度な日付と時刻の書式設定については、Vapi のドキュメントをご覧ください。

---

リモート MCP サーバー

任意の MCP クライアントから、Vapi のホスト型 MCP サーバーに接続できます。

Streamable HTTP（推奨）

• URL：https://mcp.vapi.ai/mcp
• ヘッダー：Authorization: Bearer your_vapi_api_key_here

SSE（非推奨）

• URL：https://mcp.vapi.ai/sse
• ヘッダー：Authorization: Bearer your_vapi_api_key_here

---

利用可能なツール

アシスタント

ツール	説明
list_assistants	すべてのアシスタントを一覧表示
get_assistant	ID でアシスタントを取得
create_assistant	新しいアシスタントを作成
update_assistant	アシスタントを更新

通話

ツール	説明
list_calls	通話履歴を一覧表示
get_call	通話の詳細を取得
create_call	発信を開始（即時またはスケジュール設定）

電話番号

ツール	説明
list_phone_numbers	電話番号を一覧表示
get_phone_number	電話番号の詳細を取得

ツール（関数呼び出し）

ツール	説明
list_tools	カスタムツールを一覧表示
get_tool	ツールの詳細を取得
create_tool	API 連携用のツールを作成
update_tool	ツールを更新

---

開発

# Install dependencies
npm install

# Build
npm run build

# Test with MCP inspector
npm run inspector

ローカル開発設定

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

テスト

# Safe default suite (build, mocked execution, contract, and stdio compatibility)
npm test

# Unit tests (mocked public tool execution and catalog contract)
npm run test:unit

# Documentation/tool-catalog consistency lint
npm run test:docs

# Full TypeScript check (production and test code)
npm run typecheck

# Build and run local stdio protocol compatibility tests (no Vapi API calls)
npm run test:stdio

# Pack, install, and launch the package from a clean temporary consumer
npm run test:package

# Live read-only API tests
export VAPI_TOKEN=your_token_here
npm run test:live:readonly

# Live mutating tests (creates and cleans up disposable assistants and tools)
export VAPI_TOKEN=your_test_org_token_here
npm run test:live:mutating

---

参考資料

• Vapi ドキュメント
• Vapi ダッシュボード
• Vapi リモート MCP サーバー
• Model Context Protocol