MCP Adobe Campaign Tool

MCP (Model Context Protocol) 서버로 Adobe Campaign API와 통합하여 자연어로 캠페인, 프로필, 배송 정보를 조회하고 관리할 수 있는 도구입니다.

기능

• 캠페인 관리: 캠페인 조회, 생성, 수정, 삭제
• 프로필 조회: 프로필 정보 조회 및 검색
• 배송 관리: 배송 정보 조회 및 로그 확인

설치

요구사항

• Node.js 18 이상
• npm 또는 yarn
• Adobe Campaign API 인증 정보

설치 방법

npm으로 설치 (권장)

npm install -g mcp-adobe-campaign-tool

로컬에서 개발

1. 저장소 클론:

git clone <repository-url>
cd mcp-adobe-campaign-tool

2. 의존성 설치:

npm install

3. 빌드:

npm run build

4. 환경 변수 설정:

cp .env.example .env
# .env 파일을 편집하여 Adobe Campaign API 정보를 입력

설정

.env 파일에 다음 정보를 설정하세요:

CAMPAIGN_ENDPOINT=https://your-instance.campaign.adobe.com
CAMPAIGN_CLIENT_ID=your_client_id
CAMPAIGN_CLIENT_SECRET=your_client_secret
CAMPAIGN_TENANT_ID=your_tenant_id
CAMPAIGN_ORGANIZATION_ID=your_organization_id
CAMPAIGN_API_VERSION=v1

사용 방법

MCP 서버로 실행

# npm으로 설치한 경우
mcp-adobe-campaign-tool

# 또는 로컬에서 개발 중인 경우
npm start
# 또는
node dist/index.js

Claude Desktop과 통합

상세한 등록 방법은 MCP_REGISTRATION.md를 참고하세요.

빠른 시작

1. Claude Desktop 설정 파일 위치:

   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

2. 설정 파일 편집:

   • Claude Desktop > 파일 > 설정 > 개발자 > 설정 편집
   • 또는 직접 파일 열기

3. 다음 내용 추가 (프로젝트 경로를 실제 경로로 변경):

{
  "mcpServers": {
    "adobe-campaign": {
      "command": "node",
      "args": ["path/to/mcp-adobe-campaign-tool/dist/index.js"],
      "env": {
        "CAMPAIGN_ENDPOINT": "https://your-instance.campaign.adobe.com",
        "CAMPAIGN_CLIENT_ID": "your_client_id",
        "CAMPAIGN_CLIENT_SECRET": "your_client_secret",
        "CAMPAIGN_TENANT_ID": "your_tenant_id",
        "CAMPAIGN_ORGANIZATION_ID": "your_organization_id"
      }
    }
  }
}

npm으로 전역 설치한 경우:

{
  "mcpServers": {
    "adobe-campaign": {
      "command": "mcp-adobe-campaign-tool"
    }
  }
}

또는 .env 파일 사용 시 (권장):

프로젝트 디렉토리에 .env 파일을 생성하고, Claude Desktop 설정에서는:

{
  "mcpServers": {
    "adobe-campaign": {
      "command": "node",
      "args": ["path/to/mcp-adobe-campaign-tool/dist/index.js"],
      "cwd": "path/to/mcp-adobe-campaign-tool"
    }
  }
}

이 경우 프로젝트 루트의 .env 파일을 자동으로 읽습니다.

4. Claude Desktop 재시작

사용 가능한 도구

캠페인 도구

• get_campaigns: 캠페인 목록 조회 (페이지네이션 및 필터링 지원)
• get_campaign: 특정 캠페인 상세 정보 조회
• create_campaign: 새 캠페인 생성
• update_campaign: 캠페인 정보 수정
• delete_campaign: 캠페인 삭제

프로필 도구

• get_profiles: 프로필 목록 조회 (페이지네이션 및 필터링 지원)
• get_profile: 특정 프로필 상세 정보 조회

배송 도구

• get_deliveries: 배송 목록 조회 (페이지네이션 및 필터링 지원)
• get_delivery: 특정 배송 상세 정보 조회
• get_delivery_logs: 배송 로그 조회

개발

프로젝트 구조

mcp-adobe-campaign-tool/
├── src/
│   ├── index.ts               # MCP 서버 메인
│   └── adobe-campaign-client.ts  # Adobe Campaign API 클라이언트
├── dist/                      # 빌드 출력 (자동 생성)
├── package.json
├── tsconfig.json
├── .env.example
└── README.md

개발

# 개발 모드로 실행 (watch 모드)
npm run dev

# 빌드
npm run build

# 빌드 후 실행
npm start

npm 패키지 배포

# 빌드
npm run build

# npm 배포 (npm 로그인 필요)
npm publish

라이선스

MIT License

기여

이슈 및 풀 리퀘스트를 환영합니다!