Acelere as operações de conteúdo do AEM usando o servidor MCP de conteúdo

Use o Servidor MCP de Conteúdo de um IDE alimentado por IA, como o IDE de Cursor, para trabalhar com conteúdo do AEM em linguagem natural, sem código de API de baixo nível ou navegação pela interface do usuário.

Neste tutorial, você revisa detalhes do fragmento de conteúdo Adventure, atualiza um fragmento (por exemplo, o preço de uma aventura) e verifica a alteração no aplicativo WKND Adventures React de seu IDE em um ambiente AEM inferior (RDE ou Desenvolvimento) sem sair do fluxo do MCP.

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 de Conteúdo oferece suporte a páginas, fragmentos e ativos. Consulte Servidores MCP no AEM para obter mais informações.

Como os desenvolvedores podem usá-lo

Conecte o IDE de Cursor ao Servidor MCP de Conteúdo e execute o cenário abaixo.

Configuração - Servidor MCP de Conteúdo no Cursor

Vamos configurar o Servidor de MCP de Conteúdo no Cursor com essas etapas.

  1. Abra o cursor em sua máquina.

  2. Vá para Configurações > Configurações do Cursor no menu Cursor para abrir a janela de configurações.
    Configurações do cursor

  3. Na barra lateral esquerda, clique em Ferramentas & MCP para abrir esse painel.
    Ferramentas e MCP

  4. Clique em Adicionar MCP personalizado ou Novo servidor MCP para abrir o mcp.json e cole nesta configuração:

    code language-json
    {
        "mcpServers": {
            // Use this for create, read, update, and delete operations
            "AEM-RDE-Content": {
                "url": "https://mcp.adobeaemcloud.com/adobe/mcp/content"
            },
            //Use this for read-only operations
            "AEM-RDE-Content-Read-Only": {
                "url": "https://mcp.adobeaemcloud.com/adobe/mcp/content-readonly"
            }
        }
    }
    
    note caution
    CAUTION
    Para fins de tutorial, a configuração acima adiciona Conteúdo e Conteúdo (somente leitura) para este tutorial. Na prática, o Conteúdo já inclui todas as ofertas de Conteúdo (somente leitura), além das ferramentas de criação/atualização/exclusão.
    Para evitar qualquer possibilidade de criação, modificação ou exclusão de conteúdo, configure apenas Conteúdo (somente leitura) (/content-readonly) e omita Conteúdo (/content). Dessa forma, você evita alterações acidentais.

    Adicionar Servidor MCP do AEM

  5. Na janela Configurações do cursor, clique em Conectar para iniciar o processo de autenticação. Ele usa o fluxo PKCE do OAuth 2.0 para obter o Token de Acesso Específico do Usuário para acessar o Servidor MCP do AEM.
    Conectar-se ao AEM MCP Server

  6. Faça logon com a Adobe ID e volte para a janela Configurações do cursor.
    Logon com o Adobe ID

  7. Confirme se o AEM-RDE-Content-Read-Only e o AEM-RDE-Content aparecem como conectados. Você pode expandir cada servidor para ver suas ferramentas.

    Servidores MCP do AEM

Configuração - Aplicativo WKND Adventures React

Em seguida, configure o Aplicativo WKND Adventures React no Cursor.

  1. Clonar estes dois repositórios no computador:

    code language-bash
    ## WKND GraphQL repo, the `react-app` folder is the WKND Adventures app
    $ git clone git@github.com:adobe/aem-guides-wknd-graphql.git
    
    ## WKND Site repo, you deploy this to RDE so the app can use its content fragments data via GraphQL
    $ git clone git@github.com:adobe/aem-guides-wknd.git
    
  2. Implante o projeto WKND Site no RDE. Para obter etapas detalhadas, consulte Como usar o Ambiente de Desenvolvimento Rápido.

  3. Abra a pasta react-app no IDE.

  4. Editar .env.development e definir:

    • REACT_APP_HOST_URI: sua URL de Autor RDE
    • REACT_APP_AUTH_METHOD: ser basic
    • REACT_APP_BASIC_AUTH_USER e REACT_APP_AEM_AUTH_PASSWORD: ser aem-headless (criar este usuário no RDE e adicioná-lo ao grupo administrators)
  5. No terminal IDE, execute:

    code language-bash
    $ cd aem-guides-wknd-graphql/react-app
    $ npm install
    $ npm start
    
  6. Em seu navegador, vá para http://localhost:3000 para exibir o aplicativo WKND Adventures.

    Aplicativo React - Aventuras WKND

