HitPay MCP server
2026년 10월 30일 커밋실시간 API 액세스 및 자동화된 통합 스캐폴딩을 통해 AI 클라이언트가 HitPay 결제, 인보이스 및 계정 잔액을 관리할 수 있도록 지원합니다.
다른 이름 hit-pay/claude-code-plugin, claude-code-plugin
- 스타
- 1
- Tools
- 20
- 다운로드, 30일
- —
- 최신 버전
- 1.0.0
- 마지막 커밋
- 2026년 10월 30일
- 라이선스
- MIT
HitPay MCP란?
HitPay은(는) MCP server입니다. 실시간 API 액세스 및 자동화된 통합 스캐폴딩을 통해 AI 클라이언트가 HitPay 결제, 인보이스 및 계정 잔액을 관리할 수 있도록 지원합니다. 20개 도구를 제공합니다. 예: get_account_status, get_balances, get_payment_request.
프로젝트 README에서 생성된 요약
HitPay MCP server 정보
HitPay MCP Server를 통해 동남아시아 결제 통합 및 비즈니스 트랜잭션 관리를 직접 수행할 수 있습니다. 개발자는 이 도구를 사용하여 싱가포르, 말레이시아, 필리핀과 같은 시장을 대상으로 체크아웃 흐름, 웹훅 처리 및 결제 수단을 위한 프로덕션 준비 완료된 코드를 스캐폴딩할 수 있습니다. 또한 HitPay 패턴에 대한 심층적인 지식을 제공하여 HitPay.js를 사용한 Next.js 통합 또는 임베디드 결제 양식 구축을 지원합니다.
사용자는 HITPAY_API_KEY 및 HITPAY_SALT 환경 변수가 필요한 로컬 설정을 통해 연결하거나, 비즈니스 소유자 및 관리자를 위해 OAuth를 사용하는 호스팅 버전을 사용할 수 있습니다. 로컬 버전에서는 /hitpay:webhook-test를 통한 테스트 웹훅 페이로드 생성이나 /hitpay:init을 통한 프로젝트 스캐폴딩과 같은 기술적 작업을 수행할 수 있습니다. 호스팅 서버를 통해서는 실시간 판매, 트랜잭션 및 계정 잔액 조회가 가능합니다.
특정 MCP 도구를 통해 이 서버는 get_balances 및 list_invoices와 같은 읽기 작업과 create_payment_request 및 create_recurring_billing과 같은 생성 작업을 처리합니다. 환불이나 취소와 같은 파괴적인 작업은 자동화된 SKILL에서 제외하여 보안을 유지합니다.
활용 사례
- 1결제 통합 스캐폴딩싱가포르 또는 말레이시아와 같은 특정 시장을 위한 완전한 Next.js 결제 통합 코드를 생성합니다.
- 2웹훅 보안 테스트결제 알림을 검증하기 위한 테스트 웹훅 페이로드와 curl 명령어를 생성합니다.
- 3비즈니스 재무 관리OAuth 연결을 통해 실시간 판매, 트랜잭션, 지급 및 계정 잔액을 조회합니다.
- 4QR 결제 생성특정 금액과 통화에 대한 스캔 가능한 QR 결제 페이지를 생성합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
HitPay MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 HitPay MCP 설치
$ claude mcp add --transport http claude-code-plugin https://mcp.hit-pay.com/Cursor에 HitPay MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"claude-code-plugin": {
"url": "https://mcp.hit-pay.com/"
}
}
}VS Code에 HitPay MCP 설치
.vscode/mcp.json
{
"servers": {
"claude-code-plugin": {
"type": "http",
"url": "https://mcp.hit-pay.com/"
}
}
}VS Code CLI에 HitPay MCP 설치
$ code --add-mcp '{"name":"claude-code-plugin","type":"http","url":"https://mcp.hit-pay.com/"}'Codex에 HitPay MCP 설치
$ codex mcp add claude-code-plugin --url https://mcp.hit-pay.com/Codex config.toml에 HitPay MCP 설치
~/.codex/config.toml
[mcp_servers.claude-code-plugin] url = "https://mcp.hit-pay.com/"
Gemini CLI에 HitPay MCP 설치
$ gemini mcp add -s user --transport http claude-code-plugin https://mcp.hit-pay.com/Gemini settings.json에 HitPay MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"claude-code-plugin": {
"url": "https://mcp.hit-pay.com/",
"type": "http"
}
}
}HitPay MCP 도구 20
README에서 감지됨get_account_statusget_balancesget_payment_requestlist_payment_requestslist_chargesget_charge_detaillist_customersget_customerlist_invoiceslist_subscription_planslist_static_qrsget_supported_qr_methods
| get_account_status | — | |
| get_balances | — | |
| get_payment_request | — | |
| list_payment_requests | — | |
| list_charges | — | |
| get_charge_detail | — | |
| list_customers | — | |
| get_customer | — | |
| list_invoices | — | |
| list_subscription_plans | — | |
| list_static_qrs | — | |
| get_supported_qr_methods | — |
도구 20개 모두 보기도구 수 줄이기
get_account_infocreate_payment_requestcreate_customercreate_invoicecreate_embedded_qrcreate_static_qrcreate_webhook_eventcreate_recurring_billing
| get_account_info | — | |
| create_payment_request | — | |
| create_customer | — | |
| create_invoice | — | |
| create_embedded_qr | — | |
| create_static_qr | — | |
| create_webhook_event | — | |
| create_recurring_billing | — |
구성
HITPAY_API_KEYHITPAY_SALT
| 이름 | 설명 | 유형 |
|---|---|---|
| HITPAY_API_KEY | — | |
| HITPAY_SALT | — |
자동 검사
2026년 11월 13일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능hit-pay/claude-code-plugin is public and reachablegithub.com/hit-pay/claude-code-plugin ↗통과
- 패키지가 이 저장소를 소스로 명시검사되지 않음
- 빌드 출처(Sigstore 증명)검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-10-30github.com/hit-pay/claude-code-plugin ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음20 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨No tool named like delete, drop or exec통과
- 원격 엔드포인트가 MCP 핸드셰이크에 응답HTTPS endpoint answered 401 (sign-in required)통과
README
GitHub에서 보기HitPay Plugin for Claude Code
Zero-config SEA payment integration for Claude Code. Gives Claude deep knowledge of HitPay's payment gateway plus live API access — so when developers ask for payment integration, Claude scaffolds production-ready code with the right payment methods, webhook handling, and checkout flows.
What's Inside
| Layer | What It Does | Files |
|---|---|---|
| MCP Server | Live API access — create payments, check statuses, query account | .mcp.json |
| Skills | Teach Claude correct code patterns for HitPay integration | skills/ (5 skills) |
| Commands | Developer actions — scaffold, lookup, test, QR checkout | commands/ (4 commands) |
Installation
Via Marketplace (recommended)
/plugin marketplace add hit-pay/claude-code-plugin
/plugin install hitpay@hitpay-plugins
Local Development
git clone https://github.com/hit-pay/claude-code-plugin.git hitpay-plugin
claude --plugin-dir ./hitpay-plugin
Setup
Set your HitPay API credentials:
export HITPAY_API_KEY=your_api_key_here
export HITPAY_SALT=your_webhook_salt_here
Get these from your HitPay Dashboard under Settings > Payment Gateway > API Keys.
Skills
Skills are auto-invoked when Claude detects relevant context in your conversation.
| Skill | Triggers On | What It Teaches |
|---|---|---|
| payment-integration | "add HitPay", "payment checkout", "accept payments" | API routes, redirect/QR/selector flows, auth headers, test cards |
| webhook-handler | "webhook signature", "payment notification", "verify webhook" | HMAC-SHA256 verification, event types, IP allowlisting, idempotency |
| payment-methods | "methods in Malaysia", "which payment methods", "supported methods" | Country-to-method mapping, API values, currencies, unavailable methods |
| drop-in-ui | "embed payment form", "HitPay.js", "checkout popup" | HitPay.js script, init options, Next.js integration, event handling |
| qr-checkout | "QR checkout page", "QR payment page", "show QR code for PayNow" | Pre-rendered QR images, local HTML page, offline-capable, no CDN |
Commands
| Command | Description | Example |
|---|---|---|
/hitpay:init |
Scaffold a complete integration | /hitpay:init nextjs sg,my |
/hitpay:methods |
Look up payment methods by country | /hitpay:methods ph |
/hitpay:webhook-test |
Generate test webhook payload + curl | /hitpay:webhook-test charge.created |
/hitpay:qr-checkout |
Generate QR payment page with scannable codes | /hitpay:qr-checkout 100 sgd paynow |
MCP Tools
When HITPAY_API_KEY is set, Claude can use these tools during development:
Read Operations
get_account_status— Check KYC and enabled providersget_balances— Current account balancesget_payment_request— Payment request detailslist_payment_requests— List payment requestslist_charges— List charges with filtersget_charge_detail— Charge detailslist_customers— List customersget_customer— Customer detailslist_invoices— List invoiceslist_subscription_plans— Subscription planslist_static_qrs— Static QR codesget_supported_qr_methods— Available QR methodsget_account_info— Account summary
Create Operations
create_payment_request— Create payment with checkout URLcreate_customer— Create customer recordcreate_invoice— Create invoicecreate_embedded_qr— Generate QR for payment collectioncreate_static_qr— Create permanent QR (POS)create_webhook_event— Register webhook URLcreate_recurring_billing— Set up subscription
Hosted HitPay MCP Server
HitPay also runs an official MCP server at https://mcp.hit-pay.com/ for querying and acting on your live HitPay business: sales, transactions, payouts and balances, plus creating payment links, invoices, products and recurring plans. It signs you in with your HitPay login over OAuth, so there is no API key to set. Only business owners and admins can authorize it.
claude mcp add --transport http hitpay https://mcp.hit-pay.com/
Then run /mcp and choose hitpay to sign in. See the MCP server docs.
Supported Markets
| Market | Currency | Key Methods |
|---|---|---|
| Singapore | SGD | PayNow, GrabPay, ShopeePay, Cards |
| Malaysia | MYR | GrabPay, ShopeePay, Touch 'n Go, FPX |
| Philippines | PHP | QR Ph, GCash, ShopeePay |
| Thailand | THB | PromptPay, TrueMoney |
| Vietnam | VND | VietQR, ZaloPay |
| India | INR→SGD | UPI |
| Australia | AUD | PayTo |
| Cross-border | Auto FX | 9 borderless QR methods |
Security
This plugin follows a safe-by-default approach:
- Included: Read operations + payment creation (reversible/safe)
- Excluded from skills: Refunds, deletions, transfers, cancellations (destructive/financial operations)
- Webhook verification: All generated webhook handlers include HMAC-SHA256 signature checks
- API keys: Never exposed client-side in generated code
License
MIT
HitPay MCP 질문
HitPay MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --transport http claude-code-plugin https://mcp.hit-pay.com/를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
HitPay MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
HitPay MCP는 어떤 도구를 제공하나요?
20개 도구를 제공합니다. 예: get_account_status, get_balances, get_payment_request, list_payment_requests, list_charges.