Vonage API Bindings MCP Server

Vonage API MCP サーバー

利用可能なツール

この MCP サーバーは、以下のツールを通じてさまざまな Vonage API の機能を利用できます。

カテゴリ	ツール名	説明
アカウント管理	balance	Vonage アカウントの残高を取得します
	list-applications	API キーに関連付けられたすべてのアプリケーションと、その設定および機能の一覧を取得します
	create-application	指定した名前で新しい Vonage アプリケーションを作成します
	list-purchased-numbers	アカウントに関連付けられた電話番号とそのメタデータの一覧を取得します
番号管理	search-available-numbers	特定の国で Vonage から購入可能な電話番号を検索します
	link-number-to-vonage-application	所有している番号を特定の Vonage アプリケーションにリンクします
レポート	get-records-report	Vonage Reports API からアクティビティレコードを取得します（日付または ID によるクエリ）
メッセージングと通信	SMS	Vonage を使用して SMS メッセージを送信します
	whatsapp-send-text	WhatsApp 経由でテキストメッセージを送信します
	whatsapp-send-text-with-sms-failover	SMS への自動フェイルオーバー機能付きで WhatsApp テキストメッセージを送信します
	rcs-send-text	RCS 経由でテキストメッセージを送信します
	rcs-send-text-with-sms-failover	SMS への自動フェイルオーバー機能付きで RCS テキストメッセージを送信します
	outbound-voice-message	Vonage で発信音声メッセージを送信します
データの可視化	make-chart	取得したデータを基にグラフを作成します

使用例

アカウント残高を確認する

Can you check my Vonage account balance?

電話番号の一覧を表示する

Can you list out the numbers that I own for Vonage?

購入可能な電話番号を検索する

Can you search for available Vonage numbers to purchase in the US?

または、条件を指定して検索します。

Can you search for available Vonage numbers in the US with SMS and VOICE features?

Can you search for available numbers in GB starting with pattern "44207*"?

アプリケーションの一覧を表示する

Can you list out the applications on my account?

新しいアプリケーションを作成する

Can you create a new Vonage application called "My Chat App"?

または、システムに名前を提案してもらいます。

Can you create a new Vonage application?

レコードレポートを取得する

日付範囲でクエリします。

Can you get a report of all outbound SMS sent over the last week?

特定の ID でクエリします。

Can you get the report for Voice Call ID 1234-abcd-5678-efgh?

SMS を送信する

Can you send an SMS to +1234567890 with the message "Hello from Vonage!"?

WhatsApp メッセージを送信する

Can you send a WhatsApp message to +1234567890 with the message "Hello from Vonage over WhatsApp!"?

SMS へのフェイルオーバー機能付きで WhatsApp メッセージを送信する

Can you send a WhatsApp message with SMS failover to +1234567890 saying "Hello from Vonage with failover!"?

RCS メッセージを送信する

Can you send an RCS message to +1234567890 with the message "Hello from Vonage via RCS!"?

SMS へのフェイルオーバー機能付きで RCS メッセージを送信する

Can you send an RCS message with SMS failover to +1234567890 saying "Hello from Vonage RCS with fallback!"?

グラフを生成する

Please create a chart showing all the outbound SMS sent over the last week.

MCP サーバーをセットアップする

• VS Code
• Cursor
• Windsurf
• Claude Desktop

MCP サーバーの詳細は次のようになります。

"vonage-mcp-server-api-bindings": {
    "type": "stdio",
    "command": "npx",
    "args": [
        "-y",
        "@vonage/vonage-mcp-server-api-bindings"
    ],
    "env": {
        "VONAGE_APPLICATION_ID": "<YOUR_VONAGE_APPLICATION_ID>",
        "VONAGE_PRIVATE_KEY64": "<YOUR_VONAGE_PRIVATE_KEY64>",
        "VONAGE_API_KEY": "<YOUR_VONAGE_API_KEY>",
        "VONAGE_API_SECRET": "<YOUR_VONAGE_API_SECRET>",
        "VONAGE_VIRTUAL_NUMBER": "<YOUR_VONAGE_VIRTUAL_NUMBER>",
        "VONAGE_WHATSAPP_NUMBER": "<YOUR_VONAGE_WHATSAPP_NUMBER>",
        "RCS_SENDER_ID": "<YOUR_RCS_SENDER_ID>"
    }
}

秘密鍵のエンコード

VONAGE_PRIVATE_KEY64 には、アプリケーションの秘密鍵ファイルを 1 行の Base64 形式で指定する必要があります。 次のいずれかのコマンドをローカルで実行し、private.key を鍵ファイルのパスに置き換えて、出力を設定に貼り付けてください。

macOS：

base64 -i private.key

Linux：

base64 -w 0 private.key

Windows PowerShell：

[Convert]::ToBase64String([IO.File]::ReadAllBytes((Resolve-Path .\private.key)))

セキュリティ

STDIO トランスポート

このサーバーはローカルで実行され、STDIO 経由で MCP クライアント（VS Code、Cursor、Claude Desktop など）と通信します。ツール呼び出しとその応答は、2 つのプロセス間をプレーンテキストの JSON-RPC としてやり取りされます。このチャネルにはトランスポート層の暗号化や認証はありません。ローカル MCP サーバーはそのように動作する設計です。

信頼できる単一ユーザーのマシンであれば安全であり、これがこのサーバーの想定される実行方法です。次の点に留意してください。

