mzc-pops-mcp-server MCP Server

Megazone PoPs SMP(Subscription Management Platform) API를 위한 MCP(Model Context Protocol) 서버입니다.

이 서버는 다음 기능을 제공합니다:

• 계약 관련 리소스에 대한 접근
• 계약 검색을 위한 도구
• 계약 요약을 위한 프롬프트

기능

리소스

• agreement:// URI를 통한 계약 정보 접근
• 각 계약은 SaaS 이름, 기간, 비용 등의 정보 포함

도구

• search_agreements - 특정 조건으로 계약 검색

프롬프트

• summarize_agreements - 모든 계약 요약 및 분석 생성

개발

의존성 설치:

npm install

서버 빌드:

npm run build:dev  # 개발 환경용
npm run build:stg  # 스테이징 환경용
npm run build      # 프로덕션 환경용

개발용 자동 재빌드:

npm run watch

실행

서버 실행 시 다음 인자가 필요합니다:

1. --token 또는 -t: API 접근을 위한 인증 토큰
2. --org 또는 -o: 조직 ID (ORG-xxxx 형식)
3. --ws 또는 -w: 워크스페이스 ID (WKS-xxxx 형식)

예시:

# 직접 실행
./build/index.js --token=your_access_token --org=ORG-001 --ws=WKS-001

# npm 스크립트 사용
npm run start:dev  # 개발 환경용 (package.json에서 실제 토큰과 ID 수정 필요)

설치 및 Claude Desktop 연동

Claude Desktop에서 사용하려면 다음과 같이 설정 파일을 추가하세요:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mzc-pops-mcp-server": {
      "command": "/path/to/mzc-pops-mcp-server/build/index.js --token=your_token --org=ORG-001 --ws=WKS-001"
    }
  }
}

디버깅

MCP 서버는 표준 입출력을 통해 통신하므로 디버깅이 어려울 수 있습니다. MCP Inspector를 사용하면 편리합니다:

npm run inspector

Inspector는 브라우저에서 접근 가능한 디버깅 도구 URL을 제공합니다.

API 명세

SMP API는 다음 엔드포인트를 제공합니다:

• /agreements - 계약 관리

API 사용 시 다음 헤더가 필요합니다:

• pops-organization-id: 조직 ID
• pops-workspace-id: 워크스페이스 ID

pops-user-info 헤더는 API 게이트웨이에서 자동으로 처리되므로 직접 설정할 필요가 없습니다.

자세한 API 명세는 SMP. API spec.pdf 파일을 참조하세요.접근

• 각 계약은 SaaS 이름, 기간, 비용 등의 정보 포함

도구

• create_note - 새 텍스트 노트 생성
• search_agreements - 특정 조건으로 계약 검색
• create_agreement - 새 계약 생성
• delete_agreement - 계약 삭제

프롬프트

• summarize_notes - 저장된 모든 노트 요약 생성
• summarize_agreements - 모든 계약 요약 및 분석 생성

개발

의존성 설치:

npm install

서버 빌드:

npm run build:dev  # 개발 환경용
npm run build:stg  # 스테이징 환경용
npm run build      # 프로덕션 환경용

개발용 자동 재빌드:

npm run watch

실행

서버 실행 시 다음 인자가 필요합니다:

1. --token 또는 -t: API 접근을 위한 인증 토큰
2. --org 또는 -o: 조직 ID (ORG-xxxx 형식)
3. --ws 또는 -w: 워크스페이스 ID (WKS-xxxx 형식)

예시:

# 직접 실행
./build/index.js --token=your_access_token --org=ORG-001 --ws=WKS-001

# npm 스크립트 사용
npm run start:dev  # 개발 환경용 (package.json에서 실제 토큰과 ID 수정 필요)

설치 및 Claude Desktop 연동

Claude Desktop에서 사용하려면 다음과 같이 설정 파일을 추가하세요:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mzc-pops-mcp-server": {
      "command": "/path/to/mzc-pops-mcp-server/build/index.js --token=your_token --org=ORG-001 --ws=WKS-001"
    }
  }
}

디버깅

MCP 서버는 표준 입출력을 통해 통신하므로 디버깅이 어려울 수 있습니다. MCP Inspector를 사용하면 편리합니다:

npm run inspector

Inspector는 브라우저에서 접근 가능한 디버깅 도구 URL을 제공합니다.

API 명세

SMP API는 다음 엔드포인트를 제공합니다:

• /agreements - 계약 관리
• /contracts - 계약서 관리
• /spends - 지출 관리
• /subscriptions - 구독 관리
• /transaction-logs - 거래 로그 관리

API 사용 시 다음 헤더가 필요합니다:

• pops-organization-id: 조직 ID
• pops-workspace-id: 워크스페이스 ID

pops-user-info 헤더는 API 게이트웨이에서 자동으로 처리되므로 직접 설정할 필요가 없습니다.

자세한 API 명세는 SMP. API spec.pdf 파일을 참조하세요.

npm publish --tag development