Marketo MCP 서버

Adobe Marketo Engage를 위한 Model Context Protocol 서버입니다. Claude Desktop, Cursor 및 기타 MCP 호환 클라이언트가 Marketo REST API에 직접 인증된 방식으로 액세스할 수 있도록 지원합니다. 자연어를 사용하여 양식, 스마트 리스트, 채널, 리드, 활동 및 리스트를 읽고 쓸 수 있습니다.

목적

마케팅 운영, 성장 및 RevOps 팀은 Marketo UI를 클릭하며 양식을 복제하거나, 에셋을 승인하거나, 리드를 조회하거나, 스마트 리스트를 감사하는 데 많은 시간을 소비합니다. Marketo MCP 서버는 이러한 REST API 작업을 LLM 에이전트에 연결하여 다음과 같이 말할 수 있게 합니다:

• "양식 1234를 Q2 웨비나 폴더로 복제하고 승인해 줘."

• "alex@example.com 리드의 최근 활동을 보여줘."

• "'Lifecycle Nurture'라는 이름의 새 이메일 채널을 생성해 줘."

…그러면 모델이 사용자를 대신하여 실제 Marketo API 호출을 실행합니다.

Related MCP server: Xero MCP Server

목차

• 기능

• 빠른 시작

• 사전 요구 사항

• 구성

• 사용 가능한 도구

• Claude Desktop에서 사용

• Cursor / 기타 MCP 클라이언트에서 사용

• 문제 해결

• 개발

• 기여

기능

• 양식 관리 — Marketo Asset API를 통해 양식 목록 조회, 검사, 복제 및 승인

• 스마트 리스트 작업 — 스마트 리스트 목록 조회 및 검사

• 채널 CRUD — 채널 생성, 읽기, 업데이트 및 삭제

• 리드 데이터베이스 — ID 또는 이메일로 리드 가져오기, 리드 대량 생성 또는 업데이트, 리드 삭제

• 활동 및 변경 로그 — 모든 리드에 대한 활동 및 필드 변경 사항 가져오기

• 리스트 멤버십 — 정적 리스트에 리드 추가 또는 제거

• 자동 인증 — 토큰 캐싱 및 갱신을 포함한 OAuth 2.0 클라이언트 자격 증명 흐름

• Stdio 전송 — Claude Desktop, Cursor 및 stdio를 지원하는 모든 MCP 클라이언트에서 즉시 사용 가능

빠른 시작

옵션 A — Smithery (권장)

npx -y @smithery/cli install @alexleventer/marketo-mcp --client claude

프롬프트에 따라 Marketo 기본 URL, 클라이언트 ID 및 클라이언트 시크릿을 입력하세요.

옵션 B — npx (설치 불필요)

MCP 클라이언트 구성(예: claude_desktop_config.json)에 다음을 추가하세요:

{
  "mcpServers": {
    "marketo": {
      "command": "npx",
      "args": ["-y", "marketo-mcp"],
      "env": {
        "MARKETO_BASE_URL": "https://123-ABC-456.mktorest.com/rest",
        "MARKETO_CLIENT_ID": "your-client-id",
        "MARKETO_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

옵션 C — 소스에서 빌드

git clone https://github.com/alexleventer/marketo-mcp.git
cd marketo-mcp
npm install
npm run build

빌드 시 출력되는 구성 블록을 복사하여 MCP 클라이언트에 붙여넣으세요.

사전 요구 사항

• Node.js 18 이상

• Marketo API 자격 증명 (LaunchPoint 서비스의 클라이언트 ID 및 클라이언트 시크릿)

• REST API 액세스가 활성화된 Marketo 인스턴스

• MCP 호환 클라이언트 — Claude Desktop, Cursor, Cline 등

Marketo API 자격 증명 획득 방법

1. Marketo 관리자 페이지에 로그인

2. Admin → Integration → LaunchPoint로 이동

3. New → New Service를 클릭하고, 서비스 유형을 Custom으로 설정한 뒤 표시 이름(예: MCP Server)을 지정

4. 필요한 권한(Read-Only Assets, Read-Write Lead 등)을 가진 API 전용 사용자를 할당

5. Client ID와 Client Secret을 저장

6. base URL은 Admin → Integration → Web Services → REST API Endpoint에서 확인 가능 (/rest/v1/*를 제외하고 https://<munchkin>.mktorest.com/rest만 사용)

구성

모든 구성은 환경 변수를 통해 이루어집니다:

로컬 개발을 위해 .env.example을 .env로 복사하세요.

사용 가능한 도구

각 도구는 zod로 검증된 타입 인수를 허용하며 원시 Marketo JSON 응답을 반환합니다. 필드 수준의 세부 정보는 Adobe Marketo REST API 참조를 확인하세요.

Claude Desktop에서 사용

1. Claude Desktop 설치

2. ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 또는 %APPDATA%\Claude\claude_desktop_config.json (Windows) 구성 파일 열기

3. 빠른 시작의 mcpServers 블록을 붙여넣기

4. Claude Desktop 재시작

Cursor / 기타 MCP 클라이언트에서 사용

stdio 서버를 지원하는 모든 MCP 클라이언트에서 사용할 수 있습니다. 빌드된 바이너리를 가리키도록 설정하세요:

{
  "mcpServers": {
    "marketo": {
      "command": "npx",
      "args": ["-y", "marketo-mcp"],
      "env": { "MARKETO_BASE_URL": "...", "MARKETO_CLIENT_ID": "...", "MARKETO_CLIENT_SECRET": "..." }
    }
  }
}

문제 해결

MCP 인스펙터를 사용하여 로컬에서 도구 호출을 검사할 수 있습니다:

npm run inspector

개발

src/
├── index.ts       # MCP server + all tool registrations
├── auth.ts        # OAuth token manager (caches until expiry)
└── constants.ts   # Env var bindings

npm run dev          # Run with ts-node + .env
npm run typecheck    # Type-check without emit
npm run lint         # ESLint
npm run format       # Prettier
npm run build        # Compile to build/

기여

github.com/alexleventer/marketo-mcp에서 이슈 및 풀 리퀘스트를 환영합니다.

1. 저장소 포크

2. 기능 브랜치 생성

3. npm run lint && npm run typecheck 실행

4. PR 생성

라이선스

ISC — LICENSE 참조.

키워드: marketo mcp server, marketo model context protocol, marketo claude, marketo ai, adobe marketo mcp, marketo api claude desktop, marketo automation llm, marketo engage mcp