[Beta]{class="badge informative"}
Trabalhar com clientes MCP (Beta) rtcdp-mcp
Você pode usar a integração do Adobe Real-Time CDP MCP para consultar públicos, destinos e integridade da ativação usando prompts em linguagem simples, sem gravar chamadas de API ou navegar nas telas dos produtos. Essa integração atende clientes do Adobe Real-Time CDP e do Adobe Real-Time CDP B2B edition, fornecendo uma maneira conversacional de inspecionar dados e workflows compatíveis do Real-Time CDP de clientes compatíveis com MCP. Leia este guia para saber como a integração funciona, o que você pode fazer com ela e como começar.
Beta, segurança e avisos legais mcp-notices
aviso sobre a documentação do Beta: esta documentação abrange um recurso do Beta e não constitui a documentação final. O conteúdo descrito aqui está relacionado a uma versão do Beta e está sujeito a alterações até sua disponibilização geral. A Adobe não faz declarações sobre a integridade ou a precisão desta documentação.
Ao usar o Adobe Real-Time CDP MCP Server (Beta) (“Beta”), você reconhece que o Beta é fornecido “no estado em que se encontra” sem garantias de qualquer tipo. A Adobe não tem nenhuma obrigação de manter, corrigir, atualizar, alterar, modificar ou oferecer suporte à Beta. É recomendável ter cuidado e não depender de forma alguma do funcionamento ou desempenho correto desse Beta e/ou dos materiais que o acompanham. O Beta é considerado Informações confidenciais da Adobe. Qualquer “Feedback” (informação sobre o Beta incluindo, mas não se limitando a, problemas ou defeitos encontrados durante o uso do Beta, sugestões, melhorias e recomendações) fornecido por Você ao Adobe é atribuído ao Adobe, incluindo todos os direitos, cargos e interesses no e no Feedback.
Qual é o protocolo de contexto do modelo? mcp-overview
As equipes de marketing, dados e experiência do cliente dependem cada vez mais de aplicativos baseados em bate-papo e ferramentas de desenvolvedor — como Anthropic Claude, OpenAI ChatGPT, Cursor e Microsoft Copilot Studio — para simplificar seu trabalho diário. Esses aplicativos oferecem suporte ao Protocolo de Contexto de Modelo (MCP), um padrão aberto que permite que os aplicativos exponham ferramentas de back-end a grandes modelos de idioma (LLMs) de maneira uniforme.
O Real-Time CDP agora fornece um servidor MCP que exibe operações de público-alvo, destino e ativação diretamente dentro de qualquer aplicativo compatível com MCP. Com a integração do Real-Time CDP MCP, diferentes personalidades podem colaborar em torno da mesma segmentação e dados de ativação — sem gravar consultas nas APIs REST do Adobe Experience Platform ou navegar por várias telas de interface do usuário. Os clientes podem descrever a intenção por conversação e permitir que o LLM chame as ferramentas de MCP apropriadas.
Principais recursos mcp-capabilities
O servidor MCP do Real-Time CDP é uma superfície de monitoramento e triagem somente leitura. Ele expõe APIs de recuperação em públicos, destinos, fontes, identidade e resolução de perfil como respostas em linguagem simples no assistente de IA, sem escrever consultas ou navegar pelas telas do produto. Nenhum dado pode ser criado, modificado ou excluído por meio do servidor MCP.
A versão do Beta inclui as 18 ferramentas a seguir:
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_organizationsCasos de uso mcp-use-cases
O servidor MCP do Real-Time CDP foi criado para monitoramento e triagem. Como o servidor funciona com IDs em vez de nomes, um fluxo de trabalho típico começa com uma lista — peça a Claude para mostrar o que está disponível, escolha o item desejado e faça perguntas de acompanhamento usando a ID retornada.
prod.”abc123.”homeAddress.country = 'US'.”xyz789.”xyz789 e resumir os erros.”src456 — o que ele está assimilando e onde ele chega?”src456 e sinalizar falhas.”Acesso e habilitação mcp-access
Para solicitar acesso:
- Entre em contato com seu representante de conta da Adobe (Gerente de sucesso do cliente, Gerente técnico de conta ou Executivo de conta) e expresse seu interesse no programa Real-Time CDP MCP Beta.
- O representante da Adobe entrará em contato com a equipe de produtos para avaliar a qualificação e habilitar a ID da organização.
- Depois de ativado, o representante da Adobe confirmará o acesso e fornecerá material de integração adicional.
Pré-requisitos mcp-prerequisites
Antes de conectar o servidor MCP do Real-Time CDP ao seu cliente MCP, verifique o seguinte:
- Você tem uma licença ativa do Real-Time CDP.
- Sua organização da Adobe foi habilitada para o programa Beta pelo representante da Adobe (consulte Acesso e habilitação).
- Você tem acesso a um cliente MCP com suporte, como Claude, ChatGPT, Claude Code, Codex, Cursor ou VS Code.
- Você tem a ID da organização e o nome da sandbox que deseja consultar.
- Você tem as permissões necessárias no Adobe Experience Platform para exibir públicos, destinos e entidades de serviço de fluxo.
Conectar o servidor MCP do Real-Time CDP mcp-connect
O ponto final do servidor MCP do Real-Time CDP é:
https://rtcdp-mcp.adobe.io/mcp
O servidor usa um transporte HTTP remoto com um fluxo de entrada do Adobe baseado em navegador. Em todos os clientes, o padrão de configuração é o mesmo:
- Adicionar a URL do servidor:
https://rtcdp-mcp.adobe.io/mcp - Salve ou habilite a conexão.
- Conclua o logon do Adobe baseado em navegador na primeira vez que o cliente chamar uma ferramenta.
- Forneça
imsOrgIdesandboxNameno início de cada sessão.
Configuração JSON geral mcp-connect-json
Para clientes que aceitam uma configuração de servidor MCP baseada em JSON, como Claude Desktop (claude_desktop_config.json), Código VS ou qualquer cliente que leia um arquivo mcp.json, use um dos seguintes formatos, dependendo se o cliente oferece suporte a HTTP remoto nativo ou requer uma ponte local:
Via ponte mcp-remote (Claude Desktop e outros clientes que requerem uma ponte local)
{
"mcpServers": {
"rtcdp": {
"command": "npx",
"args": [
"mcp-remote",
"https://rtcdp-mcp.adobe.io/mcp"
]
}
}
}
HTTP remoto nativo (clientes que dão suporte a ele diretamente)
{
"mcpServers": {
"rtcdp": {
"url": "https://rtcdp-mcp.adobe.io/mcp",
"transport": "http"
}
}
}
Instalar em clientes baseados em interface do usuário mcp-connect-ui
Claude
Para claude.ai e Claude Desktop, adicione o servidor MCP do Real-Time CDP como um conector personalizado usando a URL do servidor https://rtcdp-mcp.adobe.io/mcp.
- Planos individuais — Em Claude, navegue até Personalizar → Conectores, selecione Adicionar conector e insira a URL do servidor.
- Planos de Equipe e Empresa — Um espaço de trabalho Proprietário ou Proprietário Primário adiciona o conector em Configurações da organização → Conectores. Depois de adicionado, cada usuário o ativa em suas próprias configurações do Claude.
Depois que o conector for adicionado, ative-o em uma conversa e conclua o logon no navegador do Adobe na primeira utilização. Claude descobre o servidor de autorização do Adobe automaticamente — nenhuma ID do cliente ou segredo do cliente é necessário.
ChatGPT
Em ChatGPT, adicione o servidor MCP do Real-Time CDP como um conector personalizado:
- Navegue até Configurações → Conectores (ou Configurações → Aplicativos e conectores, dependendo do seu plano).
- Selecione Adicionar conector e insira
https://rtcdp-mcp.adobe.io/mcpcomo a URL do servidor. - Salve o conector. Dependendo do seu plano do ChatGPT, esta etapa pode exigir Modo de desenvolvedor ou aprovação do administrador do espaço de trabalho.
- Quando o conector estiver ativado, autentique por meio do logon no navegador da Adobe quando solicitado na primeira vez que usar o.
Cursor
No Cursor, adicione o servidor MCP do Real-Time CDP como um servidor MCP remoto:
- Abra Configurações → MCP.
- Selecione Adicionar novo servidor e insira
https://rtcdp-mcp.adobe.io/mcpcomo a URL do servidor. - Selecione conectar para acionar a entrada da Adobe baseada em navegador e autenticar.
Depois de conectadas, as ferramentas do Real-Time CDP ficam disponíveis nos modos Compositor e Agente do cursor.
Outros clientes com base na interface do usuário
Para clientes como o Código VS ou outros aplicativos Web e de área de trabalho com suporte a MCP remoto, adicione o servidor MCP do Real-Time CDP como um servidor HTTP remoto usando https://rtcdp-mcp.adobe.io/mcp. Se o cliente suportar cabeçalhos opcionais ou tokens de portador, deixe-os vazios. A autenticação é realizada por meio do fluxo de logon do Adobe com base em navegador na primeira utilização.
Instalar em clientes técnicos mcp-connect-technical
código Claude
Adicione o servidor do terminal:
claude mcp add --transport http rtcdp https://rtcdp-mcp.adobe.io/mcp
Em seguida, inicie o Claude Code e execute:
/mcp
Selecione o servidor rtcdp e conclua o fluxo de logon do Adobe em seu navegador. Se você já tiver adicionado o servidor no claude.ai, ele poderá aparecer automaticamente no Código Claude quando ambos estiverem conectados à mesma conta.
Codex
Adicione o servidor do terminal:
codex mcp add rtcdp --url https://rtcdp-mcp.adobe.io/mcp
Autentique o servidor:
codex mcp login rtcdp
Verifique a configuração:
codex mcp list
Você também pode adicionar o servidor diretamente a ~/.codex/config.toml:
[mcp_servers.rtcdp]
url = "https://rtcdp-mcp.adobe.io/mcp"
Parâmetros de solicitação obrigatórios mcp-connect-params
Cada chamada de ferramenta requer dois parâmetros que definem o escopo da solicitação para o locatário do Adobe Experience Platform:
imsOrgId— sua ID de organização, mapeada para o cabeçalhox-gw-ims-org-idnas chamadas downstream de API do Experience Platform.sandboxName— o nome da sandbox do Experience Platform, mapeado para o cabeçalhox-sandbox-name.
Forneça-os no início de cada sessão. Por exemplo:
“Use a organização
1234ABCD@AdobeOrge a sandboxprodpara esta sessão.”
Se você não souber a ID da organização, peça para o seu assistente de IA ligar para search_organizations — ele retornará todas as organizações que suas credenciais da Adobe puderem acessar.
Limitações conhecidas (Beta) mcp-limitations
As seguintes limitações se aplicam à versão atual do Beta do servidor MCP Adobe Real-Time CDP:
Preview Audience Membership requer uma expressão PQL ou SDD válida como entrada; o servidor MCP não compõe a consulta para você.continuationToken.Inspect Activation Runs oferece suporte à filtragem por status e carimbo de data/hora de conclusão (ms UTC de época), mas não diretamente por tipo de erro ou plataforma de destino.flowId primeiro (obtido de List Configured Destinations) para escopo é executado para um destino específico.search_organizations) requer imsOrgId e sandboxName como parâmetros explícitos. Se elas não forem fornecidas, as chamadas de ferramenta falharão.<YOUR_ORG_ID> e a sandbox <SANDBOX_NAME> para esta sessão.” Se você não souber a ID da organização, chame search_organizations primeiro. Ela retornará as organizações que suas credenciais podem acessar.