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

MCP クライアントの操作(ベータ版) rtcdp-mcp

Adobe Real-Time CDPのMCP統合を利用すれば、API呼び出しを記述したり、製品画面を移動したりすることなく、平易な言語のプロンプトを使用して、オーディエンス、宛先、アクティベーションの正常性をクエリできます。 この統合は、Adobe Real-Time CDPとAdobe Real-Time CDP B2B editionの両方のお客様にサービスを提供し、MCP互換クライアントからサポートされているReal-Time CDP データとワークフローを調べるための会話型の方法を提供します。 このガイドでは、統合がどのように機能するのか、何ができるのか、どのように始めればよいのかなどについて説明します。

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

ベータ版、セキュリティ、法律上の注意 mcp-notices

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

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

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

モデルコンテキストプロトコルとは mcp-overview

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

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

主な機能 mcp-capabilities

Real-Time CDP MCP サーバーは​ 読み取り専用 ​の監視およびトリアージ サーフェスです。 AI アシスタント内で、クエリを記述したり製品画面を移動したりすることなく、オーディエンス、宛先、ソース、ID、プロファイル解決をまたいで、取得APIを平易な言語で回答として公開します。 MCP サーバーを通じてデータを作成、変更、または削除することはできません。

IMPORTANT
現在のBetaのすべてのツールは​ 読み取り専用 ​です。 オーディエンス、宛先、データフローの作成、アクティブ化、更新、削除などの書き込み操作はサポートされていません。

Beta リリースには、次の18のツールが含まれています。

ツール
説明
search_audiences
名前、エンティティの種類、ライフサイクルの状態、ID名前空間、オリジンごとにオーディエンスをリスト化して検索できます。
preview_audience_membership
オーディエンスとして保存する前に、PQLまたはSDD セグメント式のサイズを見積もります。
inspect_audience_evaluation_jobs
セグメント評価のジョブレコードを取得して、バッチオーディエンスが更新されない理由を診断したり、最近の評価履歴を確認したりできます。
inspect_audience_export_jobs
オーディエンス書き出しジョブレコードを取得して、書き出しが完了したことを確認するか、失敗の詳細を表示します。
search_destination_connectors
プラットフォームで使用可能な宛先コネクタの種類(例:Amazon S3、Google Ads、Salesforce CRM)を一覧表示します。
search_destination_accounts
認証済み宛先アカウントのリスト – 宛先コネクタタイプの設定済みインスタンス。
search_destination_input_connections
書き出されるオーディエンスまたはデータセットなど、宛先フローのExperience Platform側の入力を取得します。
search_destination_output_connections
宛先フローの外部エンドポイント(ターゲットパス、ファイル形式、配信設定)を取得します。
search_destination_flows
状態、マッピング、スケジュールなど、設定済みの宛先アクティベーションフローを一覧表示して調べます。
inspect_flow_runs
ソースおよび宛先フローの実行履歴を取得します。実行ごとに、ステータス、タイミング、レコード数、エラーの詳細を取得します。
search_source_connectors
プラットフォームで使用可能なソースコネクタタイプを一覧表示します。
search_source_accounts
認証されたソースアカウントのリスト – ソースコネクタタイプの設定済みインスタンス。
search_source_input_connections
ソースフローのデータ選択レイヤー(アカウントから取得されたもの)を取得します。
search_source_output_connections
取り込まれたデータが格納されるソースフローのExperience Platform データセットの宛先を取得します。
search_source_flows
状態、マッピング、スケジュールなど、設定済みのソース取り込みパイプラインを一覧表示および検査します。
search_identity_namespaces
Adobe標準のネームスペースとカスタムのネームスペースの両方で、サンドボックスにID名前空間の定義をリストアップします。
search_merge_policies
プロファイルフラグメントからリアルタイム顧客プロファイルを組み立てる方法を制御する、結合ポリシーレコードのリスト。
search_organizations
認証済みユーザーがアクセスできるAdobe組織を一覧表示します。

ユースケース mcp-use-cases

Real-Time CDP MCP サーバーは、監視およびトリアージ​用に設計されています。 サーバーは名前ではなくIDで動作するため、典型的なワークフローはリストから始まります。Claudeに利用可能なものを表示するよう依頼し、必要な項目を選択し、返されるIDを使用してフォローアップの質問をすることができます。

