[ベータ版]{class="badge informative"}

MCP クライアントの操作(Beta) rtcdp-mcp

Adobe Real-Time CDPのMCP統合を利用すれば、API呼び出しを記述したり、製品画面を移動したりすることなく、平易な言語のプロンプトを使用して、オーディエンス、宛先、アクティベーションの正常性をクエリできます。 このページでは、統合がどのように機能するのか、何ができるのか、どのように始めればよいのかについて説明します。

AVAILABILITY
Real-Time CDP MCP サーバーは、サポートされているMCP クライアントおよびアプリプラットフォーム(Claude、ChatGPT、Claude Code、Codex、Cursor、VS Codeなど)にユーザーがインストールおよび設定する​ リモート HTTP トランスポート サーバー ​として配布されます。 認証は、ブラウザーベースのログインフロー​を通じて処理されます。クライアントが最初にサーバーに接続すると、デフォルトブラウザーが開き、Adobeの資格情報でログインしてアクセスを許可できます。 このBeta プログラムにアクセスするには、Adobe担当者にお問い合わせください。

Beta、セキュリティ、法務に関する通知 mcp-notices

Beta ドキュメント通知:​このドキュメントでは、Beta機能について説明しており、最終的なドキュメントを構成するものではありません。 ここに記載されている内容は、Beta リリースに関連しており、一般提供される前に変更される場合があります。 Adobeは、このドキュメントの完全性または正確性について何ら表明しません。

Adobe Real-Time CDP MCP Server (Beta)(「Beta」)を使用することにより、お客様は、Betaが何らの保証もなしに​「現状のまま」提供されることを了承するものとします。 Adobeは、Betaを維持、修正、更新、変更、その他の方法でサポートする義務を負いません。 このようなBetaおよび/または付随資料の正しい機能や性能に依存しないように、慎重に使用することをお勧めします。 ベータ版はアドビの機密情報と見なされます。 お客様がアドビに提供するあらゆる「フィードバック」(ベータ版の使用中に発生した問題や欠陥、提案、改善、レコメンデーションを含むがこれに限定されないベータ版に関する情報)は、このようなフィードバックに含まれる、およびフィードバックに対するすべての権利、所有権、利益を含め、アドビに帰属します。

WARNING
Model Context Protocol (MCP)は新しいオープンソースの標準であり、セキュリティや信頼性に関するリスクが生じる可能性があります。 Adobe MCP サーバーの統合と関連ドキュメントは、いかなる保証も受けることなく、「現状のまま」提供されます。
MCP クライアントまたはサーバーをAdobe製品に接続することは、お客様が選択した設定です。 顧客には、あらゆるMCP統合のセキュリティと適合性を評価する責任があります。 Adobeは、設定ミス、MCPの誤用、サードパーティ実装の脆弱性、またはMCP対応ワークフローを通じて実行された意図しないアクションから生じる問題については責任を負いません。
リスクを軽減するために、Adobeでは、本番稼働前にサンドボックス環境で統合をテストし、MCPで開始されるすべてのアクションと応答を慎重にレビューおよび検証してから、確認または依存することを推奨しています。

モデルコンテキストプロトコルとは何ですか? mcp-overview

マーケティング、データ、顧客体験の各チームは、日々の作業を合理化するために、チャットベースのアプリケーションや開発者ツール(Anthropic Claude、OpenAI ChatGPT、Cursor、Microsoft Copilot Studioなど)への依存度を高めています。 これらのアプリケーションは、Model Context Protocol (MCP)​をサポートしています。これは、アプリケーションがバックエンドツールを大規模言語モデル(LLM)に統一された方法で公開できるようにするオープンスタンダードです。

Real-Time CDPは、MCP互換アプリケーション内でオーディエンス、宛先、アクティベーションの操作を直接表示するMCP サーバーを提供するようになりました。 Real-Time CDPとMCPを連携することで、Adobe Experience Platform REST APIに対してクエリを作成したり、複数のUI画面を操作したりすることなく、様々なペルソナが同じセグメンテーションデータやアクティベーションデータを利用して共同作業をおこなうことができます。 顧客は自分の意図を対話的に説明でき、LLMが適切なMCP ツールを呼び出せます。

主な機能 mcp-capabilities

