Content AI MCP 서버를 사용하여 AEM 콘텐츠 검색

마지막 업데이트: 2026년 7월 23일

적용 대상:
Experience Manager as a Cloud Service

작성 대상:

Beginner
Leader
User
Developer

Adobe CX Coworker의 Content AI MCP Server을(를) 사용하여 낮은 수준의 API 코드 또는 UI 탐색 없이 자연어로 콘텐츠 AI 색인을 검색하고 분석하십시오.

이 자습서에서는 사용 가능한 색인을 검색하고, 키워드, 의미 체계 및 하이브리드 검색을 실행하고, 자연어 검색을 사용하여 콘텐츠 AI 색인에 대한 Adobe CX Coworker의 복잡한 의도를 표현합니다.

개요

AEM as a Cloud Service은 IDE 또는 채팅 앱이 AEM에서 안전하게 작동할 수 있도록 MCP 서버를 제공합니다. 콘텐츠 AI MCP 서버는 콘텐츠 AI 인덱스 위에 검색 및 검색 도구를 표시합니다. 자세한 내용은 AEM의 MCP 서버를 참조하십시오.

콘텐츠 AI MCP 서버는 6가지 도구를 제공합니다.

도구

목적

list_indexes

AEM 환경에서 사용 가능한 색인을 검색합니다.

get_index_config

원시 색인 구성 및 메타데이터를 검사합니다.

fulltext_search

유사 항목 일치 및 필드 선택을 사용한 키워드 기반 검색.

semantic_search

개념 쿼리에 대한 벡터 기반 유사성 검색.

hybrid_search

최상의 범용 리콜을 위한 키워드 + 의미 체계 검색 결합.

natural_language_search

의도를 일반 영어로 표현합니다. 서버는 이를 구조화된 필터, 범위 및 의미 체계로 변환합니다.

Content AI MCP 서버는 사용자가 구성하는 헤더에서 선택하는 두 가지 액세스 모드를 지원합니다.

공개(익명) — X-Api-Key 헤더를 사용하여 공개, 읽기 전용 인덱스를 검색합니다. 공개적으로 사용할 수 있고 민감하지 않은 콘텐츠에 사용합니다. 공개 인덱스 검색을 참조하세요.
인증됨 — 로그인한 Adobe ID(CX Coworker에서 전달)와 함께 x-content-ai-mcp-api-key 헤더를 사용하여 권한 있는 인덱스 또는 액세스 제어 인덱스를 검색합니다. 결과는 사용자의 권한을 준수합니다.

개발자의 사용 방법

Adobe CX Coworker를 Content AI MCP 서버에 연결하고 아래 시나리오를 실행하십시오.

설정 - Adobe CX Coworker의 Content AI MCP 서버

다음 단계를 수행하여 Adobe CX Coworker에서 Content AI MCP 서버를 설정해 보겠습니다.

Adobe CX 동료에 로그인합니다.
측면 레일에서 MCP 서버를 클릭합니다.
MCP 서버 추가를 클릭합니다.

MCP 서버 추가 대화 상자에 다음 세부 정보를 입력하십시오.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2
필드	값
서버 이름	`content-ai-mcp`
MCP URL	`https://mcp.adobeaemcloud.com/adobe/experimental/aemagents-expires-20260331/mcp/content-ai`
연결 유형	`HTTP`
인증 유형	`Passthrough`

MCP 서버 추가 대화 상자

note
NOTE
인증 유형이(가) `Passthrough`(으)로 설정되어 있으므로 CX Coworker는 로그인한 Adobe ID를 MCP 서버에 전달합니다. 별도의 로그인 또는 OAuth 단계가 필요하지 않습니다.

헤더 추가를 클릭하고 필요한 액세스 모드에 대한 헤더를 추가합니다.

공개 인덱스(익명):

table 0-row-2 1-row-2 2-row-2
헤더	값
`X-Api-Key`	공개 API 키. 공개 색인만 검색하려는 경우 이 헤더를 표시합니다.
`x-content-ai-mcp-routing`	(선택 사항) 환경/라우팅 정보(예: `tier=publish,bucket=p12345-e67890,cluster=ethos21-prod-va7,namespace=ns-team-example`).