目標
プロンプトの例
オーディエンスのリスト
「prod サンドボックス内のオーディエンスを一覧表示します。」
特定のオーディエンスを調査
「オーディエンス ID abc123の詳細とライフサイクルの状態を表示する」
評価エラーの診断
「最新の評価ジョブを表示し、失敗した場合にフラグを立てます。」
書き出しジョブを確認
「最近のオーディエンス書き出しジョブを一覧表示し、それぞれのステータスを確認します。」
オーディエンスサイズの見積もり
「保存する前に、このPQL式のサイズを見積もってください:homeAddress.country = 'US'」
宛先コネクタの種類を一覧表示
「サンドボックスにはどのような宛先コネクタタイプがありますか?」
設定済みの宛先アカウントのリスト
「宛先アカウントとその接続状態を一覧表示します。」
宛先フローを一覧表示
「宛先アクティベーションフローを一覧表示し、有効または無効になっているフローを表示します。」
宛先フローを検査
「宛先フローID xyz789の完全な設定を表示します。」
宛先アカウントの正常性を確認
「宛先アカウントを一覧表示し、エラー状態にあるすべてのアカウントにフラグを立てます。」
最近のアクティブ化の実行を監視
「過去24時間のフローの実行を表示し、エラーがあればフラグを立てます」
失敗した実行を調査
「フローID xyz789の実行履歴を表示し、エラーを要約します。」
ソースフローを一覧表示
「ソース取り込みフローをリストし、現在の状態を表示します。」
ソースフローを調査
「ソースフローID src456の設定を表示します。取り込み先と移動先を教えてください。」
取り込み実行の正常性を確認
「ソースフローID src456の最近の実行履歴を表示し、エラーをフラグします。」
ID名前空間を一覧表示
「サンドボックスに設定されているID名前空間は何ですか?」
結合ポリシーのリスト
「結合ポリシーのリストを表示し、デフォルトのポリシーを表示します」
組織IDを検索
「私がアクセスできるAdobeの組織をリストアップしてください。」

アクセスとイネーブルメント mcp-access

AVAILABILITY
Real-Time CDP MCP サーバーはBetaにあり、セルフサービス登録用に開いていません。 アクセスは招待状によってのみ行われ、接続する前にAdobe組織に明示的に許可リストに加えるする必要があります。

アクセスをリクエストするには:

  1. Adobeのアカウント担当者(カスタマーサクセスマネージャー、テクニカルアカウントマネージャー、アカウントエグゼクティブ)に連絡し、Real-Time CDP MCP Beta プログラムへの関心を伝えます。
  2. Adobeの担当者が製品チームと連携して、利用条件を検討し、組織IDを有効にします。
  3. 有効になると、Adobe担当者がアクセスを確認し、その他のオンボーディング資料を提供します。
NOTE
Real-Time CDP MCP サーバーに接続できるのは、明示的に有効になっている組織のみです。 イネーブルメントの前に接続しようとすると、認証エラーが発生します。

前提条件 mcp-prerequisites

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

  • アクティブなReal-Time CDP ライセンスがあります。
  • お客様のAdobe組織は、Adobe担当者によってBeta プログラムに対して有効になっています(​ アクセスと有効化を参照)。
  • サポートされているMCP クライアント (Claude、ChatGPT、Claude Code、Codex、Cursor、またはVS Codeなど)にアクセスできます。
  • 組織IDと、クエリするサンドボックスの名前があります。
  • オーディエンス、宛先、フローサービスエンティティを表示するために必要な権限をAdobe Experience Platformに持っています。

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

Real-Time CDP MCP サーバーエンドポイントは次のとおりです。

https://rtcdp-mcp.adobe.io/mcp

サーバーは、ブラウザーベースのAdobe サインインフロー​を使用して​ リモート HTTP (ストリーマブル HTTP) トランスポート ​を使用します。 すべてのクライアントで、設定パターンは同じです。

  1. サーバーURLを追加:https://rtcdp-mcp.adobe.io/mcp
  2. 接続を保存または有効にします。
  3. クライアントが初めてツールを呼び出すときに、ブラウザーベースのAdobe ログイン​を完了します。
  4. 各セッションの開始時にimsOrgIdとsandboxNameを指定します。

一般的なJSON設定 mcp-connect-json

