[제한 공개]{class="badge informative" title="이 기능은 현재 제한된 베타 릴리스에 있습니다"}
Marketo Engage MCP 서버
모델 컨텍스트 프로토콜(MCP)은 AI 도구가 외부 서비스와 통신할 수 있도록 하는 개방형 표준이다. Marketo MCP 서버는 AI 길잡이와 Marketo 사이의 다리 역할을 합니다. 양식, 프로그램, 스마트 캠페인, 리드, 이메일, 코드 조각, 목록 및 폴더에 100개 이상의 작업을 노출합니다.
AI 도구가 MCP 서버를 호출하면 서버는 각 요청에서 제공한 자격 증명을 사용하여 사용자를 대신하여 해당 REST API 호출을 실행합니다. 서버측 소프트웨어를 설치, 배포 또는 실행할 필요가 없습니다.
MCP 클라이언트 또는 서버를 Adobe 제품에 연결하는 것은 고객이 선택한 구성이며 고객은 MCP 통합의 보안 및 적합성을 평가할 책임이 있습니다. Adobe은 잘못된 구성, MCP 오용, 서드파티 구현의 취약점 또는 MCP 지원 워크플로우를 통해 수행된 의도하지 않은 작업으로 인해 발생하는 문제에 대해 책임을 지지 않습니다.
위험을 줄이기 위해 Adobe에서는 생산적인 사용을 시작하기 전에 샌드박스 환경에서 통합을 테스트하고, 확인하거나 의존하기 전에 모든 MCP에서 시작한 작업과 응답을 주의 깊게 검토하고 확인하는 것이 좋습니다.
MCP 기본 사항
MCP를 AI 애플리케이션용 USB-C 포트와 같이 생각해 보십시오. USB-C가 장치를 다양한 주변 장치와 액세서리에 연결하는 표준화된 방법을 제공하는 것처럼 MCP는 AI 모델을 데이터 소스 및 도구에 연결하는 표준화된 방법을 제공합니다. — 모델 컨텍스트 프로토콜
MCP는 AI 도구가 여러 외부 서비스에 동시에 연결할 수 있도록 한다. 예를 들어 AI 비서는 다음을 수행할 수 있습니다.
- AI 지원 문서 생성을 위해 워드 프로세서에 연결
- 빌드 시각화를 위해 Blender와 같은 애니메이션 도구에 연결합니다
- 비디오 편집을 위해 Adobe After Effects에 연결
MCP는 통신 프로토콜로, 모든 애플리케이션이 AI 도구에 데이터와 작업을 노출하기 위해 구현할 수 있는 개방형 표준입니다.
Marketo Engage MCP가 수행하는 작업과 수행하지 않는 작업
MCP의 범위를 이해하면 AI 도구를 연결하기 전에 기대치를 설정하는 데 도움이 됩니다.
MCP:
- 표준 REST API를 통해 Marketo 데이터 및 기능에 대한 액세스 제공
- 각 요청과 함께 제공한 자격 증명을 사용하여 사용자를 대신하여 API 호출 실행
- 각각 고유한 자격 증명으로 연결된 여러 동시 사용자 지원
- OAuth 토큰 새로 고침을 자동으로 처리합니다. 토큰 만료를 관리할 필요가 없습니다.
- 테넌트가 격리된 환경 내에서 작동하여 데이터가 다른 사용자의 세션과 교차하지 않도록 합니다
MCP:
- AI 또는 머신 러닝 모델을 사용, 호스팅 또는 실행합니다. 모든 AI 처리는 MCP가 아닌 AI 도구에서 발생합니다
- 고객 데이터를 포함한 모든 데이터를 교육하거나 학습합니다.
- 예측, 권장 사항 또는 의사 결정을 생성합니다. 의사 결정은 다운스트림 AI 도구 또는 사용자의 책임입니다
- 자격 증명, 요청 데이터 또는 요청 간 세션 상태 저장 또는 유지
- 서버 측 소프트웨어를 설치, 배포 또는 관리해야 함
MCP는 API 사용에 따라 잠재적으로 민감한 필드를 포함한 데이터를 전송할 수 있지만 B2B 데이터는 고객 비즈니스 데이터를 포함하며 PII 데이터를 포함하지 않습니다.
사전 요구 사항
- REST API 액세스가 활성화된 Marketo 인스턴스
- Marketo LaunchPoint에서 API 자격 증명을 만드는 관리자 액세스
- Cloud Desktop, Cursor, Codex, Claude Code(CLI) 또는 GitHub Copilot을 사용한 VS Code AI 도구 중 하나
- MCP 서버 URL에 대한 네트워크 액세스:
https://marketo-mcp.adobe.io/mcp
Marketo 자격 증명 가져오기
Marketo 인스턴스에서 다음 값이 필요합니다.
- 클라이언트 ID
- 클라이언트 암호
- Munchkin 계정 ID
이미 있는 경우 AI 도구 구성으로 건너뜁니다.
클라이언트 ID 및 클라이언트 암호
- Admin > LaunchPoint(으)로 이동합니다.
- API 서비스를 선택합니다. 계정이 없는 경우 New > New Service을(를) 선택하고 Custom을(를) 서비스 유형으로 선택한 다음 전용 API 사용자를 지정하십시오.
- View Details을(를) 선택하고 Client ID 및 Client Secret 값을 복사합니다.
Munchkin 계정 ID
- Admin > Munchkin(으)로 이동합니다.
- Munchkin Account ID 복사 형식은
XXX-XXX-XXX이며 인스턴스 URL의 접두사와 일치합니다.
AI 도구 구성
각 AI 도구에는 약간 다른 설정이 있습니다. 연결 예는 일반적인 도구에 대해 제공됩니다.
marketo-prod 및 marketo-staging을(를) 추가하십시오. 각 항목에는 해당 자격 증명이 있습니다.클라우드 데스크탑 claude-desktop
클라우드 데스크톱에 연결하려면 marketo-mcp-bridge.zip을 다운로드하고 압축을 풉니다. 다음 단계에서 참조할 수 있도록 알려진 위치에 marketo-mcp-bridge.mjs을(를) 넣습니다.
또한 다음이 필요합니다.
- Node.js v18+
- npm
- 클라우드 데스크톱 열기
- 설정 > 개발자 > 구성 편집으로 이동
claude_desktop_config.json에 다음 추가:
{
"preferences": {
...
},
"mcpServers": {
"marketo-mcp": {
"command": "node",
"args": ["/path/to/marketo-bridge/bridge.mjs"],
"env": {
"MARKETO_MCP_PROD_CLIENT_ID": "<your-client-id>",
"MARKETO_MCP_PROD_CLIENT_SECRET": "<your-client-secret>",
"MARKETO_MCP_PROD_MUNCHKIN_ID": "<your-munchkin-id>"
}
}
}
}
- 클라우드 데스크톱 다시 시작
커서 cursor
커서 MCP 구성에 이미 다른 서버가 있는 경우 mcpServers 아래에 marketo 항목을 추가하십시오.
다음 예제에서는 프로젝트 디렉터리의 Settings > MCP 또는 .cursor/mcp.json에 있는 전체 mcpServers 블록을 보여줍니다.
| code language-json |
|---|
|
| code language-json |
|---|
|
커서를 재시작합니다.
클라우드 코드(CLI) claude-code
터미널에서 다음 명령을 실행하여 자격 증명을 대체하십시오.
| code language-bash |
|---|
|
| code language-bash |
|---|
|
OpenAI 코드 codex
- 설정 > MCP 서버 > 서버 추가 로 이동합니다.
- 서버 URL 추가:
https://marketo-mcp.adobe.io/mcp - 인증 방법에 대한 헤더를 추가합니다.
- 인증: “Bearer YOUR-IMS-TOKEN”
- x-gw-ims-org-id: “YOUR-IMS-ORG-ID”
- X-Marketo-Client-Id: “YOUR-CLIENT-ID”
- X-Marketo-Client-Secret: “YOUR-CLIENT-SECRET”
- X-Marketo-Munchkin-Id: “YOUR-MUNCHKIN-ID”
- 저장 을 클릭하여 프로세스를 완료합니다.
GitHub Copilot이 포함된 VS 코드 vscode
Ctrl+Shift+P(또는 macOS의 Cmd+Shift+P)을 누르고 MCP: Open User Configuration을(를) 입력한 다음 Enter 키를 누릅니다. mcp.json을(를) 엽니다. servers 개체 내에 marketo 항목 추가:
| code language-json |
|---|
|
| code language-json |
|---|
|
${MARKETO_CLIENT_SECRET}과(와) 같은 구문을 사용하여 변수를 참조하고 환경에서 설정할 수 있습니다. 이렇게 하면 버전 제어 파일의 일반 텍스트에 자격 증명이 저장되지 않습니다.기타 도구 other-tools
Marketo MCP 서버는 Adobe에 의해 호스팅되며 공개 URL에 노출됩니다. 스트리밍 가능한 HTTP 전송을 통해 원격 서버를 지원하는 모든 MCP 클라이언트가 연결할 수 있습니다.
도구별 브리지나 로컬에 설치된 소프트웨어는 필요하지 않습니다. 도구가 위에 나열되지 않으면 아래 연결 세부 정보를 사용하여 수동으로 구성하십시오.
연결 세부 정보:
https://marketo-mcp.adobe.io/mcp인증 헤더:
각 요청에 대해 다음 인증 방법 중 하나에 대한 헤더를 보냅니다. 서버 URL 및 헤더를 입력하는 위치는 도구에 따라 다르므로 MCP 설명서를 참조하십시오.
| table 0-row-2 1-row-2 2-row-2 | |
|---|---|
| Header | 값 |
Authorization |
Bearer YOUR-IMS-TOKEN |
x-gw-ims-org-id |
IMS 조직 ID |
| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| Header | 값 |
X-Marketo-Client-Id |
클라이언트 ID |
X-Marketo-Client-Secret |
클라이언트 암호 |
X-Marketo-Munchkin-Id |
Munchkin 계정 ID |
도구가 JSON 구성을 허용하는 경우 Cursor 또는 VS 코드 예제로 시작하고 도구의 스키마와 일치하도록 키(mcpServers, servers)를 조정합니다.
사용 가능한 작업
연결되면 AI 도우미에 다음 카테고리의 작업을 수행하도록 요청할 수 있습니다. API 참조를 사용한 지원되는 작업의 전체 목록은 지원되는 MCP 작업을 참조하십시오.
양식
양식을 검색, 생성, 복제 및 승인합니다. 필드를 추가 또는 제거하고, 필드 가시성 규칙을 구성하고, 양식이 포함된 위치를 식별합니다.
프롬프트 예:
- “승인된 모든 양식 표시”
- “연락처 양식을 Q2 Campaign 폴더로 복제”
- “데모 요청 양식에 회사 필드 추가”
스마트 캠페인
스마트 캠페인을 만들고, 스마트 목록 필터를 구성하고, 흐름 단계를 추가하고, 캠페인을 활성화 또는 비활성화합니다.
프롬프트 예:
- “현재 어떤 스마트 캠페인이 활성화되어 있습니까?”
- “작업 폴더에 잠재 고객 점수 업데이트라는 새 스마트 캠페인 만들기”
- “환영 이메일 캠페인에서 흐름 단계 표시”
리드 및 목록
이메일 주소로 리드를 찾고, 리드 레코드를 만들거나 업데이트하고, 정적 목록 멤버십을 관리합니다.
프롬프트 예:
- “jane@example.com으로 이메일을 보내 잠재 고객 찾기”
- “Q2 MQL 목록에 리드 ID 12345 추가”
- “여름 이벤트 참석자라는 새 정적 목록 만들기”
프로그램
프로그램 생성, 복제 및 태그 지정 유형, 채널 또는 날짜 범위별로 프로그램을 찾아봅니다.
프롬프트 예:
- “Q4 웨비나 프로그램을 2026년 이벤트 폴더에 복제”
- “캠페인 폴더에 여름 세일이라는 새 이메일 프로그램 만들기”
- “웨비나로 태그가 지정된 모든 프로그램 표시”
이메일 및 스니펫
이메일을 검색하고, 템플릿에서 이메일을 만들고, 콘텐츠 섹션을 업데이트하고, 재사용 가능한 스니펫을 관리합니다.
프롬프트 예:
- “모든 초안 이메일 표시”
- “시작 이메일의 헤더 섹션 업데이트”
- “Holiday Promo 코드 조각을 사용하는 자산은 무엇입니까?”
인스턴스 구조
Marketo 구성을 이해하려면 폴더, 채널, 태그 유형 및 활동 유형을 찾아보십시오.
프롬프트 예:
- “Marketo의 모든 폴더 나열”
- “사용 가능한 모든 채널 표시”
- “어떤 태그 유형이 구성됩니까?”
대량 작업
리드 데이터를 일괄로 내보내고 가져오기 또는 내보내기 작업 상태를 확인합니다.
프롬프트 예:
- “지난 30일 동안 생성된 리드의 벌크 내보내기 만들기”
- “내보내기 작업 xx의 상태 확인”
문제 해결
X-Marketo-Client-Id, X-Marketo-Client-Secret 또는 X-Marketo-Munchkin-Id 중 하나 이상이 없습니다.Authorization 헤더를 업데이트하십시오.보안 고려 사항
- 요청당 자격 증명 클라이언트 ID, 클라이언트 암호, Munchkin ID 및 REST API 끝점은 각 요청과 함께 HTTP 헤더로 전송됩니다. 서버는 이러한 정보를 저장하거나 캐시하지 않습니다.
- 다중 테넌트 격리 각 요청은 자체 자격 증명 세트를 사용합니다. 데이터가 다른 사용자의 세션과 교차하지 않습니다.
- Munchkin ID 허용 목록 서버는 승인된 Marketo개 인스턴스에 대한 요청만 허용합니다. 승인되지 않은 Munchkin ID를 사용하는 요청은 403 오류로 거부됩니다.
- API 속도 제한. MCP 서버가 Marketo 인스턴스의 API 속도 제한을 상속합니다. 전용 API 사용자를 사용하여 할당량 소비를 추적하고 관리합니다.
- 자격 증명을 버전 제어에서 벗어나게 합니다. AI 도구에서 지원하는 경우 환경 변수 보간(
${MARKETO_CLIENT_SECRET})을 사용하므로 자격 증명이 저장소 파일의 일반 텍스트에 저장되지 않습니다.