Real-Time CDP MCP サーバーでは、AI アシスタントから直接、オーディエンスと宛先を検査、要約、トラブルシューティングできます。 すべての操作は​ 読み取り専用 ​です。MCP サーバーサーフェスは、APIを平易な言語の回答として取得するため、次のことが可能です。

  • オーディエンスをすばやく可視化 — メニューを移動したり、レポートを手動で取得したりすることなく、オーディエンスの定義、ライフサイクルの状態、名前空間をわかりやすい言語で確認できます。
  • アクティブ化する前にオーディエンスサイズを見積もる — オーディエンスの構築にコミットする前に、PQLまたはSDD セグメントクエリのメンバーシップ数と信頼区間をプレビューします。
  • アクティベーションポートフォリオを監査 — JSONを解析したり、製品画面にジャンプしたりすることなく、設定済みの宛先、データフローのフィード、各フローの背後にあるソース/ターゲット接続を確認します。
  • アクティベーションの問題を早期に特定 – 要求した瞬間にサーフェスが失敗または処理中の宛先が実行されるため、チームは迅速に行動できます。
  • ライブデータを中心としたコラボレーション — マーケター、データエンジニア、ステークホルダーは、AI アシスタントを通じて同じライブ Real-Time CDP データをクエリできるため、調整、決定、連携が容易になります。

利用可能なツール mcp-tools

新しいツールを実現するにつれて、ツールの可用性は急速に変化しています。 利用可能な最新のツールの一覧については、Adobeの担当者にお問い合わせください。

NOTE
すべてのツールは​ 読み取り専用 ​です。 書き込み操作(オーディエンス、宛先、またはデータフローの作成、更新、削除)は、現在のBeta リリースではサポートされていません。

ユースケース mcp-use-cases

次の例は、自然言語を使用してAdobe Real-Time CDP MCP サーバーを操作する方法を示しています。

目標
プロンプト例
宛先カタログの検出
「TikTokはサンドボックス内の宛先として使用できますか?」 /「アカウントが既に設定されている宛先タイプはどれですか?」
タイプ別の宛先インベントリ
「Amazon S3のすべての宛先を一覧表示します。」 / 「データセットの書き出し先を設定していますか?」
宛先設定の監査
「どのバケットにLoyalty S3 Export宛先が書き込まれていますか?」 / 「データフロー[ID]のターゲットパスとファイル形式を表示します。」
アカウントの正常性
「有効期限が切れた資格情報を持つ宛先アカウントはどれですか?」 / 「PinterestまたはFacebookのアカウントにエラーが発生していますか?」
アクティベーションの正常性 – 24時間前
「過去24時間に失敗した実行を含むすべての宛先をリストします。」 / 「データセットの書き出し先で、過去24時間以内にデータが送信されましたか?」
宛先ごとのアクティベーション履歴
「過去30日間にWeekly Loyalty Exportが何か書き出しましたか?」 / 「宛先{NAME}の完全な実行履歴を表示する」
エラー分析
「今週、ファイルベースの宛先で最も一般的なエラーの原因は何ですか?」 / 「最近失敗した実行をエラータイプ別にグループ化する」
オーディエンスの発見とフィルタリング
marketing-prod サンドボックス内のすべてのCSV ベースのオーディエンスを一覧表示します。」 /「外部オーディエンス IDが定義されているオーディエンスはどれですか?」
オーディエンスサイジング監査
「サイズ 0のすべてのオーディエンスを表示する」 /「1,000人のプロファイルを超えるオーディエンスはどれですか?」
オーディエンス有効期限の監査
「終了日が既に過ぎているオーディエンスがある宛先はどれですか?」 / 「今後7日間に期限切れになる予定のオーディエンスを一覧表示する」
オーディエンスアクティベーションフットプリント
「10を超えるオーディエンスがアクティベートされている宛先はどれですか?」 /「最も多くの宛先にアクティベートされているオーディエンスはどれですか?」
クロスフィルター:オーディエンス×アクティブ化
「少なくとも2つの宛先でアクティブ化された1,000を超えるサイズのオーディエンスを表示します。」 / 「単一の宛先にのみアクティブ化される大規模なオーディエンス。」
オーディエンスメンバーシップのプレビュー
「オーディエンス High-Value Loyalty Membersのメンバーシップ サイズをプレビューします。」 / 「保存する前に、このPQL クエリのサイズを見積もる:{EXPRESSION}」

前提条件 mcp-prerequisites

Real-Time CDP MCP サーバーをMCP クライアントに接続する前に、次の点を確認してください。

  • アクティブなReal-Time CDP ライセンスがあります。
  • リモート MCP サーバーまたはカスタム MCP アプリ(Claude、ChatGPT、Claude Code、Codex、Cursor、VS Codeなど)に接続できる、サポートされているクライアントにアクセスできます。
  • 組織IDと、クエリするサンドボックスの名前があります。
  • オーディエンス、宛先、フローサービスエンティティを表示するために必要な権限をAdobe Experience Platformに持っています。

Real-Time CDP MCP サーバーへの接続 mcp-connect

NOTE
この統合はBetaにあります。 顧客のメニュー、プランの要件、管理者の管理機能は、アプリケーションやバージョンによって異なります。

まず、次の項目を確認してください。

  • MCP サーバーエンドポイント URL: Available to Beta customers through your Adobe representative
  • Adobe ユーザーが対象のExperience Platform組織とサンドボックスにアクセスできることを確認します。

