Desenvolvimento local com ferramentas de IA local-development-with-ai-tools

Os agentes de codificação de IA (Claude Code, Cursor, GitHub Copilot e ferramentas semelhantes) têm amplo conhecimento das tecnologias subjacentes da AEM (Java, OSGi, Sling, JCR, HTL), mas não conhecem necessariamente as práticas recomendadas para gerar código e configuração ou como depurar problemas comuns de desenvolvimento do AEM.

Quatro componentes complementares abordam esta questão:

AGENTS.md agentsmd

AGENTS.md é um arquivo do Markdown na raiz do seu projeto do AEM que as ferramentas de codificação de IA carregam automaticamente no início de cada sessão para serem baseadas no conhecimento essencial de domínio da pilha de Java do AEM Cloud Service (e não em outras soluções da AEM, como o AEM 6.5 ou Edge Delivery Services).

AGENTS.md não é um arquivo estático copiado — ele é gerado pela habilidade ensure-agents-md descrita na próxima seção. A habilidade lê o pom.xml para resolver o nome do projeto, descobrir módulos e detectar complementos instalados, produzindo um arquivo adaptado ao seu projeto específico.

Habilidades do agente agent-skills

Habilidades são conjuntos de instruções que codificam fluxos de trabalho de desenvolvimento de várias etapas. Quando invocada, a IA segue o procedimento da habilidade, em vez de depender apenas do conhecimento geral, produzindo resultados consistentes e compatíveis com a convenção.

O Adobe publica habilidades do AEM as a Cloud Service no repositório adobe/skills na ramificação beta, pois esse recurso ainda não está disponível:

Instalar habilidades install-skills

Escolha o método que corresponde à ferramenta de codificação de IA. Instalar as habilidades uma vez as disponibiliza para todos os projetos nessa máquina.

código Claude claude-code

# Add the Adobe Skills marketplace (one-time setup)
/plugin marketplace add adobe/skills#beta

# Install all available skills
/plugin install aem-cloud-service@adobe-skills

Habilidades Npx npx-skills

# Install all available skills
npx skills add https://github.com/adobe/skills/tree/beta/skills/aem/cloud-service --all

Aprimoramento (extensão CLI do GitHub) upskill-github-cli-extension

# Install the gh-upskill extension (one-time setup)
gh extension install trieloff/gh-upskill

# Install all available skills
gh upskill adobe/skills --branch beta --path skills/aem/cloud-service --all

Usar a habilidade sure-agents-md use-the-ensure-agents-md-skill

Após instalar a habilidade, abra o assistente de IA em qualquer projeto do AEM Cloud Service que ainda não tenha um AGENTS.md. A habilidade é executada automaticamente antes do processamento da primeira solicitação, criando ambos os arquivos na raiz do projeto sem a necessidade de chamada explícita.

Usar a habilidade create-component use-the-create-component-skill

Na primeira utilização, a habilidade detecta automaticamente project, package e group de pom.xml e componentes existentes, solicita sua confirmação dos valores detectados e cria .aem-skills-config.yaml na raiz do projeto. Nenhuma configuração manual é necessária antes da primeira utilização.

Se preferir pré-criar o arquivo, coloque .aem-skills-config.yaml na raiz do projeto com a seguinte estrutura:

configured: true

project: "wknd"                                    # Check /apps/{project}/ or pom.xml
package: "com.adobe.aem.guides.wknd.core"          # Check core/pom.xml
group: "WKND Components"                           # Check existing component .content.xml files

O arquivo fica fora do diretório de habilidades e nunca é substituído quando a habilidade é atualizada.

Descreva o componente no bate-papo de IA:

Create an AEM component called "Hero Banner"

Dialog specification:
Title (title) - Textfield, mandatory
Subtitle (subtitle) - Textfield
Background Image (backgroundImage) - Fileupload
CTA Text (ctaText) - Textfield
CTA Link (ctaLink) - Pathfield

O agente ecoa a especificação do campo para confirmação e, em seguida, gera todos os arquivos de componente. Os padrões compatíveis incluem vários campos com itens aninhados compostos, lógica condicional de mostrar/ocultar, extensão do Componente principal por meio do Sling Resource Merger e testes JUnit 5 usando AEM Mocks.

Usar a habilidade do Dispatcher use-the-dispatcher-skill

Chame a habilidade do dispatcher para qualquer trabalho de configuração HTTPD do Dispatcher ou Apache. As solicitações de rotas de habilidades para uma das seis sub-habilidades especializadas, dependendo da natureza da solicitação:

Para solicitações amplas ou iniciadas, comece com a subhabilidade workflow-orchestrator. Para trabalho direcionado, descreva a preocupação específica e as rotas de habilidades para o especialista apropriado.

A habilidade do dispatcher lida com orquestração e orientação de consultoria. O servidor MCP do Dispatcher, descrito abaixo, fornece as sete ferramentas de validação e tempo de execução que a habilidade usa quando precisa de evidências locais.

AEM Quickstart MCP Server aem-quickstart-mcp-server

