Iaptic용 MCP 서버

Iaptic API와 상호작용하기 위한 Model Context Protocol 서버입니다. 이 서버를 통해 Claude나 다른 AI가 사용자의 Iaptic 데이터와 상호작용하여 고객, 구매, 거래 및 통계에 관한 질문에 답변할 수 있습니다.

설치

Smithery를 통한 설치

Smithery를 통해 Claude Desktop용 Iaptic을 자동으로 설치하려면:

npx -y @smithery/cli install mcp-server-iaptic --client claude

수동 설치

# Run directly with npx
npx mcp-server-iaptic --api-key YOUR_API_KEY --app-name YOUR_APP_NAME

# Or install globally
npm install -g mcp-server-iaptic
mcp-server-iaptic --api-key YOUR_API_KEY --app-name YOUR_APP_NAME

Related MCP server: MCP Unified Server

Claude Desktop에서 사용하기

Claude Desktop 설정 파일에 추가하세요:

{
  "iaptic": {
    "command": "npx",
    "args": [
      "mcp-server-iaptic",
      "--api-key", "your-api-key-here",
      "--app-name", "your-app-name-here"
    ]
  }
}

사용 가능한 도구

고객 (Customers)

• customer_list: 페이지네이션을 사용하여 고객 목록 조회

• customer_get: ID별로 상세 고객 정보 조회

• customer_subscription: 고객의 활성 구독 상태 조회

• customer_transactions: 고객의 거래 내역 조회

• customer_add_purchase: 수동으로 구매 내역을 고객에게 연결

구매 (Purchases)

• purchase_list: 구매 목록 조회

  • limit: 반환할 최대 구매 수 (기본값: 100, 최대: 1000)

  • offset: 페이지네이션을 위해 건너뛸 구매 수

  • startdate: 이 날짜 이후의 구매 필터링 (ISO 형식, 예: 2024-01-01)

  • enddate: 이 날짜 이전의 구매 필터링 (ISO 형식, 예: 2024-12-31)

  • customerId: 고객 ID별 필터링

• purchase_get: ID별 구매 상세 정보 조회

거래 (Transactions)

• transaction_list: 페이지네이션 및 날짜 필터링을 사용하여 거래 목록 조회

  • limit: 반환할 최대 거래 수 (기본값: 100, 최대: 1000)

  • offset: 페이지네이션을 위해 건너뛸 거래 수

  • startdate: 이 날짜 이후의 거래 필터링 (ISO 형식, 예: 2024-01-01)

  • enddate: 이 날짜 이전의 거래 필터링 (ISO 형식, 예: 2024-12-31)

  • purchaseId: 구매 ID별 필터링

• transaction_get: ID별 거래 상세 정보 조회

통계 (Statistics)

• stats_get: 거래 및 수익에 대한 일반 통계 조회

• stats_app: 앱별 통계 조회

이벤트 (Events)

• event_list: 페이지네이션 및 날짜 필터링을 사용하여 최근 이벤트 목록 조회

  • limit: 반환할 최대 이벤트 수 (기본값: 100)

  • offset: 페이지네이션을 위해 건너뛸 이벤트 수

  • startdate: 이 날짜 이후의 이벤트 필터링 (ISO 형식, 예: 2024-01-01)

  • enddate: 이 날짜 이전의 이벤트 필터링 (ISO 형식, 예: 2024-12-31)

  • raw: 포맷된 출력 대신 원시 JSON 반환 (기본값: false)

• event_details: 특정 이벤트에 대한 상세 정보 조회 (validator 3.12 이상)

  • eventId: 상세 정보를 가져올 이벤트 ID

  • receipts: 영수증 검증 상세 정보 포함 (기본값: false)

Stripe

• stripe_prices: 사용 가능한 Stripe 제품 및 가격 조회

앱 관리 (App Management)

• iaptic_switch_app: 다른 Iaptic 앱으로 전환

  • appName: 전환할 앱 이름

  • apiKey: 해당 앱의 API 키

• iaptic_reset_app: 기본 Iaptic 앱으로 재설정

• iaptic_current_app: 현재 활성화된 앱에 대한 정보 조회

개발

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Run production build
npm start

요구 사항

• Node.js >= 18

• API 자격 증명이 있는 Iaptic 계정

라이선스

MIT