Real-Time CDP MCP サーバーは​ リモート HTTP MCP サーバー ​です。 すべてのクライアントで、セットアップは同じパターンに従います。

  1. サーバーURLを追加します。
  2. 接続を保存または有効にします。
  3. クライアントが初めてツールを呼び出すときに、ブラウザーベースのAdobe ログイン​を完了します。
  4. 各リクエストにimsOrgIdsandboxNameを指定します。

UI ベースのクライアントへのインストール mcp-connect-ui

クロード

claude.aiとClaude Desktopの場合、Adobe担当者から提供されたエンドポイントを使用して、Real-Time CDP MCP サーバーを​ カスタムコネクタ ​として追加します。 個別のClaude プランで、カスタマイズ/コネクタ​の下に追加します。 グループ版およびエンタープライズ版のプランでは、所有者が最初に​ 組織設定/コネクタ ​の下に追加する必要がある場合があります。その後、各ユーザーが独自のクラウド設定で接続します。 設定が完了したら、会話でコネクタを有効にし、最初の使用時にAdobe ブラウザーログインを完了します。

ChatGPT

ChatGPTで、Adobe担当者から提供されたエンドポイントを使用して、Real-Time CDP MCP サーバーを​ カスタムアプリ/コネクタ ​として追加します。 ChatGPT プランによっては、開発者モード​とワークスペース管理者の承認が必要になる場合があります。 アプリ/コネクタを作成または有効にした後、Settings > Apps​または​ Settings > Apps & Connectors ​から接続し、プロンプトが表示されたらAdobe ブラウザーログインを使用して認証します。

カーソル

Cursorで、Adobe担当者が提供するエンドポイントを使用して、Real-Time CDP MCP サーバーをリモート MCP サーバーとして追加します。 設定 / MCP​を開き、新しいサーバーを追加し、エンドポイント URLを貼り付けます。 追加したら、connect​を選択してワークスペースのサーバーを有効にし、ブラウザー経由で認証します。

その他のUI ベースのクライアント

リモート MCPをサポートするVS Codeまたはその他のデスクトップおよびweb アプリケーションなどのクライアントの場合は、Adobe担当者が提供するエンドポイントを使用して、Real-Time CDP MCP サーバーを​リモート HTTP サーバーとして追加します。 クライアントがオプションのヘッダーまたはベアラートークンをサポートしている場合は、Adobeが特に指示しない限り、それらを空のままにします。認証は、最初の使用時にブラウザベースのAdobe サインインフローを通じて処理されます。

テクニカルクライアントへのインストール mcp-connect-technical

クロード・コード

ターミナルからサーバーを追加します。

claude mcp add --transport http rtcdp <endpoint provided by your Adobe representative>

次に、Claude Codeを起動し、以下を実行します。

/mcp

rtcdp サーバーを選択し、ブラウザーでAdobe ログインフローを実行します。 claude.aiでサーバーを既に追加している場合、両方で同じアカウントを使用している場合は、同じサーバーがClaude Codeに自動的に表示されることもあります。

Codex

ターミナルからサーバーを追加します。

codex mcp add rtcdp --url <endpoint provided by your Adobe representative>

サーバーの認証:

codex mcp login rtcdp

設定を確認します。

codex mcp list

サーバーを~/.codex/config.tomlに直接追加することもできます。

[mcp_servers.rtcdp]
url = "<endpoint provided by your Adobe representative>"

必須のリクエストパラメーター mcp-connect-params

すべてのツール呼び出しには、リクエストをスコープする2つのパラメーターが必要です。

  • imsOrgId – 下流のExperience Platform API呼び出しでx-gw-ims-org-id ヘッダーにマッピングされた組織ID。
  • sandboxNamex-sandbox-name ヘッダーにマッピングされたExperience Platform サンドボックス名。

既知の制限事項(Beta) mcp-limitations

次の制限は、Adobe Real-Time CDP MCP サーバーの現在のBeta リリースに適用されます。

