Logo
CTRLK
Logo
CTRLK
無料で試す
すべての製品を見る
概要
NTT CPaaS MCP サーバーの使用
MCP のプロビジョニング
NTT CPaaS MCP のコード例

参考資料

MCP GitHub リポジトリ
API リファレンス
基本表現
チュートリアル
プライシング
サポートセンター
ユースケースライブラリ

NTT CPaaS MCP サーバーの使用

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

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

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

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

  2. 認証方法を選択します。
  3. 使用可能なエンドポイント のリストから 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サーバーを使用するには:

  1. [API キー] ページからAPIキーをコピーします。

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

    bash
    Authorization: App ${INFOBIP_API_KEY}

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


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

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

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


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

  1. 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}

  2. 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 クライアントを構成します。


メッセージング チャネル [#messaging-channels-available-endpoints]

サーバーストリーミング可能な HTTP エンドポイント特徴
SMShttps://mcp.infobip.com/smsメッセージの送信とプレビュー、スケジュールと再スケジュール、一括送信、多言語サポート(音訳、文字セット)、配信レポート、メッセージログ、URLトラッキング
電子メールhttps://mcp.infobip.com/email電子メール メッセージの送信、一括メッセージの送信、スケジュールされた電子メールと一括電子メール メッセージのスケジュールと管理、電子メール アドレスの検証
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プッシュ通知、配信レポート、メッセージログ、プッシュ統計、プッシュアプリケーション管理、受信トレイメッセージ管理の送信

認証と検証 [#authentication-and-verification-available-endpoints]

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

顧客データとプラットフォーム管理 [#customer-data-and-platform-management-available-endpoints]

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

プロビジョニング [#provisioning-available-endpoints]

サーバーストリーミング可能な HTTP エンドポイント特徴
プロビジョニング (早期アクセス)https://mcp.infobip.com/provisionチャネル登録ワークフロー、送信者登録、番号購入、登録計画と要件、進行状況の追跡、ステータスチェック。詳細は、MCPのプロビジョニングをご覧ください。

開発者向けリソース [#developer-resources-available-endpoints]

サーバーストリーミング可能な 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.)。


Transport options [#transport-options-available-endpoints]

NTT CPaaS MCP servers support different transport methods to handle requests and responses, depending on your client’s capabilities.

  • HTTP: Streamable HTTP transport ↗ (default)
  • SSE (Server-Sent Events): Use for streaming responses. Append /sse to the endpoint URL, for example:
  • STDIO Transport Bridge: If your agent does not support remote MCP servers, you can use a bridge like mcp-remote ↗.

Example configuration (HTTP) [#example-configuration-http-transport-options]

The following configuration shows how to connect directly to an NTT CPaaS MCP server over HTTP. This is the most common setup used by AI applications that support remote MCP servers.

json
1{
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}

Example configuration (STDIO transport bridge) [#example-configuration-stdio-transport-options]

If your MCP client does not support remote connections, you can use an STDIO bridge, such as mcp-remote.

json
1{
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}

Here's how a successful WhatsApp message might look like:

MCP - WhatsApp message

Agent permission and access control

When managing AI agent permissions, it is important to apply stricter controls for sensitive tasks like sending messages. Granting permanent, unrestricted access can create significant security and operational risks. AI agents with persistent permissions can:

  • Send messages without human oversight during unexpected behavior or prompt injection attacks
  • Generate substantial costs through automated message campaigns that bypass approval workflows
  • Create compliance violations by sending messages that don't meet regulatory requirements
  • Damage customer relationships through inappropriate, mistimed, or excessive communications

Refer to the MCP implementation guidelines ↗ for more details.

NOTE

Configure agent permissions following the principle of least privilege: grant only the minimum access necessary for the specific task at hand, for the shortest duration required.


トラブルシューティング

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

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

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

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

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

大事な

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

もっと詳しく知る

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


関連ページ

MCPチュートリアル
MCP サーバーを使用して SMS、WhatsApp、Viber メッセージを送信するためのハンズオン ガイド。

NTT CPaaS MCPコード例
OpenAI Agents SDK、Semantic Kernel、Spring AI、LangGraphのデモプロジェクト。

NTT CPaaS MCP GitHubリポジトリ↗
セットアップ手順、ソースコード、およびコントリビューションガイドライン。


← 概要MCP のプロビジョニング →

Logo

ご不明点は

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

ください

© NTT DOCOMO BUSINESS X,Inc.