설명서AEM사용 안내서

AEM Cloud Migration MCP 사용 using-cloud-migration-mcp

마지막 업데이트: 2026년 5월 27일
  • 적용 대상:
  • Experience Manager as a Cloud Service

작성 대상:

  • Developer

AEM 클라우드 마이그레이션 MCP​는 IDE 에이전트를 CAM(Cloud Acceleration Manager)​에 연결하는 호스팅된 MCP(모델 컨텍스트 프로토콜) 서버입니다. 구성하고 나면 AEM 클라우드 마이그레이션 스킬이(가) CSV 내보내기 없이도 CAM 프로젝트에서 바로 모범 사례 분석기 결과를 가져올 수 있습니다.

MCP 서버 URL server-url

https://mcp.adobeaemcloud.com/adobe/mcp/cloud-migration

연결할 IDE의 MCP 구성에 이 URL을 추가하십시오.

제공 항목 what-it-provides

MCP 서버는 마이그레이션 스킬이 세션 중에 자동으로 호출하는 두 가지 도구를 노출합니다.

도구
설명
fetch-cam-bpa-findings-by-pattern
CAM 프로젝트의 최신 BPA 보고서에서 특정 마이그레이션 패턴(scheduler, assetApi, eventListener, resourceChangeListener, eventHandler 또는 all)에 대한 BPA 결과를 반환합니다.
fetch-cam-bpa-findings-by-importance
내림차순 개수별로 정렬된 최신 BPA 보고서에서 지정된 심각도(CRITICAL, MAJOR, ADVISORY, INFO)의 모든 BPA 결과를 반환합니다. 먼저 처리할 패턴의 우선 순위를 지정하는 데 유용합니다.

사전 요구 사항 prerequisites

  • 업로드된 BPA 보고서가 있는 Cloud Acceleration Manager 프로젝트. CAM 준비 단계를 참조하십시오.
  • 해당 CAM 프로젝트에 액세스할 수 있는 Adobe ID.
  • 원격 MCP 서버를 지원하는 AI 지원 IDE입니다.

설정 setup

  1. IDE의 MCP 구성에서 URL https://mcp.adobeaemcloud.com/adobe/mcp/cloud-migration이(가) 있는 새 MCP 서버 항목을 추가합니다.
  2. IDE가 서버에 연결되도록 구성을 저장하거나 활성화합니다.
  3. 메시지가 표시되면 Adobe ID(으)로 로그인하여 인증을 완료하십시오.
  4. 인증되면 IDE는 사용 가능한 마이그레이션 도구를 검색하고 마이그레이션 기술은 이를 세션에 사용할 수 있습니다.

IDE별 구성 단계는 AEM으로 MCP 설정의 안내서를 참조하세요.

NOTE
CAM 프로젝트에 액세스할 수 있는 Adobe ID에 로그인해야 합니다. 인증 오류가 표시되면 계정에 Cloud Acceleration Manager에서 적절한 권한이 있는지 확인하십시오.

마이그레이션 세션에서 MCP 사용 using-in-session

MCP 서버가 연결된 상태에서 다음과 같은 프롬프트로 IDE에서 마이그레이션 세션을 시작합니다.

Fetch scheduler findings for project <name>/<id>.

에이전트:

  1. 해당 프로젝트에 대한 BPA 결과를 가져옵니다.
  2. 일괄 처리 마이그레이션 워크플로 진행
IMPORTANT
에이전트가 진행되기 전에 항상 목록에서 프로젝트를 확인합니다. 프로젝트를 명시적으로 선택할 때까지 결과를 가져오지 않습니다.

심각도별 우선 순위 지정 by-severity

패턴 마이그레이션을 시작하기 전에 BPA 보고서 결과에 대한 개수 정렬 요약을 보려면 다음을 수행하십시오.

Show me CRITICAL findings from CAM for project <name>/<id>.

이 옵션을 사용하여 세션에서 우선 지정할 패턴을 결정합니다.

문제 해결 troubleshooting

IDE에서 MCP 서버에 연결할 수 없습니다

  • URL이 뒤쪽 슬래시 없이 위와 같이 정확히 입력되었는지 확인합니다
  • MCP 구성을 저장한 후 IDE를 다시 시작합니다.

인증 실패

  • CAM 프로젝트에 액세스할 수 있는 Adobe ID으로 로그인하고 있는지 확인합니다.

BPA 보고서를 찾을 수 없음

다음 단계 whats-next

MCP가 구성된 상태에서 마이그레이션 패턴 및 세션 관리에 대한 전체 참조를 보려면 클라우드 마이그레이션 기술 사용을 참조하십시오.

recommendation-more-help
experience-manager-cloud-service-help-main-toc