JSON ベースのMCP サーバー設定(Claude Desktop (claude_desktop_config.json)、VS Code、またはmcp.json ファイルを読み取る任意のクライアントなど)を受け入れるクライアントの場合、クライアントがネイティブリモート HTTPをサポートしているか、ローカルブリッジを必要とするかに応じて、次のいずれかの形式を使用します。

mcp-remote ブリッジ経由(Claude Desktopおよびローカル ブリッジを必要とするその他のクライアント)

{
  "mcpServers": {
    "rtcdp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://rtcdp-mcp.adobe.io/mcp"
      ]
    }
  }
}

ネイティブ リモート HTTP (直接サポートするクライアント)

{
  "mcpServers": {
    "rtcdp": {
      "url": "https://rtcdp-mcp.adobe.io/mcp",
      "transport": "http"
    }
  }
}
NOTE
設定にAPI キー、ベアラートークン、または追加のヘッダーは必要ありません。 認証は、初回使用時に、ブラウザベースのAdobe サインインフローを通じて完全に処理されます。

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

クロード

claude.aiとClaude Desktopの場合、Real-Time CDP MCP サーバーを​ カスタムコネクタ ​としてサーバーURL https://rtcdp-mcp.adobe.io/mcpを使用して追加します。

  • 個別プラン — Claudeで、→ コネクタのカスタマイズ​に移動し、コネクタの追加​を選択して、サーバーURLを入力します。
  • グループ版およびエンタープライズ版プラン — ワークスペース オーナー​または​ プライマリオーナー ​がコネクタを​ Organization settings → Connectors ​の下に追加します。 追加すると、各ユーザーが独自のクラウド設定で有効になります。

コネクタを追加したら、会話でコネクタを有効にし、最初の使用時にAdobe ブラウザーログインを完了します。 ClaudeはAdobe認証サーバーを自動的に検出します。クライアント IDまたはクライアントシークレットは必要ありません。

ChatGPT

ChatGPTで、Real-Time CDP MCP サーバーを​ カスタムコネクタ ​として追加します。

  1. 設定→コネクタ (プランに応じて​設定→アプリとコネクタ)に移動します。
  2. 「コネクタを追加」を選択し、サーバーURLとして「https://rtcdp-mcp.adobe.io/mcp」と入力します。
  3. コネクタを保存します。 ChatGPT プランによっては、この手順では​ 開発者モード ​またはワークスペース管理者の承認が必要になる場合があります。
  4. コネクタを有効にしたら、最初の使用時にプロンプトが表示されたら、Adobe ブラウザーログインを使用して認証します。

カーソル

Cursorで、Real-Time CDP MCP サーバーをリモート MCP サーバーとして追加します。

  1. MCP の​設定→開きます。
  2. 「新しいサーバーを追加」を選択し、サーバーURLとして「https://rtcdp-mcp.adobe.io/mcp」と入力します。
  3. 「connect」を選択して、ブラウザーベースのAdobe ログインをトリガーし、認証します。

接続すると、Real-Time CDP ツールはCursorのコンポーザーモードとエージェントモードで使用できるようになります。

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

VS Codeなどのクライアントや、リモート MCPをサポートする他のデスクトップおよびweb アプリケーションの場合は、https://rtcdp-mcp.adobe.io/mcpを使用してReal-Time CDP MCP サーバーを​リモート HTTP サーバーとして追加します。 クライアントがオプションのヘッダーまたはベアラートークンをサポートしている場合は、それらを空のままにします。認証は、初回使用時にブラウザベースのAdobe サインインフローを通じて処理されます。

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

クロード・コード

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

claude mcp add --transport http rtcdp https://rtcdp-mcp.adobe.io/mcp

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

/mcp

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

Codex

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

codex mcp add rtcdp --url https://rtcdp-mcp.adobe.io/mcp

サーバーの認証:

codex mcp login rtcdp

設定を確認します。

codex mcp list

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

[mcp_servers.rtcdp]
url = "https://rtcdp-mcp.adobe.io/mcp"

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

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

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

各セッションの開始時に提供してください。 次に例を示します。

「このセッションには、組織1234ABCD@AdobeOrgとサンドボックス prodを使用します。」

組織IDがわからない場合は、AI アシスタントにsearch_organizationsへの電話を依頼します。Adobeの資格情報がアクセス可能なすべての組織が返されます。

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

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

