AI 도구를 사용한 로컬 개발 local-development-with-ai-tools

AI 코딩 에이전트(클라우드 코드, 커서, GitHub Copilot 및 유사한 도구)는 AEM의 기본 기술(Java, OSGi, Sling, JCR, HTL)에 대한 광범위한 지식을 가지고 있지만 코드 및 구성을 생성하기 위한 모범 사례나 일반적인 AEM 개발 문제를 디버깅하는 방법을 반드시 알고 있지는 않습니다.

네 가지 보완 구성 요소는 다음과 같은 문제를 해결합니다.

AGENTS.md agentsmd

AGENTS.md은(는) AEM 6.5 또는 Edge Delivery Services과 같은 다른 AEM 솔루션이 아닌 필수 AEM Cloud Service Java 스택 도메인 전문 지식을 기반으로 하기 위해 AI 코딩 도구가 모든 세션이 시작될 때 자동으로 로드하는 AEM 프로젝트 루트에 있는 Markdown 파일입니다.

AGENTS.md은(는) 복사하는 정적 파일이 아닙니다. 다음 섹션에서 설명한 ensure-agents-md 스킬에 의해 생성됩니다. 이 스킬은 pom.xml을(를) 읽어 프로젝트 이름을 해결하고 모듈을 검색하며 설치된 추가 기능을 감지하여 특정 프로젝트에 맞는 파일을 생성합니다.

에이전트 스킬 agent-skills

스킬은 여러 단계 개발 워크플로우를 인코딩하는 지침 세트입니다. 호출되면 AI가 일반적인 지식에만 의존하지 않고 스킬의 절차를 따르며 일관되고 규칙을 준수하는 결과를 생성합니다.

Adobe은 이 기능을 아직 일반적으로 사용할 수 없으므로 분기의 ​adobe/skillsbeta 리포지토리에서 AEM as a Cloud Service 기술을 게시합니다.

스킬 설치 install-skills

AI 코딩 도구와 일치하는 방법을 선택합니다. 기술을 한 번 설치하면 해당 컴퓨터의 모든 프로젝트에 사용할 수 있습니다.

클로드 코드 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

Npx 스킬 npx-skills

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

스킬 향상(GitHub CLI 확장) 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

ensure-agents-md 스킬 사용 use-the-ensure-agents-md-skill

기술을 설치한 후 아직 AGENTS.md이(가) 없는 AEM Cloud Service 프로젝트에서 AI 도우미를 엽니다. 스킬은 첫 번째 요청을 처리하기 전에 자동으로 실행되어 명시적인 호출이 필요 없이 프로젝트 루트에서 두 파일을 모두 만듭니다.

구성 요소 만들기 스킬 사용 use-the-create-component-skill

처음 사용 시 스킬은 project 및 기존 구성 요소에서 package, group 및 pom.xml을(를) 자동으로 감지하고 감지된 값을 확인하도록 요청한 다음 프로젝트 루트에서 .aem-skills-config.yaml을(를) 만듭니다. 처음 사용하기 전에 수동 구성이 필요하지 않습니다.

파일을 미리 만들려면 프로젝트 루트에 다음 구조로 .aem-skills-config.yaml을(를) 배치하십시오.

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

파일은 스킬 디렉토리 외부에 있으며 스킬이 업데이트될 때 덮어써지지 않습니다.

AI 채팅에서 구성 요소에 대해 설명합니다.

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

에이전트는 확인을 위해 필드 사양을 되풀이한 다음 모든 구성 요소 파일을 생성합니다. 지원되는 패턴에는 복합 중첩 항목이 있는 다중 필드, 조건부 표시/숨기기 논리, Sling 리소스 병합을 통한 핵심 구성 요소 확장 및 AEM Mocks를 사용하는 JUnit 5 테스트가 포함됩니다.

Dispatcher 스킬 사용 use-the-dispatcher-skill

Dispatcher 또는 Apache HTTPD 구성 작업에 대한 Dispatcher 기술을 호출합니다. 이 스킬은 요청의 성격에 따라 6개의 전문가 하위 스킬 중 하나로 요청을 라우팅합니다.

광범위한 요청 또는 처음 요청의 경우 workflow-orchestrator 하위 스킬로 시작합니다. 대상 작업의 경우, 특정 관심사와 해당 전문가에게 기술 경로를 설명하십시오.

Dispatcher 기술은 오케스트레이션 및 자문 지침을 처리합니다. 아래에 설명된 Dispatcher MCP 서버는 로컬 증거가 필요할 때 이 기술이 사용하는 7가지 유효성 검사 및 런타임 도구를 제공합니다.