制限事項
説明
回避策
読み取り専用サーフェス
MCP サーバーは取得APIのみを公開します。 オーディエンス、宛先、またはデータフローを作成、更新、アクティベート、または削除することはできません。
Real-Time CDP UIまたはAEP REST APIを使用して書き込み操作を行います。
エンゲージメントまたは配信指標がありません
MCP サーバーは、ダウンストリーム配信の統計、エンゲージメント、またはコンバージョン指標を宛先プラットフォームから返しません。
エンゲージメントとコンバージョンのデータには、配信先プラットフォーム独自のレポート、Customer Journey Analytics MCP、Adobe Analytics MCPを使用できます。
セグメントクエリは外部で作成する必要があります
Preview Audience Membershipには入力として有効なPQLまたはSDD式が必要です。MCP サーバーはクエリを作成しません。
セグメントビルダーUIまたはSegmentation Service APIを使用してPQL/SDD式を作成し、MCP プロンプトに貼り付けます。
継続トークンを使用したページネーション
リストツールは、ページ分割された結果を返します。 非常に大きなサンドボックス全体で完全な列挙を行うには、continuationToken回の呼び出しを連鎖させる必要があります。
リスト全体を列挙するのではなく、フィルター(名前、状態、接続仕様、時間範囲)を使用してクエリを絞り込みます。
アクティベーション実行のフィルタリングは時間ベースのみです
Inspect Activation Runsは、ステータスと完了タイムスタンプ (epoch ms UTC)によるフィルタリングをサポートしていますが、エラータイプや宛先プラットフォームによるフィルタリングはサポートしていません。
最初にflowIdでフィルターを実行し(List Configured Destinationsから取得)、スコープを特定の宛先に実行します。
地域の設定が必要
MCP ゲートウェイがユーザーのリージョンに設定されていない場合、ツール呼び出しはHTTP 403 「User region is missing」で失敗します。
最初に使用する前に、Adobe担当者に連絡して、お客様の地域にゲートウェイが設定されていることを確認してください。

よくある質問 mcp-faq

どのMCP クライアントがサポートされていますか?
Real-Time CDP MCP サーバーは、リモート MCP サーバーまたはカスタム MCP アプリケーション(Claude、ChatGPT、Claude Code、Codex、Cursor、VS Codeなど)に接続できるサポート対象のクライアントで動作します。 セットアップフローはクライアントによって異なります。UI ベースのクライアントは通常、設定からサーバーを追加しますが、Claude CodeやCodexなどのテクニカルクライアントはコマンドラインまたは設定ファイルからサーバーを追加できます。
認証の仕組み?
認証は、ブラウザーベースのログイン​を通じて処理されます。 MCP クライアントが最初にツールを呼び出すと、デフォルトのブラウザーが開き、Adobe ログインページが表示されます。 クライアントを認証および認証した後、セッションが確立され、後続のツール呼び出しがそれを再利用します。 API キーや長期間有効な資格情報をクライアント設定に保存する必要はありません。
MCP経由でアクセスできるReal-Time CDP オブジェクトは何ですか?
オーディエンス、宛先タイプ、設定済みの宛先アカウント、宛先データフロー、ソース接続とターゲット接続、アクティベーションの実行履歴にアクセスできます。 操作は読み取り専用(取得API)です。書き込み操作は現在のリリースではサポートされていません。
Real-Time CDP MCP サーバーを使用するには、開発者アクセス権が必要ですか?
いいえ。 MCP サーバーは、マーケティングとテクノロジーの両方のペルソナ向けに設計されています。 マーケターは、サポートされているMCP クライアントで自然言語プロンプトを使用してMCPと対話できます。一方、データエンジニアや開発者は、MCPをサポートする開発者ツールでMCPを使用できます。
データはMCP クライアントプロバイダーに送信されますか?
プロンプトを送信すると、MCP クライアントは、関連するコンテキスト(MCP サーバーから返されるReal-Time CDP データを含む)をモデルに送信して処理する場合があります。 本番データに接続する前に、MCP クライアントプロバイダーのプライバシーおよびデータ処理ポリシーを確認してください。
Real-Time CDPでどのような権限が必要ですか?
クエリするオブジェクト(オーディエンス、宛先、フローサービスエンティティ)に対して、少なくとも​ 表示 ​権限が必要です。 MCP サーバーは読み取り操作のみを実行するため、書き込み権限は必要ありません。 現在のアクセス レベルが不明な場合は、Adobe Experience Platform管理者にお問い合わせください。
サンドボックス環境でMCP サーバーを使用できますか?
はい。 すべてのツール呼び出しにはsandboxName パラメーターが必要なので、MCP サーバーは常にAdobe Experience Platform サンドボックス設定を尊重します。 プロンプトで名前を指定することで、アクセスできるサンドボックスをクエリできます。
プレビューオーディエンスメンバーシップと既存オーディエンスの検索の違いは何ですか?
Search Existing Audiencesは、既に作成され、サンドボックスに保存されているオーディエンスを返します。 Preview Audience Membershipは、生のPQLまたはSDD セグメント式を取り出し、サイズ推定値を返します。この値は、クエリのサイズを​ ​に設定する場合に便利です。
アカウントオーディエンスとプロファイルオーディエンスの両方をクエリできますか?
はい。 Search Existing AudiencesPreview Audience Membershipの両方で、エンティティ型パラメーターをサポートしています。 プロファイルオーディエンスはPQLまたはSDDで表現できます。アカウントオーディエンスは常にSDD (リレーショナル)構文を使用します。
recommendation-more-help
6f08adb8-9d4a-4cec-8173-ab4c03ac2841