Experience Manager Guides MCP 서버 설정

MCP 서버 엔드포인트

Experience Manager Guides은 단일 HTTP 끝점을 통해 MCP 기능을 노출합니다.

환경에 대한 현재 도구 목록을 검색하려면 도우미에게 문의하십시오.

List all Experience Manager Guides tools available from the author https://author-pXXXX-eXXXX.adobeaemcloud.com and describe what they do.

조직에 대한 액세스 권한 요청

Experience Manager Guides MCP 서버에 대한 액세스는 조직당 옵트인​입니다. 조직의 모든 사용자가 연결하기 전에:

• Experience Manager Guides은 AEM as a Cloud Service 환경에서 활성화되어야 합니다.
• Adobe Guides 팀에서 조직의 IMS 조직 ID(Org ID)를 허용 목록에 추가해야 합니다.

액세스 권한을 요청하려면 Adobe 고객 성공 팀에 문의하십시오.

설정

로컬에 아무 것도 설치하지 않습니다. 클라이언트를 서버 URL로 지정하고 Adobe IMS 로그인 흐름을 통해 인증합니다.

인류 클로드

공식 설명을 따르십시오. AEM MCP용 클라우드 설정. 사용자 지정 커넥터를 추가할 때 Experience Manager Guides 엔드포인트를 사용합니다.

https://mcp.adobeaemcloud.com/adobe/mcp/guides

커서/Visual Studio 코드

MCP 구성에 서버를 추가합니다. Cursor의 경우 .cursor/mcp.json에 추가하십시오.

{
  "mcpServers": {
    "aem-guides": {
      "url": "https://mcp.adobeaemcloud.com/adobe/mcp/guides"
    }
  }
}

로컬(stdio) 서버만 지원하는 클라이언트의 경우 mcp-remote을(를) 사용하여 원격 끝점에 브리지하십시오.

{
  "mcpServers": {
    "aem-guides": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.adobeaemcloud.com/adobe/mcp/guides"]
    }
  }
}

MCP(모델 컨텍스트 프로토콜)를 사용하여 지원되는 AI 클라이언트를 Experience Manager Guides 온프레미스 인스턴스에 연결할 수 있습니다. 연결을 설정하면 클라이언트는 AEM 사용자 계정에서 사용할 수 있는 Experience Manager Guides 작업에 액세스할 수 있습니다.

모든 작업은 AEM ID 및 권한​을 사용하여 수행됩니다. 연결된 클라이언트는 AEM 계정이 액세스할 수 있는 권한이 있는 컨텐츠 및 리소스만 보거나 수정할 수 있습니다.

인증은 PKCE(Proof Key for Code Exchange)와 함께 OAuth 2.0 인증 코드 흐름을 사용합니다. 클라이언트를 처음 연결할 때 AEM을 사용하여 인증합니다. 인증이 성공하면 연결은 액세스 토큰을 자동으로 새로 고침합니다.

다음 클라이언트를 연결할 수 있습니다.

사전 요구 사항

클라이언트를 연결하기 전에 AEM 관리자와 함께 다음 구성을 확인하십시오.

1. MCP 기능이 배포되었는지 확인합니다.: MCP 기능이 배포되어 Experience Manager Guides 인스턴스에서 실행되고 있는지 확인합니다.

2. Granite 기본 URL을 구성합니다.: AEM 웹 콘솔 구성 관리자(/system/console/configMgr)에서 Experience Manager Guides OAuth PKCE 토큰 래퍼 구성을 찾아 Granite 기본 URL이 구성되어 있는지 확인하십시오. Granite 기본 URL이 올바르게 구성되지 않은 경우 클라이언트가 연결을 설정할 수 없습니다.

3. 일 CQ 링크 외부화를 구성합니다.: AEM 웹 콘솔 구성 관리자에서 일 CQ 링크 외부화 구성을 찾아 외부 작성자 URL이 올바른 AEM 작성자 인스턴스를 가리키는지 확인하십시오. 외부 작성자 URL은 OAuth 검색 중에 사용됩니다. 잘못된 URL로 인해 클라이언트가 연결을 완료할 수 없습니다.

   자세한 내용은 AEM Guides 온-프레미스용 MCP 연결 설정 구성을 참조하세요.

