DocumentaçãoAEMTutoriais do AEM as a Cloud Service

Pesquisar conteúdo do AEM usando o servidor MCP da IA de conteúdo

Última atualização: 23 de julho de 2026
  • Aplica-se a:
  • Experience Manager as a Cloud Service

Criado para:

  • Beginner
  • Leader
  • User
  • Developer

Use o Servidor MCP da IA de Conteúdo do Adobe CX Coworker para pesquisar e analisar índices da IA de Conteúdo em linguagem natural, sem código de API de baixo nível ou navegação pela interface.

Neste tutorial, você descobre índices disponíveis, executa pesquisas de palavra-chave, semântica e híbrida e usa a pesquisa natural de linguagem para expressar intenções complexas, todas do Adobe CX Coworker em relação a um índice de IA de conteúdo.

Visão geral

A AEM as a Cloud Service fornece Servidores MCP para que o IDE ou aplicativo de chat funcione com a AEM de forma segura. O Servidor MCP da IA de Conteúdo expõe as ferramentas de pesquisa e descoberta em índices da IA de Conteúdo. Consulte Servidores MCP no AEM para obter mais informações.

O Servidor MCP da IA de conteúdo fornece seis ferramentas:

Ferramenta
Propósito
list_indexes
Descubra os índices disponíveis em seu ambiente do AEM.
get_index_config
Inspecione a configuração e os metadados do índice bruto.
fulltext_search
Pesquisa baseada em palavra-chave com correspondência difusa e seleção de campo.
semantic_search
Pesquisa de similaridade baseada em vetor para consultas conceituais.
hybrid_search
Palavra-chave combinada + pesquisa semântica para a melhor recuperação de uso geral.
natural_language_search
intenção expressa em inglês simples; o servidor a traduz em filtros estruturados, intervalos e semântica.

O Content AI MCP Server suporta dois modos de acesso, selecionados pelo cabeçalho que você configura:

  • Público (anônimo) — Pesquisar índices públicos somente leitura usando o cabeçalho X-Api-Key. Use-a para conteúdo não confidencial abertamente disponível. Consulte Pesquisando Índices Públicos.
  • Autenticado — Pesquise índices com direito ou acesso controlado usando o cabeçalho x-content-ai-mcp-api-key junto com sua identidade de Adobe conectada (passada pelo CX Co-worker). Os resultados respeitam suas permissões.

Como os desenvolvedores podem usá-lo

Conecte o Adobe CX Co-worker ao Servidor MCP da IA de conteúdo e execute o cenário abaixo.

Configuração - Servidor MCP de IA de conteúdo no Adobe CX Co-worker

Vamos configurar o Servidor de MCP da IA de conteúdo no Adobe CX Co-worker com essas etapas.

  1. Faça logon no Adobe CX Co-worker.

    Logon do Adobe CX Co-worker

  2. No painel lateral, clique em Servidores MCP.

    Painel Lateral dos Servidores MCP

  3. Clique em Adicionar Servidor MCP.

    Adicionar Servidor MCP

  4. Na caixa de diálogo Adicionar Servidor MCP, insira os seguintes detalhes:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
    Texto Valor
    Nome do servidor content-ai-mcp
    URL DO MCP https://mcp.adobeaemcloud.com/adobe/experimental/aemagents-expires-20260331/mcp/content-ai
    Tipo de conexão HTTP
    Tipo de autenticação Passthrough

    Adicionar Caixa de Diálogo do Servidor MCP

    note
    NOTE
    Tipo de autenticação está definido como Passthrough, portanto, o CX Coworker encaminha sua identidade de Adobe conectada ao Servidor MCP. Você não precisa de uma etapa de logon ou OAuth separada.

  5. Clique em Adicionar cabeçalhos e adicione os cabeçalhos para o modo de acesso necessário:

    Para índices públicos (anônimo):

    table 0-row-2 1-row-2 2-row-2
    Cabeçalho Valor
    X-Api-Key Sua chave de API pública. Apresente este cabeçalho quando quiser pesquisar apenas índices públicos.
    x-content-ai-mcp-routing (Opcional) Informações de ambiente/roteamento, por exemplo tier=publish,bucket=p12345-e67890,cluster=ethos21-prod-va7,namespace=ns-team-example.

    Para índices não públicos (qualificados):

    table 0-row-2 1-row-2 2-row-2
    Cabeçalho Valor
    x-content-ai-mcp-api-key A chave de API da Adobe Developer Console.
    x-content-ai-mcp-routing (Opcional) Informações de ambiente/roteamento, por exemplo tier=publish,bucket=p12345-e67890,cluster=ethos21-prod-va7,namespace=ns-team-example.
    note important
    IMPORTANT
    Quando o cabeçalho X-Api-Key está presente, o servidor trata a solicitação como anônima e pesquisa somente índices públicos. Qualquer identidade conectada é ignorada, portanto, não há escalonamento acidental para o acesso autenticado. Use x-content-ai-mcp-api-key (não X-Api-Key) quando pretender pesquisar índices qualificados.
    note
    NOTE
    Se você não definir o cabeçalho do x-content-ai-mcp-routing, o servidor solicitará seu ambiente (tier e bucket) no chat na primeira vez que você executar uma ferramenta e, em seguida, tentará novamente automaticamente.

  6. Clique em Adicionar. O servidor content-ai-mcp agora aparece na sua lista de Servidores MCP.

    Servidor MCP de IA de Conteúdo Listado

  7. Clique em Novo chat para começar a usar o Servidor MCP de IA de Conteúdo.

    Novo Chat

