Iaptic용 MCP 서버
Iaptic API 와 상호 작용하기 위한 모델 컨텍스트 프로토콜 서버입니다. 이 서버를 통해 Claude 또는 다른 AI가 Iaptic 데이터와 상호 작용하여 고객, 구매, 거래 및 통계에 대한 질문에 답변할 수 있습니다.
설치
Smithery를 통해 설치
Smithery를 통해 Claude Desktop에 Iaptic을 자동으로 설치하는 방법:
지엑스피1
수동 설치
# 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
Claude Desktop과 함께 사용
Claude Desktop 구성 파일에 다음을 추가합니다.
{
"iaptic": {
"command": "npx",
"args": [
"mcp-server-iaptic",
"--api-key", "your-api-key-here",
"--app-name", "your-app-name-here"
]
}
}
사용 가능한 도구
고객
customer_list
: 고객 목록customer_get
: ID로 고객 세부 정보를 가져옵니다.
구매
purchase_list
: 구매 목록limit
: 반품할 최대 구매 수 (기본값: 100, 최대값: 1000)offset
: 페이지 넘김을 위해 건너뛸 구매 수startdate
: 이 날짜 이후의 구매 필터링(ISO 형식, 예: 2024-01-01)enddate
: 이 날짜 이전의 구매 필터링(ISO 형식, 예: 2024-12-31)customerId
: 고객 ID로 필터링
purchase_get
: ID로 구매 내역 가져오기
업무
transaction_list
: 페이지 매김 및 날짜 필터링을 사용하여 거래 목록 작성limit
: 반환할 최대 거래 수 (기본값: 100, 최대값: 1000)offset
: 페이지 분할을 위해 건너뛸 트랜잭션 수startdate
: 이 날짜 이후의 거래를 필터링합니다(ISO 형식, 예: 2024-01-01)enddate
: 이 날짜 이전의 거래를 필터링합니다(ISO 형식, 예: 2024-12-31)purchaseId
: 구매 ID로 필터링
transaction_get
: ID로 거래 세부 정보를 가져옵니다.
통계
stats_get
: 거래 및 수익에 대한 일반 통계를 가져옵니다.stats_app
: 앱별 통계 가져오기
이벤트
event_list
: 페이지 매김 및 날짜 필터링을 통해 최근 이벤트를 나열합니다.limit
: 반환할 이벤트의 최대 개수(기본값: 100)offset
: 페이지 매김을 위해 건너뛸 이벤트 수startdate
: 이 날짜 이후의 이벤트 필터링(ISO 형식, 예: 2024-01-01)enddate
: 이 날짜 이전의 이벤트 필터링(ISO 형식, 예: 2024-12-31)
앱 관리
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
요구 사항
- 노드.js >= 18
- API 자격 증명이 있는 Iaptic 계정
특허
MIT