[Beta]{class="badge informative"}
MCP 클라이언트(Beta) 작업 rtcdp-mcp
API 호출을 작성하거나 제품 화면을 탐색하지 않고도 Adobe Real-Time CDP MCP 통합을 사용하여 일반 언어 프롬프트를 사용하여 대상, 대상 및 활성화 상태를 쿼리할 수 있습니다. 이 통합은 Adobe Real-Time CDP 및 Adobe Real-Time CDP B2B edition 고객 모두에게 제공되며, MCP 호환 클라이언트에서 지원되는 Real-Time CDP 데이터 및 워크플로를 검사할 수 있는 대화형 방법을 제공합니다. 통합 작동 방법, 통합 기능으로 수행할 수 있는 작업 및 시작 방법을 알아보려면 이 안내서를 참조하십시오.
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 서버는 읽기 전용 모니터링 및 분류 표면입니다. 쿼리를 작성하거나 제품 화면을 탐색하지 않고 대상, 대상, 소스, ID 및 프로필 확인 전반에 걸쳐 검색 API를 AI 도우미 내의 일반 언어 답변으로 노출합니다. 어떤 데이터도 MCP 서버를 통해 생성, 수정, 삭제할 수 없다.
Beta 릴리스에는 다음 18개의 도구가 포함되어 있습니다.
search_audiencespreview_audience_membershipinspect_audience_evaluation_jobsinspect_audience_export_jobssearch_destination_connectorssearch_destination_accountssearch_destination_input_connectionssearch_destination_output_connectionssearch_destination_flowsinspect_flow_runssearch_source_connectorssearch_source_accountssearch_source_input_connectionssearch_source_output_connectionssearch_source_flowssearch_identity_namespacessearch_merge_policiessearch_organizations사용 사례 mcp-use-cases
Real-Time CDP MCP 서버는 모니터링 및 분류용으로 설계되었습니다. 서버는 이름이 아닌 ID로 작동하므로 일반적인 워크플로는 목록으로 시작합니다. Claude에게 사용 가능한 항목을 보여 달라고 요청하고, 원하는 항목을 선택한 다음, 반환된 ID를 사용하여 후속 질문을 합니다.
prod 샌드박스에 내 대상을 나열합니다.”abc123에 대한 세부 정보와 라이프사이클 상태를 표시합니다.”homeAddress.country = 'US'.”xyz789에 대한 전체 구성을 표시합니다.”xyz789에 대한 실행 기록을 표시하고 오류를 요약합니다.”src456에 대한 구성 표시 — 수집 중인 내용과 도착하는 위치”src456에 대한 최근 실행 기록 및 플래그 오류를 표시합니다.”액세스 및 지원 mcp-access
액세스 권한을 요청하려면:
- Adobe 계정 담당자(고객 성공 관리자, 기술 계정 관리자 또는 계정 담당자)에게 연락하여 Real-Time CDP MCP Beta 프로그램에 대한 관심을 표현하십시오.
- Adobe 담당자는 제품 팀과 협력하여 자격을 평가하고 조직 ID를 활성화합니다.
- 활성화하면 Adobe 담당자가 액세스를 확인하고 추가 온보딩 자료를 제공합니다.
사전 요구 사항 mcp-prerequisites
Real-Time CDP MCP 서버를 MCP 클라이언트에 연결하기 전에 다음 사항을 확인하십시오.
- 활성 Real-Time CDP 라이선스가 있습니다.
- Adobe 담당자가 Adobe 조직에 Beta 프로그램을 사용하도록 설정했습니다(액세스 및 사용 참조).
- 지원되는 MCP 클라이언트(예: Claude, ChatGPT, Claude Code, Codex, Cursor 또는 VS Code)에 액세스할 수 있습니다.
- 조회할 조직 ID와 샌드박스의 이름이 있습니다.
- Adobe Experience Platform에서 대상자, 대상 및 흐름 서비스 엔티티를 보는 데 필요한 권한이 있습니다.
Real-Time CDP MCP 서버 연결 mcp-connect
Real-Time CDP MCP 서버 엔드포인트는 다음과 같습니다.
https://rtcdp-mcp.adobe.io/mcp
서버에서 브라우저 기반 Adobe 로그인 흐름과 함께 원격 HTTP(스트리밍 가능 HTTP) 전송을 사용합니다. 모든 클라이언트에서 설정 패턴은 동일합니다.
- 서버 URL 추가:
https://rtcdp-mcp.adobe.io/mcp - 연결을 저장하거나 활성화합니다.
- 클라이언트가 도구를 처음 호출할 때 브라우저 기반 Adobe 로그인을 완료합니다.
- 각 세션이 시작될 때
imsOrgId및sandboxName을(를) 제공하십시오.
일반 JSON 구성 mcp-connect-json
클라우드 데스크톱(claude_desktop_config.json), VS 코드 또는 mcp.json 파일을 읽는 클라이언트와 같이 JSON 기반 MCP 서버 구성을 허용하는 클라이언트의 경우 클라이언트가 기본 원격 HTTP를 지원하는지 또는 로컬 브리지를 필요로 하는지에 따라 다음 형식 중 하나를 사용합니다.
mcp-remote 브리지(로컬 브리지가 필요한 클라우드 데스크톱 및 기타 클라이언트)를 통해
{
"mcpServers": {
"rtcdp": {
"command": "npx",
"args": [
"mcp-remote",
"https://rtcdp-mcp.adobe.io/mcp"
]
}
}
}
기본 원격 HTTP(직접 지원하는 클라이언트)
{
"mcpServers": {
"rtcdp": {
"url": "https://rtcdp-mcp.adobe.io/mcp",
"transport": "http"
}
}
}
UI 기반 클라이언트에 설치 mcp-connect-ui
클로드
claude.ai 및 Cloud Desktop의 경우 서버 URL https://rtcdp-mcp.adobe.io/mcp을(를) 사용하여 Real-Time CDP MCP 서버를 사용자 지정 커넥터(으)로 추가하십시오.
- 개별 계획 — 클라우드에서 → 커넥터 사용자 지정으로 이동하고 커넥터 추가를 선택한 다음 서버 URL을 입력합니다.
- 팀 및 엔터프라이즈 플랜 — 작업 영역 소유자 또는 기본 소유자가 조직 설정 → 커넥터에 커넥터를 추가합니다. 추가되면 각 사용자는 자체 클라우드 설정에서 활성화합니다.
커넥터가 추가되면 대화에서 활성화하고 처음 사용 시 Adobe 브라우저 로그인을 완료합니다. Claude는 Adobe 인증 서버를 자동으로 검색합니다. 클라이언트 ID 또는 클라이언트 암호가 필요하지 않습니다.
ChatGPT
ChatGPT에서 Real-Time CDP MCP 서버를 사용자 지정 커넥터(으)로 추가합니다.
- 커넥터→ 설정(또는 플랜에 따라 앱 및 커넥터→ 설정)으로 이동합니다.
- 커넥터 추가를 선택하고
https://rtcdp-mcp.adobe.io/mcp을(를) 서버 URL로 입력하십시오. - 커넥터를 저장합니다. ChatGPT 계획에 따라 이 단계에는 개발자 모드 또는 작업 영역 관리자 승인이 필요할 수 있습니다.
- 커넥터가 활성화되면 처음 사용 시 메시지가 표시되면 Adobe 브라우저 로그인을 통해 인증합니다.
커서
커서에서 Real-Time CDP MCP 서버를 원격 MCP 서버로 추가합니다.
- MCP→ 설정을 엽니다.
- 새 서버 추가를 선택하고
https://rtcdp-mcp.adobe.io/mcp을(를) 서버 URL로 입력하십시오. - 브라우저 기반 Adobe 로그인을 트리거하고 인증하려면 연결을(를) 선택하십시오.
연결되면 Cursor의 Composer 및 Agent 모드에서 Real-Time CDP 도구를 사용할 수 있습니다.
기타 UI 기반 클라이언트
VS 코드 또는 원격 MCP를 지원하는 기타 데스크톱 및 웹 응용 프로그램과 같은 클라이언트의 경우 https://rtcdp-mcp.adobe.io/mcp을(를) 사용하여 Real-Time CDP MCP 서버를 원격 HTTP 서버로 추가합니다. 클라이언트가 선택적 헤더 또는 전달자 토큰을 지원하는 경우 비워 두십시오. 인증은 처음 사용할 때 브라우저 기반 Adobe 로그인 플로우를 통해 처리됩니다.
기술 클라이언트에 설치 mcp-connect-technical
클로드 코드
터미널에서 서버를 추가합니다.
claude mcp add --transport http rtcdp https://rtcdp-mcp.adobe.io/mcp
그런 다음 클라우드 코드를 시작하고 다음을 실행합니다.
/mcp
rtcdp 서버를 선택하고 브라우저에서 Adobe 로그인 흐름을 완료합니다. claude.ai에 서버를 이미 추가한 경우 둘 다 동일한 계정에 로그인하면 클라우드 코드에 자동으로 표시될 수 있습니다.
코덱스
터미널에서 서버를 추가합니다.
codex mcp add rtcdp --url https://rtcdp-mcp.adobe.io/mcp
서버 인증:
codex mcp login rtcdp
구성을 확인합니다.
codex mcp list
서버를 ~/.codex/config.toml에 직접 추가할 수도 있습니다.
[mcp_servers.rtcdp]
url = "https://rtcdp-mcp.adobe.io/mcp"
필수 요청 매개 변수 mcp-connect-params
모든 도구 호출에는 Adobe Experience Platform 테넌트에 대한 요청의 범위를 지정하는 두 개의 매개 변수가 필요합니다.
imsOrgId— 다운스트림 Experience Platform API 호출의x-gw-ims-org-id헤더에 매핑된 조직 ID.sandboxName—x-sandbox-name헤더에 매핑된 Experience Platform 샌드박스 이름입니다.
각 세션을 시작할 때 제공합니다. 예:
“이 세션에 조직
1234ABCD@AdobeOrg과(와) 샌드박스prod을(를) 사용하십시오.”
조직 ID를 모를 경우 AI 도우미에게 search_organizations에 전화하도록 요청하십시오. 그러면 Adobe 자격 증명에서 액세스할 수 있는 모든 조직이 반환됩니다.
알려진 제한 사항(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을(를) 기준으로 특정 대상에 대한 범위 실행을 필터링합니다.search_organizations 제외)에는 명시적 매개 변수로 imsOrgId 및 sandboxName이(가) 필요합니다. 이러한 매개 변수가 제공되지 않으면 도구 호출이 실패합니다.<YOUR_ORG_ID> 및 샌드박스 <SANDBOX_NAME>을(를) 사용하십시오."라고 알려 주십시오. 조직 ID를 모를 경우 먼저 search_organizations을(를) 호출하십시오. 자격 증명이 액세스할 수 있는 조직이 반환됩니다.