MCPを使用して、AIエージェントをBroadNetに接続します。

MCPサーバーとは

Model Context Protocol（MCP）は、AIエージェントが外部ツールを検出して呼び出すことができるオープン標準です。BroadNet MCPサーバーはリモートのMCPサーバーです。クライアントはHTTPSを介してサーバーに接続し、提供されているツールをリストアップして、ユーザーに代わってそれらを呼び出します。

これらのツールは、APIリファレンスおよびOpenAPI仕様に記載されているものと同じBroadNet APIに対応しています。メッセージの送信、WhatsAppテンプレートの利用、配信レポートの読み取りなどが可能です。エージェントは、お客様が提供するトークンの権限に基づいて、お客様自身のコードと全く同じように動作します。

2種類のMCPサーバー：ナレッジおよびメッセージング

BroadNetは2つのMCPサーバーを運用しています。本ページで説明しているメッセージングサーバーはお客様のアカウントに対して動作します。ナレッジサーバーは公開されており、エージェントはログインなしでBroadNetの対応国・地域、送信元IDのルール、公開リスト料金、規制、および会社情報について質問できます。

ターミナルからナレッジサーバーを試行してください：まずinitialize handshakeを行い、次にtool callを実行します。

curl -X POST https://www.broadnet.me/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize",
       "params":{"protocolVersion":"2025-06-18","capabilities":{},
                 "clientInfo":{"name":"curl","version":"1.0"}}}'

curl -X POST https://www.broadnet.me/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-06-18" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"sender_id_rules","arguments":{"country":"ae"}}}'

エンドポイントと認証

すべてのアカウントに共通のエンドポイントは https://mcp.broadnet.me/mcp です。すべてのリクエストで、AuthorizationヘッダーにBroadNetトークンを含める必要があります。

トークンはBroadNetアカウントから取得します。デモでは、BroadAdminポータルのIntegrations → MCP Integrationにて「Get temporary key」をクリックすることで生成されます。なお、ポータルには、永続的なキーはアカウント管理者またはマスターアカウントによって発行される旨が記載されています。

ヘッダーのないリクエストはプロトコルレベルで拒否されます。認証されていない初期化コールに対するサーバーからの実際の応答は以下の通りです：

event: message
data: {"jsonrpc":"2.0","id":1,"error":{"code":-32001,
  "message":"Authorization bearer token is required. Connect with an
  'Authorization: Bearer <BroadNet token>' header."}}

MCPクライアントを接続

ほとんどのMCPクライアントは、サーバーURLとリクエストヘッダーを含むJSON設定を使用します。一般的な入力例は以下の通りです：

{
  "mcpServers": {
    "broadnet": {
      "type": "http",
      "url": "https://mcp.broadnet.me/mcp",
      "headers": {
        "Authorization": "Bearer ${BROADNET_TOKEN}"
      }
    }
  }
}

クライアントを使用せずに接続をテストするには、自身でMCP初期化リクエストを送信してください：

curl -X POST https://mcp.broadnet.me/mcp \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize",
       "params":{"protocolVersion":"2025-06-18","capabilities":{},
                 "clientInfo":{"name":"curl","version":"1.0"}}}'

デモの内容

プロダクトチームによるデモ動画では、CursorをMCPクライアントとして使用し、全フローを5つのステップで解説しています：

1. 1
   サインイン

   BroadNetアカウントを使用してBroadAdminポータルにログインしてください。

2. 2
   キーと設定を取得する

   オープンな統合 → MCP統合、一時的なキーを生成し、用意されたクライアント設定をコピーします。

3. 3
   クライアントにサーバーを追加する

   MCPクライアントで新しいMCPサーバーを追加し、設定をmcp.jsonに貼り付けます。URLはhttps://mcp.broadnet.me/mcp、Bearerヘッダーを使用してください。

4. 4
   ツールを確認する

   クライアントが接続してBroadNetツールを一覧表示し、それぞれをオンまたはオフに切り替えられます。

5. 5
   自然な言葉で質問する

   ユーザーがエージェントに対し、特定の番号へWhatsAppメッセージを送信するよう指示します。エージェントはWhatsApp送信ツールを選択し、APIがメッセージ受理のHTTP 200を返し、メッセージはビジネスアカウントからWhatsAppに届きます。

記録によると、クライアントは380のBroadNetツールを報告しており、その中にはsend_message、post_sms_send、post_whatsapp_message_send、get_whatsapp_template_list、post_whatsapp_template_send、post_rcs_message_send、post_telegram_message_send、post_instagram_message_send、post_messenger_message_send、post_push_message_send、およびget_report_deliveryが含まれます。正確なリストは、サーバーのバージョンおよびお客様のアカウントによって異なります。

録音内容をナレーション化したバージョンにより、概要カードが追加されます。1つのMCPエンドポイントで、すべてのエージェントが同じコピー＆ペーストの手順を使用できます。

セキュリティに関する注意事項

• トークンは送信資格情報です

  これを持っている人は誰でも、お客様のアカウントからメッセージを送信できます。パスワードと同様に保管し、共有ファイルやコミットされたファイルには決して保存しないでください。

• テストには一時的なキーを希望

  テスト中は一時的なキーを使用し、本番用エージェント用の永続的なキーについてはアカウント管理者に依頼してください。

• 必要なツールのみを有効化

  MCPのクライアントなら、個々のツールをオフに切り替えることができます。SMSのみを送信するエージェントには、テンプレート、オンボーディング、またはアカウントツールは必要ありません。

• ヒューマン・イン・ザ・ループを維持

  エージェントは自然言語の指示に従って動作します。メッセージを送信するツール、特に多数の受信者に送信するツールを使用する前に、クライアントに確認を求めるように設定してください。

• 漏洩したトークンを無効化

  トークンが漏洩した場合は、アカウント管理者またはBroadNetサポートに連絡して、トークンの失効と新しいトークンの発行を行ってください。

関連

質問