Infobip MCP サーバーの使用

このページでは、AI エージェントを Infobip MCP サーバーに接続し、認証して使用可能なエンドポイントの使用を開始する方法について説明します。

Infobip MCP サーバーの使用を開始する

MCP サーバーを使用するには、Infobip アカウントが必要です。

1. 無料の Infobip アカウントにサインアップします (opens in a new tab)。

   • 無料試用版アカウントには、MCP のテストに使用できるメッセージング ユニットが含まれています。
   • 無料試用期間中は、確認済みの番号にのみメッセージを送信できます。
   
   

2. サインイン (opens in a new tab)したら、[開発者ツール] で API キー にアクセスしてスコープを調整します。

   • アカウントが作成されると、自動的に APIキー が割り当てられます。
   • APIキー には、統合する MCP サーバーに応じて正しいスコープを含める必要があります。たとえば、「SMS MCP サーバー」を使用する場合、APIキーにはsms:message:sendスコープが必要です。スコープの詳細については、API 権限付与 を参照してください。
   
   

3. APIキー を MCP クライアントに追加します。例えば：

   Authorization: App ${INFOBIP_API_KEY}
   
   

4. available endpointsのリストから希望のチャネルを選択します。

実践的なチュートリアルに従うには、「 リモート MCP サーバーと MCP クライアントの統合」を参照してください。

認証

APIキー または OAuth 2.1 を使用して MCP サーバーに接続できます。

APIキー

MCP クライアントが構成変数または環境変数を使用したヘッダーの追加をサポートしている場合は、Infobip APIキー を使用できます。

• [API キー (opens in a new tab)] ページからAPIキーをコピーします。
• MCPクライアントに「権限付与」ヘッダーとして追加します。

OAuthの2.1

Infobip MCP サーバーは、OAuth 2.1 認証 をサポートしています。使用するには、次のようにします。

1. MCP クライアントは、OAuth 2.1 認証と動的 OAuth 承認サーバー メタデータ検出 (opens in a new tab) をサポートする必要があります。
2. 認証資格情報を指定せずに Infobip MCP サーバーに接続するように MCP クライアントを構成します。
3. クライアントは OAuth フローを自動的に開始し、認証のために Infobip OAuth サーバーにリダイレクトする必要があります。

サポートされているスコープの検出

一部の MCP クライアントでは、自動 "scopes_supported" 検出がサポートされていない場合があります。その場合は、クライアントでスコープを手動で構成する必要があります。

特定の MCP サーバーのスコープは、承認サーバーのメタデータにあります。

{server-url}/.well-known/oauth-authorization-server

たとえば、https://mcp.infobip.com/sms/.well-known/oauth-authorization-server エンドポイントは、Infobip SMS MCP サーバーでサポートされているスコープを返します。

使用可能なエンドポイント

交通手段

Infobip MCP サーバは、クライアントの機能に応じて、要求と応答を処理するためのさまざまな転送方法をサポートしています。

• HTTP: ストリーミング可能な HTTP トランスポート (opens in a new tab) (既定値)
• SSE (サーバー送信 Events): ストリーミング応答に使用します。エンドポイント URL に /sse を追加します。

  {server-url}/.well-known/oauth-authorization-server
• STDIO トランスポート ブリッジ: エージェントがリモート MCP サーバーをサポートしていない場合は、mcp-remote (opens in a new tab) のようなブリッジを使用できます。

構成例 (HTTP)

次の構成は、HTTP 経由で Infobip MCP サーバーに直接接続する方法を示しています。これは、リモート MCP サーバーをサポートする AI アプリケーションで使用される最も一般的なセットアップです。

{
 "mcpServers": {
   "ib-whatsapp": {
     "type": "http",
     "url": "https://mcp.infobip.com/whatsapp",
     "headers": {
       "Authorization": "App ${INFOBIP_API_KEY}"
     }
   }
 }
}

構成例 (STDIO トランスポート ブリッジ)

MCP クライアントがリモート接続をサポートしていない場合は、mcp-remoteなどの STDIO ブリッジを使用できます。

{
   "mcpServers": {
       "infobip-whatsapp": {
           "command": "npx",
           "args": [
               "mcp-remote",
               "https://mcp.infobip.com/whatsapp",
               "--header",
               "Authorization:${AUTH_HEADER}"
           ],
           "env": {
               "AUTH_HEADER": "App <Your Infobip API key here>"
           }
       }
   }
}

成功したWhatsAppメッセージは次のようになります。

トラブルシューティング

認証と承認の問題

• 有効な Infobip アカウントと 正しいスコープでAPIキー があることを確認します。
• OAuth 2.1 を使用している場合は、MCP クライアントが動的メタデータ検出をサポートしていることを確認します。
• 必要なスコープが正しく構成されていることを確認します。

メッセージ配信の問題

• 受信者の電話番号が有効で、到達可能であることを確認してください。
• 無料試用期間中は、確認済みの番号にのみメッセージを送信できます。

エラーコード

• 完全なエラー コードの一覧と説明については、「応答の状態とエラー コード」を参照してください。

次のステップ

実践的な学習と実践的な例を続けてください。

• Tutorials セクションには、次のようなガイドが含まれています。
  • MCP サーバーでの SMS、WhatsApp、および Viber メッセージの送信
  • OpenAI エージェント SDK を使用した マルチチャネル キャンペーン の実行

• デモ プロジェクトについては Infobip MCP code examples ページを参照するか、Infobip MCP GitHub リポジトリ (opens in a new tab) に直接アクセスしてください。