[Beta 版]{class="badge informative"}
使用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时遇到的问题或缺陷、建议、改进和推荐)均会分配给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服务器是 只读 监视和分类表面。 它会在您的AI助手中公开跨受众、目标、源、身份和配置文件解析检索API,作为纯语言答案,而无需编写查询或导航产品屏幕。 不能通过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代表已为Beta计划启用Adobe组织(请参阅访问和启用)。
- 您有权访问支持的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。 - 选择 connect 以触发基于浏览器的Adobe登录和身份验证。
连接后,Real-Time CDP工具在Cursor的“编辑器”和“代理”模式下可用。
其他基于用户界面的客户端
对于客户端(如VS Code或其他支持远程MCP的桌面和Web应用程序),请使用https://rtcdp-mcp.adobe.io/mcp将Real-Time CDP MCP服务器添加为 远程HTTP 服务器。 如果客户端支持可选标头或持有者令牌,请将它们留空 — 身份验证在首次使用时通过基于浏览器的Adobe登录流处理。
在技术客户端中安装 mcp-connect-technical
Claude码
从终端添加服务器:
claude mcp add --transport http rtcdp https://rtcdp-mcp.adobe.io/mcp
然后启动Claude Code并运行:
/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 — 它将返回您的凭据可以访问的组织。