• 同じマシン上で十分な権限を持つプロセスは、STDIO ストリームを読み取ったり改ざんしたりできます。マシンが侵害された場合、サーバーは通過するデータを保護できません。
• 複数ユーザーで共有する環境、またはコンテナ化された環境では、ほかのユーザーやワークロードからプロセスを監視できる可能性があります。ほかに実行されているものすべてを信頼できる環境でのみ、サーバーを実行してください。

認証情報の保存

上記のセットアップでは、VONAGE_PRIVATE_KEY64 を含む Vonage の認証情報が、MCP クライアントの設定ファイル（たとえば claude_desktop_config.json や .cursor/mcp.json）にプレーンテキストで保存されます。ユーザーとして実行されているプロセスであれば、そのファイルを読み取ることができ、誤って漏えいしやすい状態です。

• VONAGE_PRIVATE_KEY64 は SSH 秘密鍵と同様に扱ってください。これを持つ人は誰でも、あなたの Vonage アプリケーションとして操作できます。
• 設定ファイルが .cursor/mcp.json や .vscode/mcp.json などのプロジェクト内にある場合は、そのプロジェクトの .gitignore に追加し、決してコミットされないようにしてください。
• クラウド同期サービス（iCloud、Dropbox、OneDrive、Google Drive）は、設定ディレクトリを気付かないうちにアップロードする場合があります。これらのディレクトリを同期対象から除外するか、認証情報を含む設定ファイルを同期対象のフォルダー外に保存してください。
• さらに強固に保護するには、秘密情報を設定ファイルに一切保存しないようにします。以下に方法を示します。

設定ファイルに秘密情報を保存しない

このサーバーは環境変数からのみ認証情報を読み取るため、目標は、ファイルに書き込まずに MCP クライアントから起動時に VONAGE_PRIVATE_KEY64 と VONAGE_API_SECRET を渡すことです。これにより、保存時の認証情報を保護できます。サーバーの実行中は、認証情報は引き続き環境変数に含まれます。

macOS（Keychain）

ログイン用 Keychain に秘密情報を保存します。秘密鍵はターミナルのプロンプトに貼り付けるには長すぎるため、最初のコマンドでは鍵ファイルから直接読み込みます。2 つ目のコマンドの末尾には -w が付いており、security に API シークレットの入力を求めさせて、シェルの履歴に残らないようにします。

security add-generic-password -a "$USER" -s vonage-mcp-private-key64 -w "$(base64 -i private.key)"
security add-generic-password -a "$USER" -s vonage-mcp-api-secret -w

次に、Keychain から秘密情報を読み込むシェル経由でサーバーを起動し、env には秘密でない値だけを残します。

"vonage-mcp-server-api-bindings": {
    "type": "stdio",
    "command": "/bin/sh",
    "args": [
        "-c",
        "VONAGE_PRIVATE_KEY64=$(security find-generic-password -s vonage-mcp-private-key64 -w) || exit 1; VONAGE_API_SECRET=$(security find-generic-password -s vonage-mcp-api-secret -w) || exit 1; export VONAGE_PRIVATE_KEY64 VONAGE_API_SECRET; exec npx -y @vonage/vonage-mcp-server-api-bindings"
    ],
    "env": {
        "VONAGE_APPLICATION_ID": "<YOUR_VONAGE_APPLICATION_ID>",
        "VONAGE_API_KEY": "<YOUR_VONAGE_API_KEY>",
        "VONAGE_VIRTUAL_NUMBER": "<YOUR_VONAGE_VIRTUAL_NUMBER>",
        "VONAGE_WHATSAPP_NUMBER": "<YOUR_VONAGE_WHATSAPP_NUMBER>",
        "RCS_SENDER_ID": "<YOUR_RCS_SENDER_ID>"
    }
}

サーバーを初めて起動するとき、security による項目へのアクセスを許可するか macOS から尋ねられる場合があります。以降の起動時に確認を求められないよう、常に許可を選択してください。

VS Code（入力変数）

VS Code では、.vscode/mcp.json またはユーザープロファイルの mcp.json で入力変数を使用すると、サーバーの初回起動時に秘密情報の入力を求め、これを安全に保存できます。

{
  "inputs": [
    {
      "type": "promptString",
      "id": "vonage-private-key64",
      "description": "Vonage private key (base64)",
      "password": true
    },
    {
      "type": "promptString",
      "id": "vonage-api-secret",
      "description": "Vonage API secret",
      "password": true
    }
  ],
  "servers": {
    "vonage-mcp-server-api-bindings": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@vonage/vonage-mcp-server-api-bindings"],
      "env": {
        "VONAGE_APPLICATION_ID": "<YOUR_VONAGE_APPLICATION_ID>",
        "VONAGE_API_KEY": "<YOUR_VONAGE_API_KEY>",
        "VONAGE_PRIVATE_KEY64": "${input:vonage-private-key64}",
        "VONAGE_API_SECRET": "${input:vonage-api-secret}"
      }
    }
  }
}

セットアップ例にある残りの秘密でない変数は、必要に応じて env に追加してください。VS Code は、入力変数を使用するサーバーを Copilot ハーネスセッションに転送しません。詳しくは、VS Code MCP 設定リファレンスを参照してください。

Linux および Windows

どちらの OS にも、コマンドラインクライアントが標準でインストールされ、動作する秘密情報ストアはありません。GNOME Keyring の secret-tool や PowerShell SecretManagement などをすでに使用している場合は、macOS の例と同じ方法を適用できます。秘密情報を読み込み、サーバーの起動前にエクスポートするシェル経由でサーバーを起動してください。それ以外の場合は、上記のファイル取り扱いに関するガイダンスに従ってください。