비공개(권한 있는) 인덱스의 경우:

table 0-row-2 1-row-2 2-row-2
헤더	값
`x-content-ai-mcp-api-key`	Adobe Developer Console의 API 키입니다.
`x-content-ai-mcp-routing`	(선택 사항) 환경/라우팅 정보(예: `tier=publish,bucket=p12345-e67890,cluster=ethos21-prod-va7,namespace=ns-team-example`).

note important
IMPORTANT
`X-Api-Key` 헤더가 있으면 서버는 요청을 익명(으)로 취급하고 공개 인덱스만 검색합니다. 모든 로그인 ID는 무시되므로 인증된 액세스에 대해 우발적으로 에스컬레이션되지 않습니다. 권한 있는 인덱스를 검색하려면 `x-content-ai-mcp-api-key`(`X-Api-Key` 아님)을(를) 사용하십시오.

note
NOTE
`x-content-ai-mcp-routing` 헤더를 설정하지 않으면 처음 도구를 실행할 때 서버가 채팅에서 환경(`tier` 및 `bucket`)을 요청한 다음 자동으로 다시 시도합니다.

추가를 클릭합니다. 이제 content-ai-mcp 서버가 MCP 서버 목록에 나타납니다.
콘텐츠 AI MCP 서버를 사용하려면 새 채팅을 클릭하세요.

공개 인덱스 검색 중

일부 콘텐츠 AI 인덱스는 공개로 표시되어 있으며 권한이 부여된 ID 없이 익명으로 검색할 수 있습니다. 공개 색인은 읽기 전용이며 공개적으로 사용할 수 있고 민감하지 않은 콘텐츠용입니다. 공개 API 키를 가진 모든 사용자가 검색할 수 있습니다.

다음 경우에 이 모드 사용:

공개적으로 사용 가능한 콘텐츠(예: 공개 설명서 또는 데모 카탈로그)를 검색하려는 경우
사용자당 권한 범위의 결과는 필요하지 않습니다.
API 키만 필요한 간단한 설정을 원하는 경우.

공개 인덱스를 검색하려면 설정 - Adobe CX Coworker에서 Content AI MCP 서버에 설명된 대로 Content AI MCP 서버를 CX Coworker에 추가하지만 헤더 추가 단계에서는 X-Api-Key 헤더(환경에 대한 선택적 x-content-ai-mcp-routing 헤더 포함)만 추가합니다.

헤더

값

X-Api-Key

공개 API 키.

x-content-ai-mcp-routing

(선택 사항) 환경/라우팅 정보(예: tier=publish,bucket=p12345-e67890).

IMPORTANT

X-Api-Key 헤더가 있으면 서버는 요청을 익명(으)로 취급하고 공개 인덱스만 검색합니다. 로그인한 ID는 모두 무시됩니다. 권한 있는 인덱스를 검색하려면 X-Api-Key을(를) 사용하지 마십시오. 대신 x-content-ai-mcp-api-key을(를) 사용하십시오.

서버가 연결된 상태에서 인증된 색인과 동일한 방식으로 공개 색인을 검색하고 검색합니다.

CX Coworker에서 새 채팅을 열고 API 키에 사용할 수 있는 공개 인덱스를 나열합니다.

code language-text
`List all Content AI indexes available in my environment.`

서버는 이 요청에 대한 공개 인덱스만 검색하고 일치하는 결과를 반환합니다.

요약

Adobe CX Coworker에서 AEM Content AI MCP 서버를 설정하고 이를 사용하여 Content AI 인덱스를 검색합니다. 사용 가능한 색인을 검색하고 키워드, 의미 체계, 하이브리드 및 자연어 검색을 사용하여 자연어로 검색했습니다. 또한 API 키로 공개 인덱스를 익명으로 검색하는 방법과 필드 선택을 통해 응답 크기를 줄이는 방법을 배웠습니다. UI로 전환하거나 낮은 수준의 검색 API 코드를 작성하지 않고도 CX Coworker에서 동일한 인간 중심 플로우를 사용하여 Content AI 인덱스를 검색 및 분석할 수 있습니다.

recommendation-more-help

experience-manager-learn-help-cloud-service