AEM Quickstart MCP 서버 aem-quickstart-mcp-server

모델컨텍스트 프로토콜(MCP)은 AI 코딩 도구가 외부 데이터 소스와 서비스에 연결할 수 있도록 하는 개방형 표준이다. AEM 빠른 시작 MCP 서버는 로컬 AEM SDK 인스턴스에 설치되면 연결된 AI 도구에 런타임 데이터를 직접 노출하는 컨텐츠 패키지로서 에이전트가 로그를 검색하고 OSGi 오류를 진단하며 IDE를 종료하지 않고 요청 처리를 검사할 수 있습니다.

콘텐츠 패키지 설치 install-the-content-package

소프트웨어 배포 포털에서 콘텐츠 패키지를 다운로드하고 com.adobe.aem:com.adobe.aem.mcp-server-contribs-content의 패키지 관리자를 사용하여 /crx/packmgr을(를) 로컬 빠른 시작에 설치합니다.

호환성:​이(가) AEM SDK 2026.2.24678.20260226T154829Z-260200 이상에서 확인되었습니다.

사용 가능한 도구 available-tools

IDE 구성 configure-your-ide

커서 cursor

커서 설정에서 새 사용자 지정 MCP 서버를 추가합니다.

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

IntelliJ IDEA를 사용한 GitHub Copilot github-copilot-with-ihtellij-idea

도구 > GitHub Copilot > 모델 컨텍스트 프로토콜(MCP)​로 이동하고 구성​을 클릭합니다. 추가:

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

기타 IDE other-ides

모든 MCP 클라이언트는 http://localhost:4502/bin/mcp 헤더가 있는 Authorization: Basic YWRtaW46YWRtaW4=을(를) 지정하여 연결할 수 있습니다. IDE의 MCP 설정을 사용하여 사용자 지정 헤더를 구성합니다.

Dispatcher 서버 dispatcher-mcp-server

Dispatcher MCP 서버는 AEM Dispatcher SDK과 번들로 제공됩니다. AI 도구를 통해 Dispatcher 및 Apache HTTPD 구성의 유효성을 검사하고, 요청 처리를 추적하고, Docker에서 로컬로 실행되는 Dispatcher 인스턴스에 대해 캐시 동작을 검사할 수 있습니다.

Dispatcher 스킬과 달리 Dispatcher MCP 서버는 7개의 MCP 도구만 노출하며 프롬프트 또는 리소스는 노출하지 않습니다.

사전 요구 사항 prerequisites

Dispatcher SDK 설치 install-the-dispatcher-sdk

macOS 및 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

창:

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

./bin/docker_run_mcp.sh help을(를) 실행하여 복사-붙여넣기 IDE 구성을 검색하고 ./bin/docker_run_mcp.sh version을(를) 실행하여 번들 MCP 및 SDK 버전을 확인합니다. 연결 문제를 조사하려면 ./bin/docker_run_mcp.sh diagnose을(를) 사용하십시오.

커서 구성 configure-cursor

aem-dispatcher-mcp에 ~/.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>"
      }
    }
  }
}

<path_to_dispatcher_sdk>을(를) 추출된 Dispatcher SDK 위치로 바꾸고 <path_to_dispatcher_src>을(를) 프로젝트의 Dispatcher src 디렉터리로 바꿉니다. DISPATCHER_CONFIG_PATH이(가) 정의된 파일을 포함하는 구성 루트로 /docroot을(를) 설정합니다. MCP_LOG_LEVEL 및 MCP_LOG_FILE은(는) 선택적 디버깅 설정입니다. client version 1.43 is too new이(가) 표시되면 DOCKER_API_VERSION을(를) 1.41(으)로 설정하십시오. 다른 MCP 서버가 이미 구성된 경우 aem-dispatcher-mcp 항목을 바꾸지 않고 추가하십시오. 저장한 후 Cursor를 다시 시작합니다.

다른 IDE도 유사한 방식으로 구성할 수 있습니다. SDK docs/DispatcherMCP.md에는 클라우드 데스크톱 및 VS 코드에 대한 전체 예제가 포함되어 있습니다.

사용 가능한 도구 available-tools-dispatcher

MCP 표면은 의도적으로 이 7가지 도구만을 노출하며, 프롬프트 및 리소스는 스킬 레이어에 남습니다. 전체 참조 설명서는 추출된 Dispatcher SDK 내의 docs/DispatcherMCP.md에서 사용할 수 있습니다.