制限事項
説明
回避策
読み取り専用サーフェス
MCP サーバーは取得APIのみを公開します。 オーディエンス、宛先、またはデータフローを作成、更新、アクティベート、または削除することはできません。
Real-Time CDP UIまたはExperience Platform REST APIを使用して書き込み操作を行います。
エンゲージメントまたは配信指標がありません
MCP サーバーは、ダウンストリーム配信の統計、エンゲージメント、またはコンバージョン指標を宛先プラットフォームから返しません。
エンゲージメントとコンバージョンのデータには、配信先プラットフォーム独自のレポート、Customer Journey Analytics MCP、Adobe Analytics MCPを使用できます。
セグメントクエリは外部で作成する必要があります
Preview Audience Membershipには入力として有効なPQLまたはSDD式が必要です。MCP サーバーはクエリを作成しません。
Audience Builder UIまたはSegmentation Service APIを使用してPQL/SDD式を作成し、MCP プロンプトに貼り付けます。
継続トークンを使用したページネーション
リストツールは、ページ分割された結果を返します。 非常に大きなサンドボックス全体で完全な列挙を行うには、continuationToken回の呼び出しを連鎖させる必要があります。
リスト全体を列挙するのではなく、フィルター(名前、状態、接続仕様、時間範囲)を使用してクエリを絞り込みます。
アクティベーション実行のフィルタリングは時間ベースのみです
Inspect Activation Runsは、ステータスと完了タイムスタンプ (epoch ms UTC)によるフィルタリングをサポートしていますが、エラータイプや宛先プラットフォームによるフィルタリングはサポートしていません。
最初にflowIdでフィルターを実行し(List Configured Destinationsから取得)、スコープを特定の宛先に実行します。
セッション開始時に​組織IDが必要
すべてのツール呼び出し(search_organizationsを除く)には、明示的なパラメーターとしてimsOrgIdとsandboxNameが必要です。 これらを指定しない場合、ツール呼び出しは失敗します。
各セッションの開始時に、AI アシスタントに「このセッションには組織<YOUR_ORG_ID>とサンドボックス <SANDBOX_NAME>を使用してください」と伝えます。 組織IDがわからない場合は、最初にsearch_organizationsに電話してください。資格情報がアクセスできる組織が返されます。

よくある質問 mcp-faq

どの MCP クライアントがサポートされていますか?
Real-Time CDP MCP サーバーは、Claude、ChatGPT、Claude Code、Codex、CursorおよびVS Codeなど、リモート MCP サーバーまたはカスタムコネクタをサポートするあらゆるクライアントで動作します。 セットアップフローはクライアントによって異なります。UI ベースのクライアントは通常、設定パネルまたはコネクターパネルからサーバーを追加しますが、Claude CodeやCodexなどのテクニカルクライアントはコマンドラインまたは設定ファイルからサーバーを追加できます。
アクセス方法を教えてください。
アクセスは、Beta中にのみ招待状によって行われます。 登録をリクエストするには、Adobeのアカウント担当者(カスタマーサクセスマネージャー、テクニカルアカウントマネージャー、またはアカウントエグゼクティブ)にお問い合わせください。 Adobeの担当者がプロダクトチームと連携し、お客様のビジネスを支援します。 詳しくは、​ アクセスと有効化を参照してください。
認証の仕組み?
認証は、ブラウザーベースのログイン​を通じて処理されます。 MCP クライアントが最初にツールを呼び出すと、デフォルトのブラウザーが開き、Adobe ログインページが表示されます。 クライアントを認証および認証した後、セッションが確立され、後続のツール呼び出しがそれを再利用します。 API キーや長期間有効な資格情報をクライアント設定に保存する必要はありません。
MCP経由でアクセスできるReal-Time CDP オブジェクトは何ですか?
オーディエンス、宛先タイプ、設定済みの宛先アカウント、宛先データフロー、ソース接続とターゲット接続、アクティベーションの実行履歴にアクセスできます。 操作は読み取り専用(取得 API)です。書き込み操作は現在のリリースではサポートされていません。
Real-Time CDP MCP サーバーを使用するには、開発者アクセス権が必要ですか?
いいえ。 MCP サーバーは、マーケティングとテクノロジーの両方のペルソナ向けに設計されています。 マーケターは、サポートされているMCP クライアントで自然言語プロンプトを使用してMCPと対話できます。一方、データエンジニアや開発者は、MCPをサポートする開発者ツールでMCPを使用できます。
recommendation-more-help
experience-platform-help-rtcdp