Pesquisar Índices Públicos

Alguns índices da IA de Conteúdo estão marcados como públicos e podem ser pesquisados anonimamente, sem uma identidade qualificada. Os índices públicos são somente leitura e se destinam a conteúdo não confidencial abertamente disponível. Qualquer pessoa com a chave de API pública pode pesquisá-las.

Use este modo quando:

  • Você deseja pesquisar conteúdo disponível abertamente (por exemplo, documentação pública ou um catálogo de demonstração).
  • Você não precisa de resultados com escopo de permissão por usuário.
  • Você deseja uma configuração simples que exija apenas uma chave de API.

Para pesquisar índices públicos, adicione o Servidor MCP de IA de Conteúdo no CX Coworker exatamente como descrito em Configuração - Servidor MCP de IA de Conteúdo no Adobe CX Coworker, mas na etapa Adicionar cabeçalhos, adicione apenas o cabeçalho X-Api-Key (além de um cabeçalho x-content-ai-mcp-routing opcional para o ambiente):

Cabeçalho
Valor
X-Api-Key
Sua chave de API pública.
x-content-ai-mcp-routing
(Opcional) Informações de ambiente/roteamento, por exemplo tier=publish,bucket=p12345-e67890.
IMPORTANT
Quando o cabeçalho X-Api-Key está presente, o servidor trata a solicitação como anônima e pesquisa somente índices públicos. Qualquer identidade conectada é ignorada. Não use X-Api-Key quando pretender pesquisar índices autorizados, use x-content-ai-mcp-api-key em vez disso.

Com o servidor conectado, descubra e pesquise índices públicos da mesma forma que os índices autenticados.

  1. No CX Co-Worker, abra um novo chat e liste os índices públicos disponíveis para sua chave de API:

    code language-text 
    List all Content AI indexes available in my environment.

    O servidor pesquisa somente índices públicos para essa solicitação e retorna resultados correspondentes.

Resumo

Você configurou o servidor MCP da IA de conteúdo do AEM no Adobe CX Co-worker e o usou para pesquisar índices da IA de conteúdo. Você descobriu os índices disponíveis e os pesquisou em linguagem natural, usando a palavra-chave, semântica, híbrida e pesquisa em linguagem natural. Você também aprendeu a pesquisar índices públicos anonimamente com uma chave de API e a reduzir o tamanho da resposta com a seleção de campo. Você pode usar o mesmo fluxo centrado no ser humano do CX Co-worker para pesquisar e analisar índices da IA de conteúdo sem alternar para uma interface ou gravar o código da API de pesquisa de baixo nível.

recommendation-more-help
experience-manager-learn-help-cloud-service