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

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

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

추가적인 실습 지침은 AI 지원 개발 자습서를 검토하십시오.

제품 개발에 도움이 되는 피드백을 aemcs-ai-ide-tools-feedback@adobe.com에 보내 주세요.

AGENTS.md agentsmd

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

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

에이전트 스킬 agent-skills

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

Adobe은 adobe/skills 리포지토리에서 AEM as a Cloud Service 기술을 게시합니다.

스킬 설치 install-skills

AI 코딩 도구와 일치하는 방법을 선택합니다. 기술을 한 번 설치하면 해당 컴퓨터의 모든 프로젝트에 사용할 수 있습니다. 자세한 설명은 AEM 에이전트 기술 설정 자습서를 참조하십시오.

클로드 코드 claude-code

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

# 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/main/skills/aem/cloud-service --all

스킬 향상(GitHub CLI 확장) upskill-github-cli-extension

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

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

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

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

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

처음 사용 시 스킬은 pom.xml 및 기존 구성 요소에서 project, package 및 group을(를) 자동으로 감지하고 감지된 값을 확인하도록 요청합니다. 그런 다음 프로젝트 루트에 .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 테스트가 포함됩니다. 디자인은 텍스트 설명, 이미지 또는 Figma의 MCP 서버를 사용하는 Figma 디자인 URL을 포함한 다양한 소스에서 가져올 수 있습니다.

AEM 에이전트 기술을 사용한 구성 요소 개발 자습서를 따라 자세히 알아보십시오.

마이그레이션 스킬 사용 use-the-migration-skill

migration 스킬은 AEM Java 코드 및 OSGi 구성을 AEM as a Cloud Service으로 마이그레이션하는 과정을 안내합니다. 한 번에 한 패턴씩 작동합니다. 패턴 이름을 지정하고(예: scheduler 또는 replication), 에이전트를 모범 사례 분석기 검색 결과로 지정하고, 영향을 받는 파일을 프로젝트에서 찾아 올바른 변환을 일괄로 적용하고, 각 변환 후에는 검토를 일시 중지합니다.

지원되는 패턴에는 Sling 스케줄러, ResourceChangeListener, 복제 API, OSGi EventListener 및 EventHandler, Assets API, HTL 린트 수정 및 Cloud Manager 암호 및 환경 변수 추출을 사용한 OSGi 구성 전환이 포함됩니다.

Cloud Acceleration Manager에서 직접 결과를 가져오기 위해 클라우드 마이그레이션 MCP와(과) 스킬이 연결됩니다. MCP를 구성하지 않으면 스킬이 로컬 BPA CSV 내보내기로 대체되거나 특정 파일을 수동으로 가리킬 수 있습니다.

전체 설정 지침 및 패턴 참조에 대해서는 AEM as a Cloud Service으로 AI 지원 코드 마이그레이션을 참조하십시오.

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

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

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

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

코드 평가 스킬 사용(Beta) use-the-code-assessment-skill

이 기능은 베타​입니다. Adobe에서는 제품 개발을 구체화하기 위해 aemcs-ai-ide-tools-feedback@adobe.com에 전자 메일을 보내 피드백을 제공할 것을 권장합니다.

Beta 릴리스에는 결함이 포함될 수 있으며 어떠한 종류의 보증도 없이 “있는 그대로” 제공됩니다. Adobe은 베타 릴리스를 유지, 수정, 업데이트, 변경, 수정 또는 기타 지원(Adobe 지원 서비스 또는 기타 방식으로)할 의무가 없습니다. Adobe은 고객에게 베타 릴리스의 올바른 기능이나 성능 또는 관련 설명서나 자료에 의존하지 말고 주의할 것을 권장합니다. Beta의 기능 및 API는 예고 없이 변경될 수 있습니다. 따라서 Beta 릴리스를 사용하는 것은 전적으로 고객 자신의 책임입니다.

code-assessment 스킬은 완전히 로컬 작업 영역 내에 있는 AEM as a Cloud Service 프로젝트의 코드 품질 및 수정 문제를 감지하고 검토하고 수정합니다. 문제를 설명하고 스킬은 요청을 적절한 수정 작업 과정으로 보냅니다.

지원되는 검사에는 Sling 모델 종속성 삽입 현대화, 오래된 Maven 종속성 업데이트, 아웃바운드 HTTP 호출에 누락된 시간 초과 추가, 경계 제한되지 않은 쿼리, Sling 스케줄러, 리소스 변경 수신기, 복제 및 Assets API, JCR 또는 OSGi 이벤트 처리, 시간이 지남에 따라 추가된 더 이상 사용되지 않으며 제거된 AEM API의 사용 검색 및 수정 등이 포함됩니다. 문제에 따라 스킬은 기계적 수정을 직접 적용하거나 판단 호출이 필요한 문제를 안내합니다.

광범위한 검토 또는 최초 검토를 위해 모든 감지기를 실행하고, 모든 결과를 보고하고, 한 번에 한 패턴씩 코드 수정을 적용하는 등 전체 프로젝트를 평가할 수 있도록 기술에 문의하십시오.

시작하려면 AEM as a Cloud Service 프로젝트에서 새 에이전트 채팅을 여십시오.

1. 프로젝트를 검토합니다. 보고서 요청. 이 스킬은 분석기를 실행하고 제안된 교정 계획을 통해 패턴 및 심각도별로 그룹화된 결과를 인라인으로 반환합니다. 이 단계에서는 코드가 변경되지 않습니다.

scan my AEM project and report any code-quality issues

더 명시적인 호출의 경우 스킬 이름을 직접 지정합니다.

/code-assessment review my code for AEM as a Cloud Service issues

단일 패턴에 초점을 맞추려면 프롬프트에서 이름을 지정합니다.

scan my project for unbounded queries

2. 한 번에 한 패턴씩 수정 사항을 적용합니다. 스킬에게 특정 패턴을 수정하도록 요청합니다. 외과적으로 편집하고 컴파일 여부를 확인합니다. 기계적 수정 사항이 바로 적용됩니다. 안내식 지침은 각 결정을 안내합니다.

apply unbounded-query

커밋하거나 푸시하지 않습니다. 차이를 검토하고 커밋합니다. 다시 시작 가능한 일괄 처리에서 대량 수정 작업이 실행됩니다. 계속하려면 apply <pattern>을(를) 회신하십시오.

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

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

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

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

호환성:​이(가) 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 클라이언트는 Authorization: Basic YWRtaW46YWRtaW4= 헤더가 있는 http://localhost:4502/bin/mcp을(를) 지정하여 연결할 수 있습니다. 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

~/.cursor/mcp.json에 aem-dispatcher-mcp 항목 추가:

{
  "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 디렉터리로 바꿉니다. /docroot이(가) 정의된 파일을 포함하는 구성 루트로 DISPATCHER_CONFIG_PATH을(를) 설정합니다. 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에서 사용할 수 있습니다.