O Protocolo de contexto de modelo (MCP) é um padrão aberto que permite que as ferramentas de codificação de IA se conectem a fontes de dados e serviços externos. O servidor MCP AEM Quickstart é um pacote de conteúdo que, uma vez instalado em uma instância local do AEM SDK, expõe os dados de tempo de execução diretamente às ferramentas de IA conectadas, permitindo que os agentes recuperem registros, diagnostiquem falhas de OSGi e inspecionem o processamento de solicitações sem sair do IDE.

Instalar o pacote de conteúdo install-the-content-package

Baixe o pacote de conteúdo do Portal de Distribuição de Software e instale o com.adobe.aem:com.adobe.aem.mcp-server-contribs-content no Quickstart local usando o Gerenciador de Pacotes em /crx/packmgr.

Compatibilidade: validada com AEM SDK 2026.2.24678.20260226T154829Z-260200 e mais recente.

Ferramentas disponíveis available-tools

Configurar o IDE configure-your-ide

Cursor cursor

Em Configurações do Cursor, adicione um novo servidor MCP personalizado:

"aem-cs-sdk": {
  "type": "streamable-http",
  "url": "http://localhost:4502/bin/mcp",
  "headers": {
    "Authorization": "Basic YWRtaW46YWRtaW4="
  }
}

GitHub Copilot com IntelliJ IDEA github-copilot-with-ihtellij-idea

Navegue até Ferramentas > GitHub Copilot > Protocolo de Contexto de Modelo (MCP) e clique em Configurar. Adicionar:

"aem-cs-sdk": {
  "url": "http://localhost:4502/bin/mcp",
  "requestInit": {
    "headers": {
      "Authorization": "Basic YWRtaW46YWRtaW4="
    }
  }
}

Outras IDEs other-ides

Qualquer cliente MCP pode se conectar apontando para http://localhost:4502/bin/mcp com um cabeçalho Authorization: Basic YWRtaW46YWRtaW4=. Configure cabeçalhos personalizados usando as configurações de MCP do IDE.

Dispatcher MCP Server dispatcher-mcp-server

O servidor Dispatcher MCP é fornecido com o AEM Dispatcher SDK. Ela permite que as ferramentas de IA validem a configuração HTTPD do Dispatcher e do Apache, rastreiem a manipulação de solicitações e inspecionem o comportamento do cache em relação a uma instância do Dispatcher executada localmente no Docker.

Ao contrário da habilidade do dispatcher, o servidor MCP do Dispatcher expõe apenas ferramentas: sete ferramentas MCP e nenhum prompt ou recurso.

Pré-requisitos prerequisites

Instalar o Dispatcher SDK install-the-dispatcher-sdk

macOS e Linux:

chmod +x aem-sdk-dispatcher-tools-<version>-unix.sh
./aem-sdk-dispatcher-tools-<version>-unix.sh
cd dispatcher-sdk-<version>
chmod +x ./bin/docker_run_mcp.sh
./bin/docker_run_mcp.sh test

Janelas:

Expand-Archive aem-sdk-dispatcher-tools-<version>-windows.zip

Execute ./bin/docker_run_mcp.sh help para recuperar a configuração do IDE de copiar e colar e ./bin/docker_run_mcp.sh version para confirmar a versão do MCP e do SDK agrupados. Use ./bin/docker_run_mcp.sh diagnose para investigar problemas de conectividade.

Configurar o cursor configure-cursor

Adicionar uma entrada aem-dispatcher-mcp a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "aem-dispatcher-mcp": {
      "command": "<path_to_dispatcher_sdk>/bin/docker_run_mcp.sh",
      "env": {
        "DOCKER_API_VERSION": "1.43",
        "AEM_DEPLOYMENT_MODE": "cloud",
        "MCP_LOG_LEVEL": "trace",
        "MCP_LOG_FILE": "/tmp/dispatcher-mcp.log",
        "DISPATCHER_CONFIG_PATH": "<path_to_dispatcher_src>"
      }
    }
  }
}

Substitua <path_to_dispatcher_sdk> pelo local extraído do Dispatcher SDK e <path_to_dispatcher_src> pelo diretório src do Dispatcher do projeto. Defina DISPATCHER_CONFIG_PATH para a raiz de configuração que inclui os arquivos em que /docroot está definido. MCP_LOG_LEVEL e MCP_LOG_FILE são configurações opcionais de depuração. Se você vir client version 1.43 is too new, defina DOCKER_API_VERSION como 1.41. Se outros servidores MCP já estiverem configurados, adicione a entrada aem-dispatcher-mcp sem substituí-los. Reiniciar o cursor após salvar.

Outros IDEs podem ser configurados de maneira semelhante. O docs/DispatcherMCP.md do SDK inclui exemplos completos para Claude Desktop e o Código VS.

Ferramentas disponíveis available-tools-dispatcher

A superfície MCP expõe intencionalmente apenas essas sete ferramentas; as instruções e os recursos permanecem na camada de habilidade. A documentação de referência completa está disponível em docs/DispatcherMCP.md dentro do SDK extraído do Dispatcher.