安装Adobe CX Co-worker网关 mcp-install
阅读本指南,了解如何将与MCP兼容的客户端连接到Adobe CX Co-worker Gateway。 CX Co-worker Gateway对所有有文档记录的产品工具使用一个端点:
https://cx-coworker-gateway.adobe.io/mcp
安装之前,请确认您的组织和用户帐户可以访问所需的产品工具。 请参阅访问CX Co-worker网关工具。
安装工作原理 mcp-install-how
CX Co-worker Gateway使用远程HTTP传输和基于浏览器的Adobe登录流程。 在每个受支持的客户端中,安装模式都相同:
- 添加终结点URL:
https://cx-coworker-gateway.adobe.io/mcp。 - 保存或启用连接。
- 在客户端首次调用工具时,完成基于浏览器的Adobe登录。
- 设置会话的产品上下文(如果您的工具需要) — 组织所有产品,为基于Experience Platform的工具设置沙盒,并为Customer Journey Analytics设置数据视图。 查看工具调用的产品上下文。
企业安装(管理员管理) mcp-install-enterprise
大多数团队和企业MCP客户端计划要求管理员为组织添加自定义连接器。 在这些环境中,安装分为两个步骤:
- 管理员为组织添加一次CX Co-worker Gateway端点。
- 每个用户都使用自己的Adobe凭据启用连接器并登录。
步骤1:管理员添加端点 mcp-install-enterprise-admin
管理员在客户端的组织设置中添加https://cx-coworker-gateway.adobe.io/mcp作为自定义连接器或远程MCP服务器。 确切的位置取决于客户端。
Claude团队和企业 mcp-install-enterprise-claude
在Claude团队和企业计划中,组织级别的连接器由工作区 所有者 或 主要所有者 管理。
- 以 所有者 或 主要所有者 的身份登录到Claude。
- 转到设置 > 管理 > 连接器。 在某些计划中,它显示为组织设置 > 连接器。
- 选择添加自定义连接器。
- 输入
https://cx-coworker-gateway.adobe.io/mcp作为服务器URL,并使用可识别的名称,如“Adobe for CX Co-worker Gateway”。 - 保存连接器。
ChatGPT团队和企业 mcp-install-enterprise-chatgpt
在ChatGPT团队和企业工作区中,连接器由工作区管理员添加。
- 以工作区管理员身份登录到ChatGPT。
- 转到设置 > 连接器。 在某些计划中,它显示为设置 > 应用和连接器。
- 选择添加连接器。
- 输入
https://cx-coworker-gateway.adobe.io/mcp作为服务器URL。 - 保存连接器。 根据您的工作区配置,此步骤可能需要启用开发人员模式或授予工作区级别的批准。
其他组织管理的客户端 mcp-install-enterprise-other
对于支持组织管理的远程连接器的其他客户端,请使用https://cx-coworker-gateway.adobe.io/mcp将CX Co-worker Gateway添加为远程HTTP MCP服务器。 除非您的客户端需要占位符值,否则将可选标头、持有者令牌字段、客户端ID字段和客户端密钥字段保留为空。
步骤2:用户启用连接器 mcp-install-enterprise-user
管理员添加CX Co-worker Gateway后,每个用户都为其自己的帐户启用它:
- 在客户端中打开个人连接器、应用程序或MCP设置。
- 找到CX Co-worker Gateway连接器并启用它。
- 开始对话,调用某个Adobe工具,然后在出现提示时完成基于浏览器的Adobe登录。
- 设置会话的产品上下文(如果您的工具需要) — 组织所有产品,为基于Experience Platform的工具设置沙盒,并为Customer Journey Analytics设置数据视图。 查看工具调用的产品上下文。
当管理员已经为组织添加了连接器时,用户无需输入URL本身。
单独安装(自助服务) mcp-install-individual
如果您使用单个计划、本地配置的开发人员客户端或允许成员添加自己的连接器的组织,请直接在您自己的客户端设置中添加端点。
克劳德个体 mcp-install-individual-claude
对于单个计划中的claude.ai和Claude桌面:
- 打开设置 > 连接器。
- 选择添加自定义连接器。
- 输入
https://cx-coworker-gateway.adobe.io/mcp作为服务器URL。 - 保存并启用连接器,然后在首次使用时完成Adobe登录流程。
ChatGPT个人 mcp-install-individual-chatgpt
- 打开设置 > 连接器。 在某些计划中,它显示为设置 > 应用和连接器。
- 选择添加连接器。
- 输入
https://cx-coworker-gateway.adobe.io/mcp作为服务器URL。 - 保存并启用连接器,然后在首次使用时完成Adobe登录流程。
光标 mcp-install-individual-cursor
- 打开设置 > MCP。
- 选择添加新服务器。
- 输入
https://cx-coworker-gateway.adobe.io/mcp作为服务器URL。 - 选择 连接 并完成Adobe登录流程。
连接后,在Cursor的Composer和Agent模式中提供了标题为Adobe for CX Co-worker Gateway的工具。
Claude码 mcp-install-individual-claude-code
从终端添加端点:
claude mcp add --transport http cx-enterprise https://cx-coworker-gateway.adobe.io/mcp
然后启动Claude Code并运行:
/mcp
选择cx-enterprise服务器并在浏览器中完成Adobe登录流程。
法典 mcp-install-individual-codex
从终端添加端点:
codex mcp add cx-enterprise --url https://cx-coworker-gateway.adobe.io/mcp
身份验证:
codex mcp login cx-enterprise
验证配置:
codex mcp list
您还可以将终结点直接添加到~/.codex/config.toml:
[mcp_servers.cx-enterprise]
url = "https://cx-coworker-gateway.adobe.io/mcp"
常规JSON配置 mcp-install-individual-json
对于接受基于JSON的MCP服务器配置的客户端,请根据您的客户端是支持本机远程HTTP还是需要本地网桥,使用以下格式之一。
通过mcp-remote桥
{
"mcpServers": {
"cx-enterprise": {
"command": "npx",
"args": [
"mcp-remote",
"https://cx-coworker-gateway.adobe.io/mcp"
]
}
}
}
本机远程HTTP
{
"mcpServers": {
"cx-enterprise": {
"url": "https://cx-coworker-gateway.adobe.io/mcp",
"transport": "http"
}
}
}
其他客户端 mcp-install-individual-other
对于支持远程MCP的其他桌面或Web客户端,请使用https://cx-coworker-gateway.adobe.io/mcp添加作为HTTP服务器的适用于CX协同工作网关的Adobe。 除非您的客户端需要占位符值,否则将可选标头、持有者令牌字段、客户端ID字段和客户端密钥字段保留为空。
工具调用的产品上下文 mcp-connect-params
MCP将每个工具调用范围限定为一个活动的Adobe组织。 除此之外,上下文要求取决于产品:
- 基于Experience Platform的产品 — Real-Time CDP、Experience Platform和Journey Optimizer工具在Experience Platform沙盒中运行。 每个会话设置沙盒一次;所有三个会话都共享该沙盒。
- 其他产品 — 未在Experience Platform上构建的产品不使用沙盒上下文。 Adobe Analytics、Customer Journey Analytics、Workfront、Marketo和Target工具针对其各自的产品资源进行解析,例如Customer Journey Analytics的数据视图和Adobe Analytics的报表包。
在会话开始时设置一次上下文 — 单个产品工具在会话期间不会切换组织、沙盒或数据视图。 有关设置组织、沙盒和数据视图上下文的工具,请参阅会话上下文工具。
示例:
“在此会话中使用组织
1234ABCD@AdobeOrg、沙盒prod和数据视图My Company — Global。”
如果您不知道所需的值,请让您的MCP客户端列出可用于您的Adobe凭据的组织、沙盒或数据视图。