NTT CPaaS MCP サーバーの使用

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

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

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

無料の NTT CPaaS アカウントにサインアップします。
- 無料試用版アカウントには、MCP のテストに使用できるメッセージングユニットが含まれています。
- 無料試用期間中は、確認済みの番号にのみメッセージを送信できます。
認証方法を選択します。
使用可能なエンドポイントのリストから MCP サーバーを選択します。

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

認証

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

APIキー [#api-key-authentication]

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

NTT CPaaS APIキーについて:

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

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

[API キー] ページからAPIキーをコピーします。
選択した MCP クライアントにキーを「権限付与」ヘッダーとして追加します。

bash
Authorization: App ${INFOBIP_API_KEY}
MCP クライアントを再起動します。

OAuthの2.1 [#oauth-2-1-authentication]

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

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

OAuth 2.1 認証
動的 OAuth 認証サーバーメタデータ検出。

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

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

json
1{
2 "mcpServers": {
3 "infobip-sms": {
4 "command": "npx",
5 "args": [
6 "mcp-remote",
7 "https://mcp.infobip.com/sms"
8 ]
9 }
10 }
11}
MCP クライアントを再起動します。OAuth フローが自動的に開始され、認証のために NTT CPaaS OAuth サーバーにリダイレクトされます。

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

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

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

json

{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 エンドポイント	機能
SMS	`https://mcp.infobip.com/sms`	メッセージの送信とプレビュー、スケジュールと再スケジュール、一括送信、多言語サポート(音訳、文字セット)、配信レポート、メッセージログ、URLトラッキング
電子メール	`https://mcp.infobip.com/email`	電子メールメッセージの送信、一括メッセージの送信、スケジュールされた電子メールと一括電子メールメッセージのスケジュールと管理、電子メールアドレスの検証
WhatsApp	`https://mcp.infobip.com/whatsapp`	テンプレートメッセージの送信、テキスト/メディア(テキスト、ドキュメント、画像、オーディオ、ビデオ、ステッカー)の送信、場所/連絡先メッセージの送信、テンプレート管理(作成、編集、削除、取得)、配信レポート、メッセージログ、SMSフェイルオーバー
WhatsApp フロー	`https://mcp.infobip.com/whatsapp-flow`	静的/動的フローの作成と管理、フロー構造の生成、フロー JSON の管理、対話型フローの送信、フローのプレビュー、対話型コンポーネント (フォーム、ボタン、チェックボックス) の追加と管理
Viber	`https://mcp.infobip.com/viber`	リッチメディア(画像、ビデオ、ファイル、URL)、配信レポート、メッセージログ、スケジューリング、SMSフェイルオーバー、URLトラッキングを含むメッセージの送信
RCS	`https://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 エンドポイント	機能
People	`https://mcp.infobip.com/people`	個人プロファイルの管理、会社プロファイル、タグ、カスタム属性とリストの追加と管理、イベントの追跡とエクスポート、オーディエンスのセグメンテーション
アカウント管理	`https://mcp.infobip.com/account-management`	アカウント残高、無料メッセージ数、合計残高、アカウント詳細の管理と更新、監査ログ
CPaaSXのアプリケーションとエンティティ	`https://mcp.infobip.com/application-entity`	アプリケーションとエンティティの作成と管理、リソースの関連付け、インバウンドメッセージの構成、リストリソース、カバレッジルックアップ、リソース要求の送信と追跡

開発者向けリソース

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

手記

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

交通手段 [#transport-options-available-endpoints]

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

HTTP: ストリーミング可能な HTTP トランスポート (既定値)
SSE (サーバー送信 Events): ストリーミング応答に使用します。エンドポイント URL に /sse を追加します。
STDIO トランスポートブリッジ: エージェントがリモート MCP サーバーをサポートしていない場合は、mcp-remote のようなブリッジを使用できます。

構成例 (HTTP)

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

json

2 "mcpServers": {

3 "ib-whatsapp": {

4 "type": "http",

5 "url": "https://mcp.infobip.com/whatsapp",

6 "headers": {

7 "Authorization": "App ${INFOBIP_API_KEY}"

8 }

9 }

10 }

11}

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

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

json

2 "mcpServers": {

3 "infobip-whatsapp": {

4 "command": "npx",

5 "args": [

6 "mcp-remote",

7 "https://mcp.infobip.com/whatsapp",

8 "--header",

9 "Authorization:${AUTH_HEADER}"

10 ],

11 "env": {

12 "AUTH_HEADER": "App <Your NTT CPaaS API key here>"

13 }

14 }

15 }

16}

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

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

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

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

詳細はMCP導入ガイドラインを参照してください。

手記

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

トラブルシューティング

認証と承認の問題 [#authentication-troubleshooting]

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

メッセージ配信の問題 [#message-delivery-troubleshooting]

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

エラーコード [#error-codes-troubleshooting]

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

大事な

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

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

次のステップ

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

MCP チュートリアル
デモプロジェクトについては NTT CPaaS MCP code examples ページを参照するか、NTT CPaaS MCP GitHub リポジトリに直接アクセスしてください。

NTT CPaaS MCP サーバーの使用