[Beta]{class="badge informative"}
MCP 클라이언트(Beta) 작업 rtcdp-mcp
API 호출을 작성하거나 제품 화면을 탐색하지 않고도 Adobe Real-Time CDP MCP 통합을 사용하여 일반 언어 프롬프트를 사용하여 대상, 대상 및 활성화 상태를 쿼리할 수 있습니다. 이 페이지에서는 통합 작동 방식, 통합 기능으로 수행할 수 있는 작업 및 시작 방법을 설명합니다.
Beta, 보안 및 법적 고지 사항 mcp-notices
Beta 설명서 알림: 이 설명서는 Beta 기능을 다루고 있으며 최종 설명서를 구성하지 않습니다. 여기에 설명된 콘텐츠는 Beta 릴리스와 관련되며, 일반 공급 이전에 변경될 수 있습니다. Adobe은 이 설명서의 완벽성이나 정확성에 대해 어떠한 표현도 하지 않습니다.
Adobe Real-Time CDP MCP 서버(Beta)("Beta")를 사용하면 Beta이 어떠한 종류의 보증도 없이 "있는 그대로" 제공된다는 것을 인정합니다. Adobe은 Beta을 유지, 수정, 업데이트, 변경, 수정 또는 지원할 의무가 없습니다. 이러한 Beta 및/또는 동봉된 자료의 올바른 기능이나 성능에 어떤 식으로든 의존하지 말고 주의하는 것이 좋습니다. Beta은 Adobe의 기밀 정보로 간주됩니다. 귀하가 Adobe에 제공한 "피드백"(Beta 사용 중 발생하는 문제 또는 결함, 제안, 개선 사항 및 권장 사항을 포함하되 이에 제한되지 않는 Beta 관련 정보)은 해당 피드백에 대한 모든 권한, 제목 및 관심을 포함하여 Adobe에 할당됩니다.
모델 컨텍스트 프로토콜이란 무엇입니까? mcp-overview
마케팅, 데이터 및 고객 경험 팀은 일상적인 작업을 간소화하기 위해 Anthropic Claude, OpenAI ChatGPT, Cursor 및 Microsoft Copilot Studio와 같은 채팅 기반 애플리케이션과 개발자 도구에 점점 더 의존하고 있습니다. 이러한 응용 프로그램은 응용 프로그램이 백엔드 도구를 대형 언어 모델(LLM)에 균일한 방식으로 노출할 수 있도록 해주는 개방형 표준인 MCP(Model Context Protocol)을 지원합니다.
Real-Time CDP은 이제 모든 MCP 호환 애플리케이션 내에서 직접 대상자, 대상 및 활성화 작업을 표시하는 MCP 서버를 제공합니다. Real-Time CDP MCP 통합을 통해 서로 다른 가상 사용자가 Adobe Experience Platform REST API에 대한 쿼리를 작성하거나 여러 UI 화면을 탐색하지 않고도 동일한 세분화 및 활성화 데이터에 대해 공동 작업을 수행할 수 있습니다. 고객은 대화식으로 자신의 의도를 설명하고 LLM이 적절한 MCP 도구를 호출하도록 할 수 있다.
주요 기능 mcp-capabilities
Real-Time CDP MCP 서버를 사용하면 AI 어시스턴트에서 직접 대상과 대상을 검사하고, 요약하고, 문제를 해결할 수 있습니다. 모든 작업은 읽기 전용입니다. MCP 서버 표면이 API를 일반 언어 답변으로 검색하므로 다음을 수행할 수 있습니다.
- 즉각적인 대상 가시성 확보 - 메뉴를 탐색하거나 보고서를 수동으로 가져오지 않고 대상 정의, 라이프사이클 상태 및 네임스페이스에 대해 일반 언어로 질문합니다.
- 활성화 전 대상 크기 예상 - 대상 빌드를 약속하기 전에 PQL 또는 SDD 세그먼트 쿼리에 대한 멤버십 카운트 및 신뢰 구간을 미리 봅니다.
- 활성화 포트폴리오 감사 — JSON을 구문 분석하거나 제품 화면 사이를 이동하지 않고 구성된 대상, 해당 대상에 제공되는 데이터 흐름 및 각 흐름 뒤의 소스/타겟 연결을 검토합니다.
- 활성화 문제를 조기에 발견 — 표면이 실패했거나 진행 중인 대상이 요청한 즉시 실행되므로 팀이 빠르게 작업할 수 있습니다.
- 라이브 데이터를 중심으로 공동 작업 - 마케터, 데이터 엔지니어 및 이해 당사자는 모두 AI 도우미를 통해 동일한 라이브 Real-Time CDP 데이터를 쿼리할 수 있으므로 더 쉽게 정렬, 결정 및 이동할 수 있습니다.
사용 가능한 도구 mcp-tools
새로운 툴을 사용할 수 있게 되면서 툴 가용성이 빠르게 변화하고 있습니다. 사용 가능한 최신 도구 목록을 얻으려면 Adobe 담당자에게 문의하십시오.
사용 사례 mcp-use-cases
다음 예제는 자연어를 사용하여 Adobe Real-Time CDP MCP 서버와 상호 작용하는 방법을 보여 줍니다.
Loyalty S3 Export 대상이 쓰는 버킷은 무엇입니까?" / "데이터 흐름 [ID]에 대한 대상 경로와 파일 형식을 표시합니다."Weekly Loyalty Export에서 내보낸 항목이 있습니까?" / "{NAME} 대상에 대한 전체 실행 기록을 표시합니다."marketing-prod 샌드박스의 모든 CSV 기반 대상을 나열합니다." / "외부 대상 ID가 정의된 대상은 무엇입니까?"High-Value Loyalty Members의 멤버 자격 크기를 미리 봅니다." / "저장하기 전에 이 PQL 쿼리의 크기를 예상합니다. {EXPRESSION}."전제 조건 mcp-prerequisites
Real-Time CDP MCP 서버를 MCP 클라이언트에 연결하기 전에 다음 사항을 확인하십시오.
- 활성 Real-Time CDP 라이선스가 있습니다.
- 사용자는 Claude, ChatGPT, Claude Code, Codex, Cursor 또는 VS Code와 같은 원격 MCP 서버 또는 사용자 지정 MCP 앱에 연결할 수 있는 지원되는 클라이언트에 액세스할 수 있습니다.
- 조회할 조직 ID와 샌드박스의 이름이 있습니다.
- Adobe Experience Platform에서 대상자, 대상 및 흐름 서비스 엔티티를 보는 데 필요한 권한이 있습니다.
Real-Time CDP MCP 서버 연결 mcp-connect
시작하기 전에 다음을 확인하십시오.
- MCP 서버 끝점 URL:
Available to Beta customers through your Adobe representative. - Adobe 사용자에게 타겟 Experience Platform 조직 및 샌드박스에 대한 액세스 권한이 있는지 확인합니다.
Real-Time CDP MCP 서버는 원격 HTTP MCP 서버입니다. 모든 클라이언트에서 설정은 동일한 패턴을 따릅니다.
- 서버 URL을 추가합니다.
- 연결을 저장하거나 활성화합니다.
- 클라이언트가 도구를 처음 호출할 때 브라우저 기반 Adobe 로그인을 완료합니다.
- 각 요청에
imsOrgId및sandboxName을(를) 제공합니다.
UI 기반 클라이언트에 설치 mcp-connect-ui
클로드
claude.ai 및 Cloud Desktop의 경우 Adobe 담당자가 제공한 끝점을 사용하여 Real-Time CDP MCP 서버를 사용자 지정 커넥터(으)로 추가하십시오. 개별 클라우드 계획에서 사용자 지정 > 커넥터에 추가하십시오. Team 및 Enterprise 계획에서 소유자는 조직 설정 > 커넥터에 먼저 추가한 후 각 사용자가 고유한 클라우드 설정으로 연결해야 할 수 있습니다. 구성하고 나면 대화에서 커넥터를 활성화하고 최초 사용 시 Adobe 브라우저 로그인을 완료합니다.
ChatGPT
ChatGPT에서 Adobe 담당자가 제공한 끝점을 사용하여 Real-Time CDP MCP 서버를 사용자 지정 앱/커넥터(으)로 추가합니다. ChatGPT 계획에 따라 개발자 모드 및 작업 영역 관리자 승인이 필요할 수 있습니다. 앱/커넥터를 만들거나 활성화한 후 설정 > 앱 또는 설정 > 앱 및 커넥터에서 연결한 다음 메시지가 표시되면 Adobe 브라우저 로그인을 통해 인증합니다.
커서
Cursor에서 Adobe 담당자가 제공한 끝점을 사용하여 Real-Time CDP MCP 서버를 원격 MCP 서버로 추가합니다. 설정 > MCP를 열고 새 서버를 추가하고 끝점 URL을 붙여 넣습니다. 추가한 후에는 브라우저를 통해 인증할 연결을 선택하여 작업 영역에 대해 서버를 사용하도록 설정하십시오.
기타 UI 기반 클라이언트
VS 코드 또는 원격 MCP를 지원하는 기타 데스크톱 및 웹 애플리케이션과 같은 클라이언트의 경우, Adobe 담당자가 제공한 끝점을 사용하여 Real-Time CDP MCP 서버를 원격 HTTP 서버로 추가하십시오. 클라이언트가 선택적 헤더 또는 전달자 토큰을 지원하는 경우 Adobe이 별도로 지시하지 않는 한 비워 두십시오. 인증은 처음 사용할 때 브라우저 기반 Adobe 로그인 흐름을 통해 처리됩니다.
기술 클라이언트에 설치 mcp-connect-technical
클로드 코드
터미널에서 서버를 추가합니다.
claude mcp add --transport http rtcdp <endpoint provided by your Adobe representative>
그런 다음 클라우드 코드를 시작하고 다음을 실행합니다.
/mcp
rtcdp 서버를 선택하고 브라우저에서 Adobe 로그인 흐름을 완료합니다. claude.ai에 서버를 이미 추가한 경우 둘 다 동일한 계정을 사용하는 경우 클라우드 코드에도 자동으로 표시될 수 있습니다.
코덱스
터미널에서 서버를 추가합니다.
codex mcp add rtcdp --url <endpoint provided by your Adobe representative>
서버 인증:
codex mcp login rtcdp
구성을 확인합니다.
codex mcp list
서버를 ~/.codex/config.toml에 직접 추가할 수도 있습니다.
[mcp_servers.rtcdp]
url = "<endpoint provided by your Adobe representative>"
필수 요청 매개 변수 mcp-connect-params
모든 도구 호출에는 요청의 범위를 지정하는 두 개의 매개 변수가 필요합니다.
imsOrgId— 다운스트림 Experience Platform API 호출의x-gw-ims-org-id헤더에 매핑된 조직 ID.sandboxName—x-sandbox-name헤더에 매핑된 Experience Platform 샌드박스 이름입니다.
알려진 제한 사항(Beta) mcp-limitations
다음 제한 사항은 Adobe Real-Time CDP MCP 서버의 현재 Beta 릴리스에 적용됩니다.
Preview Audience Membership은(는) 올바른 PQL 또는 SDD 식을 입력해야 합니다. MCP 서버가 쿼리를 작성하지 않습니다.continuationToken 호출을 체인 처리해야 합니다.Inspect Activation Runs은(는) 상태 및 완료 타임스탬프(epoch ms UTC)별 필터링을 지원하지만 오류 유형 또는 대상 플랫폼별로는 지원하지 않습니다.List Configured Destinations에서 가져온 flowId을(를) 기준으로 특정 대상에 대한 범위 실행을 필터링합니다.자주 묻는 질문 mcp-faq
sandboxName 매개 변수가 필요하므로 MCP 서버는 항상 Adobe Experience Platform 샌드박스 구성을 준수합니다. 프롬프트에 샌드박스 이름을 지정하여 액세스 권한이 있는 모든 샌드박스를 쿼리할 수 있습니다.Search Existing Audiences이(가) 이미 작성되어 샌드박스에 저장된 대상을 반환합니다. Preview Audience Membership은(는) 원시 PQL 또는 SDD 세그먼트 식을 가져와서 예상 크기를 반환합니다. 대상자로 저장하는 이전 쿼리 크기를 조정하는 데 유용합니다.Search Existing Audiences과(와) Preview Audience Membership 모두 엔터티 형식 매개 변수를 지원합니다. 프로필 대상은 PQL 또는 SDD로 표현할 수 있습니다. 계정 대상은 항상 SDD(관계형) 구문을 사용합니다.