마케토 MCP 서버
Marketo API와 상호 작용하기 위한 모델 컨텍스트 프로토콜 서버입니다. 이 서버는 Marketo 양식 관리 도구(양식 나열, 복제, 승인 등)를 제공합니다.
필수 조건
- Node.js(v14 이상)
- Marketo API 자격 증명(클라이언트 ID 및 클라이언트 비밀번호)
- API 액세스가 활성화된 Marketo 인스턴스
- Claude Desktop 설치됨
시작하기
1. Marketo API 자격 증명 얻기
- Marketo 관리자 패널에 로그인하세요
- 관리 > 통합 > LaunchPoint 로 이동합니다.
- 새로 만들기 > 새 서비스를 클릭하세요.
- 서비스 세부 정보를 입력하세요:
- 서비스: 맞춤형
- 표시 이름: (예: "MCP 서버")
- 제공된 클라이언트 ID 와 클라이언트 비밀번호를 저장합니다.
2. 환경 변수 구성
- 루트 디렉토리에
.env
파일을 만듭니다.
지엑스피1
3. 설치 및 설정
# Install dependencies
npm install
# Build the project
npm run build
# The build process will output configuration settings in your console
# Copy these settings into your Claude Desktop developer configuration
4. Claude 데스크톱 구성
- 클로드 데스크톱 열기
- 개발자 설정으로 이동
- 빌드 프로세스 동안 출력된 구성 설정을 붙여넣습니다.
- 구성을 저장합니다
- Claude Desktop을 다시 시작하세요
사용 가능한 도구
양식 목록 가져오기
marketo_get_forms({
maxReturn: 200, // optional, default: 200
offset: 0, // optional, default: 0
status: 'draft' // optional, 'draft' or 'approved'
})
ID로 양식 가져오기
marketo_get_form_by_id({
formId: 1234
})
복제 양식
marketo_clone_form({
formId: 1234, // ID of form to clone
name: "New Form Name", // Name for the cloned form
description: "Form description", // optional
folderId: 5678 // optional, destination folder ID
})
승인 양식
marketo_approve_form({
formId: 1234,
comment: "Approved by MCP server" // optional
})
오류 처리
일반적인 오류 시나리오 및 해결 방법:
- 인증 오류
- 클라이언트 ID와 클라이언트 비밀번호가 올바른지 확인하세요.
- Marketo에서 API 액세스가 활성화되어 있는지 확인하세요.
- 인스턴스 URL이 올바른지 확인하세요.
- 권한 오류
- API 사용자에게 충분한 권한이 있는지 확인하세요.
- 양식 작업에 대한 폴더 액세스 권한을 확인하세요
- 속도 제한
- 서버는 토큰 새로 고침을 자동으로 처리합니다.
- 속도 제한 요청에 대한 재시도 논리 구현을 고려하세요.
모범 사례
- 환경 관리
.env
파일을 버전 제어에 커밋하지 마세요.- 개발 및 프로덕션에 다른 자격 증명을 사용하세요
- API 자격 증명을 정기적으로 순환하세요
- 보안
- 자격 증명을 안전하게 저장하세요
- 민감한 데이터에 환경 변수를 사용하세요
- API 액세스 로그 모니터링
- 성능
- 적절한 경우 캐시 양식 데이터
- 대규모 양식 목록에 페이지 매김을 사용하세요
- 요금 제한을 적절하게 처리하세요
개발
프로젝트 구조
├── src/
│ ├── index.ts # Server entry point
│ ├── auth.ts # Token management
│ └── constants.ts # Configuration
├── .env # Environment variables (not in git)
├── .env.example # Example environment file
└── .gitignore # Git ignore rules
다음 명령을 사용하여 이 서버에 대해 MCP 검사기를 실행할 수 있습니다: npx @modelcontextprotocol/inspector node build/index.js
기여하다
- 저장소를 포크하세요
- 기능 브랜치 생성
- 변경 사항을 만드세요
- 풀 리퀘스트 제출
지원하다
문제 및 문의사항:
- Marketo REST API 문서를 확인하세요
- 위의 일반적인 오류 시나리오를 검토하세요
- 저장소에 이슈를 제출하세요