Instalar o Adobe CX Co-worker Gateway mcp-install
Leia este guia para saber como conectar um cliente compatível com MCP ao Adobe CX Co-worker Gateway. O CX Co-worker Gateway usa um endpoint para todas as ferramentas de produto documentadas:
https://cx-coworker-gateway.adobe.io/mcp
Antes de instalar, confirme se a organização e a conta de usuário podem acessar as ferramentas do produto necessárias. Consulte Acessar as ferramentas do CX Co-worker Gateway.
Como a instalação funciona mcp-install-how
O CX Co-worker Gateway usa um transporte HTTP remoto com um fluxo de logon Adobe baseado em navegador. Em todos os clientes compatíveis, o padrão de configuração é o mesmo:
- Adicione a URL do ponto de extremidade:
https://cx-coworker-gateway.adobe.io/mcp. - Salve ou habilite a conexão.
- Conclua o logon do Adobe com base em navegador na primeira vez que o cliente chamar uma ferramenta.
- Defina o contexto do produto para a sessão se suas ferramentas exigirem — organização para todos os produtos, sandbox para ferramentas baseadas no Experience Platform e visualização de dados para o Customer Journey Analytics. Consulte Contexto do produto para chamadas de ferramenta.
Instalação corporativa (gerenciada pelo administrador) mcp-install-enterprise
A maioria dos planos de equipes e clientes MCP empresariais exige que um administrador adicione conectores personalizados à organização. Nesses ambientes, a instalação do tem duas etapas:
- Um administrador adiciona o endpoint do gateway do CX Co-worker uma vez para a organização.
- Cada usuário ativa o conector e faz logon com suas próprias credenciais do Adobe.
Etapa 1: Um administrador adiciona o endpoint mcp-install-enterprise-admin
O administrador adiciona https://cx-coworker-gateway.adobe.io/mcp como um conector personalizado ou servidor MCP remoto nas configurações da organização do cliente. O local exato depende do cliente.
Claude Team e Enterprise mcp-install-enterprise-claude
Nos planos de Equipe e Empresa do Claude, os conectores no nível da organização são gerenciados por um Proprietário ou Proprietário Primário do espaço de trabalho.
- Entre em Claude como um Proprietário ou Proprietário Primário.
- Vá para Configurações > Administração > Conectores. Em alguns planos, isso aparece como Configurações da organização > Conectores.
- Selecione Adicionar conector personalizado.
- Digite
https://cx-coworker-gateway.adobe.io/mcpcomo a URL do servidor e use um nome reconhecível, como “Adobe para CX Co-worker Gateway”. - Salve o conector.
Equipe ChatGPT e Empresa mcp-install-enterprise-chatgpt
Nos espaços de trabalho Equipe e Empresa do ChatGPT, os conectores são adicionados por um administrador de espaço de trabalho.
- Entre no ChatGPT como administrador de espaço de trabalho.
- Vá para Configurações > Conectores. Em alguns planos, isso aparece como Configurações > Aplicativos e Conectores.
- Selecione Adicionar conector.
- Digite
https://cx-coworker-gateway.adobe.io/mcpcomo a URL do servidor. - Salve o conector. Dependendo da configuração do espaço de trabalho, essa etapa pode exigir a ativação do modo de desenvolvedor ou a concessão de aprovação no nível do espaço de trabalho.
Outros clientes gerenciados pela organização mcp-install-enterprise-other
Para outros clientes que oferecem suporte a conectores remotos gerenciados por organização, adicione o CX Co-worker Gateway como um servidor HTTP MCP remoto usando o https://cx-coworker-gateway.adobe.io/mcp. Deixe os cabeçalhos opcionais, os campos de token do portador, os campos de ID do cliente e os campos de segredo do cliente vazios, a menos que o cliente exija um valor de espaço reservado.
Etapa 2: Usuários habilitam o conector mcp-install-enterprise-user
Depois que um administrador adiciona o CX Co-worker Gateway, cada usuário o habilita para sua própria conta:
- Abra as configurações de conector pessoal, aplicativo ou MCP no cliente.
- Localize o conector do CX Co-worker Gateway e ative-o.
- Inicie uma conversa, chame uma das ferramentas do Adobe e conclua o logon da Adobe com base no navegador quando solicitado.
- Defina o contexto do produto para a sessão se suas ferramentas exigirem — organização para todos os produtos, sandbox para ferramentas baseadas no Experience Platform e visualização de dados para o Customer Journey Analytics. Consulte Contexto do produto para chamadas de ferramenta.
Os usuários não precisam inserir o URL sozinhos quando um administrador já tiver adicionado o conector para a organização.
Instalação individual (autoatendimento) mcp-install-individual
Se você usar um plano individual, um cliente de desenvolvedor configurado localmente ou uma organização que permita aos membros adicionar seus próprios conectores, adicione o endpoint diretamente nas configurações do seu cliente.
Claude individual mcp-install-individual-claude
Para a Área de Trabalho claude.ai e Claude em um plano individual:
- Abra Configurações > Conectores.
- Selecione Adicionar conector personalizado.
- Digite
https://cx-coworker-gateway.adobe.io/mcpcomo a URL do servidor. - Salve e ative o conector e conclua o fluxo de logon do Adobe na primeira utilização.
ChatGPT individual mcp-install-individual-chatgpt
- Abra Configurações > Conectores. Em alguns planos, isso aparece como Configurações > Aplicativos e Conectores.
- Selecione Adicionar conector.
- Digite
https://cx-coworker-gateway.adobe.io/mcpcomo a URL do servidor. - Salve e ative o conector e conclua o fluxo de logon do Adobe na primeira utilização.
Cursor mcp-install-individual-cursor
- Abra Configurações > MCP.
- Selecione Adicionar novo servidor.
- Digite
https://cx-coworker-gateway.adobe.io/mcpcomo a URL do servidor. - Selecione Conectar e conclua o fluxo de entrada da Adobe.
Após a conexão, as ferramentas Adobe para CX Co-worker Gateway estão disponíveis nos modos Composer e Agente do cursor.
código Claude mcp-install-individual-claude-code
Adicione o endpoint do terminal:
claude mcp add --transport http cx-enterprise https://cx-coworker-gateway.adobe.io/mcp
Em seguida, inicie Claude Code e execute:
/mcp
Selecione o servidor cx-enterprise e conclua o fluxo de entrada do Adobe em seu navegador.
Codex mcp-install-individual-codex
Adicione o endpoint do terminal:
codex mcp add cx-enterprise --url https://cx-coworker-gateway.adobe.io/mcp
Autenticar:
codex mcp login cx-enterprise
Verifique a configuração:
codex mcp list
Você também pode adicionar o ponto de extremidade diretamente a ~/.codex/config.toml:
[mcp_servers.cx-enterprise]
url = "https://cx-coworker-gateway.adobe.io/mcp"
Configuração JSON geral mcp-install-individual-json
Para clientes que aceitam uma configuração de servidor MCP baseada em JSON, use um dos formatos a seguir, dependendo se o cliente suporta HTTP remoto nativo ou requer uma ponte local.
Via mcp-remote ponte
{
"mcpServers": {
"cx-enterprise": {
"command": "npx",
"args": [
"mcp-remote",
"https://cx-coworker-gateway.adobe.io/mcp"
]
}
}
}
HTTP remoto nativo
{
"mcpServers": {
"cx-enterprise": {
"url": "https://cx-coworker-gateway.adobe.io/mcp",
"transport": "http"
}
}
}
Outros clientes mcp-install-individual-other
Para outros desktops ou clientes Web com suporte a MCP remoto, adicione o Adobe for CX Co-worker Gateway como um servidor HTTP remoto usando o https://cx-coworker-gateway.adobe.io/mcp. Deixe os cabeçalhos opcionais, os campos de token do portador, os campos de ID do cliente e os campos de segredo do cliente vazios, a menos que o cliente exija um valor de espaço reservado.
Contexto do produto para chamadas de ferramenta mcp-connect-params
O MCP aplica escopos a cada chamada de ferramenta para uma organização ativa da Adobe. Além disso, os requisitos de contexto dependem do produto:
- Produtos baseados no Experience Platform — as ferramentas do Real-Time CDP, Experience Platform e Journey Optimizer operam em uma sandbox Experience Platform. Defina a sandbox uma vez por sessão; todos os três a compartilham.
- Outros produtos — Os produtos não criados no Experience Platform não usam o contexto de sandbox. As ferramentas do Adobe Analytics, Customer Journey Analytics, Workfront, Marketo e Target são resolvidas em relação aos próprios recursos do produto — por exemplo, visualizações de dados para o Customer Journey Analytics e conjuntos de relatórios para o Adobe Analytics.
Definir o contexto uma vez no início de uma sessão — as ferramentas de produtos individuais não alternam entre organizações, sandboxes ou exibições de dados no meio da sessão. Consulte Ferramentas de contexto de sessão para obter as ferramentas que definem o contexto de organização, sandbox e visualização de dados.
Exemplo:
“Use a organização
1234ABCD@AdobeOrg, a sandboxprode a visualização de dadosMy Company — Globalpara esta sessão.”
Se você não souber os valores necessários, peça ao cliente MCP para listar as organizações, sandboxes ou visualizações de dados disponíveis para suas credenciais do Adobe.