Cenário de produtividade - Revisão e atualização de conteúdo do AEM

Suponha que você precise mostrar um banner de HOT DEAL em cartões Adventure quando uma regra simples é atendida. A abordagem habitual seria:

  • Observe o código do componente Cartões de aventura
  • Adicionar a lógica de quando mostrar o banner
  • Verifique o modelo de fragmento de conteúdo do Adventure no AEM
  • Altere uma ou mais propriedades do fragmento Aventura para testar a regra

Para simplificar as coisas, vamos mostrar o banner HOT DEAL quando o preço da aventura estiver abaixo de US$ 100.

Como o aplicativo React obtém os dados do ambiente RDE, é necessário conhecer o modelo de fragmento de conteúdo Adventure e atualizar as propriedades do fragmento correto. É exatamente com isso que o AEM Content MCP Server pode ajudar. Veja como.

  1. No Cursor, abra um novo chat e digite:

    code language-text
    I want to review my Content Fragment Models from AEM RDE, can you list the Adventure Content Fragment details.
    

    Revisar modelos de fragmento de conteúdo

    Antes de chamar o Servidor MCP de Conteúdo, ele solicita a confirmação para continuar. Dessa forma, você permanece no controle das operações de conteúdo.

    A IA usa o servidor MCP de conteúdo para buscar os dados e, em seguida, os apresenta de forma clara e estruturada. Inclui detalhes do modelo do fragmento de conteúdo, o número de fragmentos e informações de resumo.

  2. Para acionar o banner OFERTA DIRETA, atualize o preço de uma aventura. No mesmo bate-papo, tente:

    code language-text
    Can you update adventure Beervana in Portland's price to 99.99
    

    Atualizar preço de aventura

    Da mesma forma, a IA solicita a confirmação para continuar antes de atualizar o conteúdo. Ele também resume a operação do conteúdo antes e depois da atualização.

  3. No aplicativo React, confirme se o cartão Beervana agora mostra o banner HOT DEAL.

    Verificar banner HOT DEAL

Prompts adicionais

Experimente esses prompts focados em conteúdo em seu IDE (com o Servidor MCP de Conteúdo conectado) para explorar mais fluxos de trabalho e recursos.

  • Descobrir conteúdo:

    code language-text
    List all content fragments in the WKND Adventures folder
    
    List all WKND Site pages from US English site
    
    Can you give me page metadata for Tahoe Skiing English page?
    
    List assets of Bali Surf camp
    
    What Content Fragment models are available in this environment?
    
  • Pesquisar conteúdo:

    code language-text
    Search for content fragments that mention 'cycling'
    
    Do we have a magazine page in US English site with "Camping" in it
    
  • Atualizar conteúdo:

    code language-text
    In WKND US English create a copy of Downhill Skiing Wyoming as "Test Downhill Skiing Wyoming"
    
    In newly created "Test Downhill Skiing Wyoming" please change title to "Duplicated Page"
    
  • Publicar ou desfazer a publicação:

    code language-text
    Can you publish the page at /us/en/adventures/test-downhill-skiing-wyoming and give me publish page URL
    
    Can you unpublish the test-downhill-skiing-wyoming page
    

Resumo

Você configurou o Servidor MCP de Conteúdo do AEM no Cursor e o conectou ao seu ambiente RDE (ou Desenvolvimento). Em seguida, você usou o aplicativo WKND Adventures React e conversou em linguagem natural para analisar os detalhes do fragmento de conteúdo do Adventure. Você também atualizou o preço de um fragmento com a IA, solicitando sua confirmação antes de cada operação de conteúdo. Você verificou a alteração no aplicativo em execução. Você pode usar o mesmo fluxo centrado no ser humano do IDE para revisar, atualizar e criar conteúdo do AEM sem alternar para a interface do usuário do AEM ou gravar código de API de baixo nível.

recommendation-more-help
4859a77c-7971-4ac9-8f5c-4260823c6f69