[Beta]{class="badge informative"}
Real-Time CDP MCP (Beta) rtcdp-mcp
您可以使用Adobe Real-Time CDP MCP整合,以純語言提示來查詢對象、目的地和啟動健康情況,而不需要撰寫API呼叫或導覽產品熒幕。 此整合約時為Adobe Real-Time CDP和Adobe Real-Time CDP B2B edition的客戶提供服務,提供對話式方式,從相容於MCP的使用者端檢查支援的Real-Time CDP資料和工作流程。 請閱讀本指南,瞭解整合如何運作、您可以執行什麼操作,以及如何開始使用。
Beta、安全性和法律注意事項 mcp-notices
Beta檔案通知:此檔案涵蓋Beta功能,不構成最終檔案。 此處描述的內容與Beta版本有關,且在正式發行前可能會有所變更。 Adobe不對本檔案的完整性或準確性發表任何宣告。
藉由使用Adobe Real-Time CDP MCP Server (Beta) (「Beta」),您在此確認Beta係依「原樣」提供,並無任何保固。 Adobe沒有義務維護、更正、更新、變更、修改或以其他方式支援Beta。 建議您謹慎使用,切勿依賴這類Beta及/或隨附資料的正確運作或效能。 Beta視為Adobe的機密資訊。 任何「意見回饋」(有關Beta的資訊,包括但不限於您在使用Beta時遇到的問題或缺陷、建議、改進和建議)會在此指派給Adobe,包括所有權利、標題,以及對此等意見回饋的興趣。
什麼是模型內容通訊協定? mcp-overview
行銷、資料和客戶體驗團隊越來越仰賴聊天式應用程式和開發人員工具(例如Anthropic Claude、OpenAI ChatGPT、Cursor和Microsoft Copilot Studio)來簡化日常工作。 這些應用程式支援模型內容通訊協定(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伺服器是 唯讀 監視與分類介面。 它會公開跨對象、目的地、來源、身分和設定檔解析度擷取API,作為AI助理內的簡單語言回答,而不需要撰寫查詢或導覽產品熒幕。 無法透過MCP伺服器建立、修改或刪除任何資料。
Beta版本包含下列18種工具:
search_audiencespreview_audience_membershipinspect_audience_evaluation_jobsinspect_audience_export_jobssearch_destination_connectorssearch_destination_accountssearch_destination_input_connectionssearch_destination_output_connectionssearch_destination_flowsinspect_flow_runssearch_source_connectorssearch_source_accountssearch_source_input_connectionssearch_source_output_connectionssearch_source_flowssearch_identity_namespacessearch_merge_policiessearch_organizations使用案例 mcp-use-cases
Real-Time CDP MCP伺服器是專為 監視與分級 所設計。 因為伺服器會使用ID而非名稱,所以典型的工作流程會從清單開始 — 詢問Claude以顯示可用的專案、選取您想要的專案,然後使用它傳回的ID提出後續問題。
prod沙箱中列出我的對象。」abc123的詳細資料和生命週期狀態。」homeAddress.country = 'US'。」xyz789的完整設定。」xyz789的執行歷程記錄並摘要任何錯誤。」src456的設定 — 它會擷取哪些內容,以及會登陸至何處?」src456的最近執行歷程記錄,並標示失敗。」存取與啟用 mcp-access
若要要求存取權,請執行下列動作:
- 請聯絡您的Adobe客戶代表(客戶成功經理、技術客戶經理或客戶主管),並表達您對Real-Time CDP MCP Beta計畫的興趣。
- 您的Adobe代表將與產品團隊協調,評估資格並啟用組織ID。
- 啟用後,您的Adobe代表將確認存取並提供任何其他入門材料。
先決條件 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
伺服器使用遠端HTTP (可串流HTTP)傳輸,以及瀏覽器式Adobe登入流程。 在每個使用者端中,設定模式都相同:
- 新增伺服器URL:
https://rtcdp-mcp.adobe.io/mcp - 儲存或啟用連線。
- 在使用者端第一次叫用工具時完成瀏覽器式Adobe登入。
- 在每個工作階段開始時提供
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"
}
}
}
在UI型使用者端中安裝 mcp-connect-ui
克勞德
對於claude.ai和Claude Desktop,請使用伺服器URL https://rtcdp-mcp.adobe.io/mcp將Real-Time CDP MCP伺服器新增為自訂聯結器。
- 個別計畫 — 在Claude中,瀏覽至自訂→聯結器,選取新增聯結器,然後輸入伺服器URL。
- 團隊和企業計畫 — 工作區 所有者 或 主要所有者 已在 組織設定→聯結器 下新增聯結器。 新增後,每個使用者都會以自己的Claude設定啟用它。
新增聯結器後,請在交談中啟用聯結器,並在第一次使用時完成Adobe瀏覽器登入。 Claude會自動發現Adobe授權伺服器 — 不需要使用者端ID或使用者端密碼。
ChatGPT
在ChatGPT中,將Real-Time CDP MCP伺服器新增為自訂聯結器:
- 瀏覽至設定→聯結器 (或設定→應用程式和聯結器,視您的計畫而定)。
- 選取 新增聯結器 並輸入
https://rtcdp-mcp.adobe.io/mcp做為伺服器URL。 - 儲存聯結器。 根據您的ChatGPT計畫,此步驟可能需要 開發人員模式 或工作區管理員核准。
- 聯結器啟用後,在第一次使用出現提示時,請透過Adobe瀏覽器登入進行驗證。
游標
在游標中,將Real-Time CDP MCP伺服器新增為遠端MCP伺服器:
- 開啟MCP →設定。
- 選取 新增伺服器 並輸入
https://rtcdp-mcp.adobe.io/mcp做為伺服器URL。 - 選取 連線 以觸發瀏覽器式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程式碼並執行:
/mcp
選取rtcdp伺服器並在瀏覽器中完成Adobe登入流程。 如果您已在claude.ai中新增伺服器,當兩者登入相同的帳戶時,伺服器可能會自動出現在Claude程式碼中。
法典
從終端機新增伺服器:
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租使用者:
imsOrgId— 您的組織ID,已對應至下游Experience Platform API呼叫上的x-gw-ims-org-id標題。sandboxName— Experience Platform沙箱名稱,已對應至x-sandbox-name標頭。
在每個工作階段開始時提供這些資訊。 例如:
「針對此工作階段使用組織
1234ABCD@AdobeOrg和沙箱prod。」
如果您不知道組織ID,請要求您的AI助理呼叫search_organizations — 它會傳回您的Adobe認證可以存取的每個組織。
已知限制(Beta) mcp-limitations
下列限制適用於Adobe Real-Time CDP MCP伺服器的目前Beta版本:
Preview Audience Membership需要有效的PQL或SDD運算式作為輸入;MCP伺服器不會為您撰寫查詢。continuationToken呼叫。Inspect Activation Runs支援依狀態和完成時間戳記(紀元毫秒UTC)篩選,但無法直接依錯誤型別或目的地平台篩選。flowId先篩選(從List Configured Destinations取得),將執行範圍設定到特定目的地。search_organizations除外)都需要imsOrgId和sandboxName做為明確引數。 若未提供這些引數,工具呼叫將會失敗。<YOUR_ORG_ID>和沙箱<SANDBOX_NAME>。」 如果您不知道組織ID,請先呼叫search_organizations — 它會傳回您的認證可存取的組織。