4. MCP 서버 URL을 가져옵니다.: MCP 서버 URL은 다음 형식을 사용합니다.

   code language-none
   http(s)://<AEM-HOST>/bin/guides/v1/mcp/sse

   note
   NOTE
   클라이언트를 구성할 때 전체 SSE 끝점을 사용합니다. URL에 슬래시를 추가하지 마십시오.

   예:

   내부 AEM 작성자 인스턴스:

   code language-none
   http://10.42.42.20:4502/bin/guides/v1/mcp/sse

   공개 AEM 작성자 인스턴스:

   code language-none
   https://author.example.com/bin/guides/v1/mcp/sse

5. AEM 자격 증명 및 사용 권한을 확인하십시오.: AEM 인스턴스에 대한 올바른 계정이 있어야 합니다. AEM 사용자 인터페이스에 로그인하는 데 사용하는 것과 동일한 자격 증명을 사용합니다. MCP를 통해 사용할 수 있는 작업은 이 계정에 할당된 권한에 의해 결정됩니다.

클라우드 데스크톱 연결

클라우드 데스크톱은 데스크톱 확장(.mcpb)을 지원합니다. Experience Manager Guides MCP 확장은 MCP JSON 구성을 수동으로 편집할 필요가 없도록 연결 구성을 패키징합니다.

1. aem-guides-mcp.mcpb 확장 파일을 가져옵니다.

2. 데스크톱 관리​를 열고 설정 > 확장(으)로 이동합니다.

3. 파일을 두 번 클릭하거나 확장 창으로 끌어 aem-guides-mcp.mcpb을(를) 설치합니다.

   설치 대화 상자에 Adobe Experience Manager Guides MCP​이(가) 표시됩니다.

4. 설치​를 선택합니다.

5. Experience Manager Guides MCP 서버 URL 필드에 AEM 인스턴스의 전체 SSE 끝점을 입력합니다.

   예:

   code language-none
   http://<AEM-HOST>:4502/bin/guides/v1/mcp/sse

6. 저장​을 선택하고 확장이 활성화되어 있는지 확인하십시오.

ChatGPT 연결

Experience Manager Guides MCP 서버를 ChatGPT에서 사용자 지정 커넥터로 구성할 수 있습니다.

1. MCP 서버가 공개 HTTPS URL에서 다음 형식으로 사용할 수 있는지 확인합니다.

   code language-none
   https://<PUBLIC-AEM-HOST>/bin/guides/v1/mcp/sse

   브라우저에서 끝점을 열고 인증서 경고 또는 연결 오류 없이 호스트에 연결할 수 있는지 확인합니다.

2. ChatGPT에서 설정 > 플러그인​을 엽니다.

   note
   NOTE
   커넥터 사용 가능 여부는 ChatGPT 계획 및 작업 영역 구성에 따라 다릅니다. 작업 공간 관리자가 사용자 지정 또는 개발자 커넥터를 활성화해야 할 수 있습니다.

3. 플러그인을 추가하거나 만들려면 옵션을 선택합니다.

4. 커넥터 세부 사항을 지정합니다.

   • 이름: Experience Manager Guides 또는 다른 수사적 이름을 입력하십시오.
   • MCP 서버 URL: 공개 HTTPS SSE 끝점을 입력하십시오.
   • 인증: OAuth​을(를) 선택하십시오.

   OAuth 클라이언트 ID 또는 클라이언트 암호를 제공할 필요가 없습니다. MCP 서버는 자동 클라이언트 등록을 지원합니다.

5. 커넥터를 만듭니다.

연결 커서

MCP 구성에 서버 세부 사항을 추가하여 커서에서 Experience Manager Guides MCP 서버를 구성합니다.

1. 커서에서 사용자 지정 > MCP > 새로 만들기​로 이동합니다.

   커서가 ~/.cursor/mcp.json 구성 파일을 엽니다.

2. Experience Manager Guides MCP 서버 구성을 추가합니다.

   예:

   code language-json
   { "mcpServers": { "aem-guides": { "url": "http://10.42.34.176:4502/bin/guides/v1/mcp/sse", "type": "http" } } }

3. 예제 URL을 AEM 인스턴스의 MCP SSE 끝점으로 바꿉니다.

4. 구성을 저장합니다.

5. 구성된 MCP 서버를 사용하도록 설정합니다.