Logo
NTT CPaaS MCP サーバー
NTT CPaaS MCP サーバーの使用

NTT CPaaS MCP サーバーの使用

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


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

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

  1. 無料の NTT CPaaS アカウントにサインアップします (opens in a new tab)。
    • 無料試用版アカウントには、MCP のテストに使用できるメッセージング ユニットが含まれています。
    • 無料試用期間中は、確認済みの番号にのみメッセージを送信できます。

  2. 認証方法を選択します。
  3. 使用可能なエンドポイント のリストから MCP サーバーを選択します。

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

認証

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

APIキー

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

NTT CPaaS APIキーについて:

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

APIキーでMCPサーバーを使用するには:

  1. [API キー (opens in a new tab)] ページからAPIキーをコピーします。

  2. 選択した MCP クライアントにキーを「権限付与」ヘッダーとして追加します。

    Authorization: App ${INFOBIP_API_KEY}

  3. MCP クライアントを再起動します。


OAuthの2.1

NTT CPaaS MCPサーバは、OAuth 2.1認証に対応しています。構成が完了すると、MCP クライアントは NTT CPaaS MCP サーバーに 認証資格情報を提供せずに接続できるようになります。

MCP クライアントは、以下をサポートする必要があります。

OAuth で MCP サーバーを使用するには:

  1. MCP サーバー構成にヘッダーが含まれていないことを確認します。

    {
  "mcpServers": {
    "infobip-sms": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.infobip.com/sms"
      ]
    }
  }
}

  2. MCP クライアントを再起動します。OAuth フローが自動的に開始され、認証のために NTT CPaaS OAuth サーバーにリダイレクトされます。

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

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

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

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

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

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

NTT CPaaS MCP サーバーは、一貫した基本URLパターンであるhttps://mcp.infobip.com/{mcp-tool}に従います。各サーバーは独立しており、その製品に固有のツールを公開します。以下の表を使用して必要なエンドポイントを特定し、MCP クライアントを構成します。

メッセージング チャネル

サーバーストリーミング可能な HTTP エンドポイント機能
SMShttps://mcp.infobip.com/smsメッセージの送信とプレビュー、スケジュールと再スケジュール、一括送信、多言語サポート(音訳、文字セット)、配信レポート、メッセージログ、URLトラッキング
WhatsApphttps://mcp.infobip.com/whatsappテンプレートメッセージの送信、テキスト/メディア(テキスト、ドキュメント、画像、オーディオ、ビデオ、ステッカー)の送信、場所/連絡先メッセージの送信、テンプレート管理(作成、編集、削除、取得)、配信レポート、メッセージログ、SMSフェイルオーバー
WhatsApp フローhttps://mcp.infobip.com/whatsapp-flow静的/動的フローの作成と管理、フロー構造の生成、フロー JSON の管理、対話型フローの送信、フローのプレビュー、対話型コンポーネント (フォーム、ボタン、チェックボックス) の追加と管理
Viberhttps://mcp.infobip.com/viberリッチメディア(画像、ビデオ、ファイル、URL)、配信レポート、メッセージログ、スケジューリング、SMSフェイルオーバー、URLトラッキングを含むメッセージの送信
RCShttps://mcp.infobip.com/rcsリッチメッセージ(マルチメディア、返信候補、カルーセル、バーコード)、配信レポート、メッセージログ、機能チェック、SMS/MMSフェイルオーバーの送信
声https://mcp.infobip.com/voice単一および複数受信者の音声通話、テキスト読み上げ、録音済み音声、通話管理、電話会議、音声リスト管理、配信レポート、通話ログ
モバイルアプリメッセージングhttps://mcp.infobip.com/mobile-app-messagingプッシュ通知、配信レポート、メッセージログ、プッシュ統計、プッシュアプリケーション管理、受信トレイメッセージ管理の送信

認証と検証

サーバーストリーミング可能な HTTP エンドポイント機能
2FA（二要素認証）https://mcp.infobip.com/2faアプリケーション管理、メッセージテンプレート(SMS/Email)、PIN送信(SMS/Voice/Email)、PINの再送信と検証、PIN検証ステータス
カマラhttps://mcp.infobip.com/camara番号認証認証、認証番号、端末位置確認、SIMスワップチェック、SIMスワップ日取得、KYCマッチング

顧客データとプラットフォーム管理

サーバーストリーミング可能な HTTP エンドポイント機能
Peoplehttps://mcp.infobip.com/people個人プロファイルの管理、会社プロファイル、タグ、カスタム属性とリストの追加と管理、イベントの追跡とエクスポート、オーディエンスのセグメンテーション
アカウント管理https://mcp.infobip.com/account-managementアカウント残高、無料メッセージ数、合計残高、アカウント詳細の管理と更新、監査ログ
CPaaSXのアプリケーションとエンティティhttps://mcp.infobip.com/application-entityアプリケーションとエンティティの作成と管理、リソースの関連付け、インバウンド メッセージの構成、リスト リソース、カバレッジ ルックアップ、リソース要求の送信と追跡

開発者向けリソース

サーバーストリーミング可能な HTTP エンドポイント機能
NTT CPaaS ドキュメントhttps://mcp.infobip.com/searchNTT CPaaSのドキュメント、ユースケース、製品ガイドを検索
NTT CPaaSディープリサーチhttps://mcp.infobip.com/deep-researchディープ・リサーチ・モデルがNTT CPaaSのドキュメントを、自動化されたマルチステップのリサーチ・タスクのデータ・ソースとして検索・取得できるようにする
手記

ストリーミング可能な HTTP トランスポートは、NTT CPaaS MCP サーバーの現在の標準です。
レガシ接続の SSE トランスポート サポートが必要な場合は、エンドポイント URLに /sse を追加します (例: https://mcp.infobip.com/sms/sse)。

交通手段

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


構成例 (HTTP)

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

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

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

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

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

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

MCP - WhatsApp message

エージェントの権限とアクセス制御

AI エージェントの権限を管理するときは、メッセージの送信などの機密性の高いタスクに対してより厳格な制御を適用することが重要です。永続的で無制限のアクセスを許可すると、重大なセキュリティおよび運用上のリスクが生じる可能性があります。永続的な権限を持つ AI エージェントは、次のことができます。

  • 予期しない動作やプロンプト・インジェクション攻撃の際に、人間の監視なしにメッセージを送信
  • 承認ワークフローをバイパスする自動メッセージキャンペーンを通じて多額のコストを発生
  • 規制要件を満たしていないメッセージを送信してコンプライアンス違反を作成する
  • 不適切、タイミングの間違った、または過剰なコミュニケーションによって顧客との関係を損なう

詳細はMCP導入ガイドライン (opens in a new tab)を参照してください。

手記

最小権限の原則に従ってエージェントの権限を構成します:必要な最短期間、手元の特定のタスクに必要な最小限のアクセスのみを許可します。

トラブルシューティング

認証と承認の問題

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

メッセージ配信の問題

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

エラーコード

大事な

APIキー をセキュリティで保護します。ソースコードにハードコードしたり、バージョン管理にコミットしたりしないでください。

Need more help?
行き詰まった場合は、 API の「はじめに (opens in a new tab) 」ページにアクセスして、主要なセットアップ手順と例を確認してください。


次のステップ

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






概要NTT CPaaS MCP のコード例

Logo

ご不明点は

サポートまでお問い合わせ

ください

© NTT DOCOMO BUSINESS X,Inc.