coinvoyage-paykit-claudeplugin

Claude로 구축하는 모든 앱에 비수탁형 멀티체인 암호화폐 결제 게이트웨이인 CoinVoyage를 통합하기 위한 Claude Code 플러그인입니다.

두 가지 인터페이스를 제공합니다:

1. 스킬 (coinvoyage-payments) — Claude가 암호화폐 결제, 체크아웃, 스테이블코인 또는 웹3 결제 작업과 관련하여 도움을 줄 때마다 트리거됩니다. 서버 측 PayOrder 생성, React PaymentWidget, 웹훅 서명 검증, JS를 사용하지 않는 스택을 위한 REST API 폴백 등 통합 전 과정을 안내합니다.

2. MCP 서버 (@kingpeque/coinvoyage-mcp) — Claude가 CoinVoyage API를 직접 호출할 수 있는 15가지 도구를 제공합니다: PayOrder 생성, 상태 확인, 웹훅 관리, 스왑 견적 조회 등.

커뮤니티 유지 관리 통합 플러그인입니다. CoinVoyage와 공식적으로 제휴되어 있지 않습니다.

설치

/plugin install KingPeque/coinvoyage-paykit

설치 시 다음 정보를 입력하라는 메시지가 표시됩니다:

비밀 키는 Claude Code의 민감 정보 설정 경로를 통해 시스템 키체인에 저장되며, 커밋하는 파일에는 절대 포함되지 않습니다.

Related MCP server: Purple Flea Wallet

Claude에게 요청할 수 있는 작업

설치 후 다음과 같은 요청을 하면 스킬 및/또는 MCP 도구가 활성화됩니다:

• "Next.js 체크아웃에 암호화폐 결제 기능을 추가해줘"

• "내 사이트에서 비트코인 결제를 받고 싶어"

• "Base 체인의 USDC로 정산받으면서 모든 암호화폐를 결제 수단으로 받는 기부 페이지를 만들어줘"

• "25달러짜리 테스트 인보이스를 생성하고 Base 체인의 USDC로 정산해줘. 내 지갑 주소는 여기 있어"

• "완료된 주문에 대해 https://mysite.com/api/webhooks/coinvoyage 로 웹훅을 등록해줘"

포함된 내용

coinvoyage-paykit/
├── .claude-plugin/
│   └── plugin.json              # Plugin manifest (prompts user for API keys)
├── mcp.json                     # Declares the bundled MCP server
├── skills/
│   └── coinvoyage-payments/
│       └── SKILL.md             # Integration guide + trigger description
├── mcp-server/                  # Source for @kingpeque/coinvoyage-mcp (npm)
│   ├── src/index.ts
│   ├── package.json
│   └── tsconfig.json
├── README.md
└── LICENSE

지원 체인

비트코인, 솔라나, 이더리움, 옵티미즘, 아비트럼, Base, BSC, 폴리곤, Sui — 그리고 이 체인들에서 지원하는 모든 ERC-20 / SPL / 네이티브 토큰. 전체 체인 ID 참조는 supported_chains MCP 도구에서 확인하세요.

가격 (본 플러그인이 아닌 CoinVoyage 정책)

• 결제 성공 건당 1.5%

• 오프램프(Offramp) 수수료 0%

• 가맹점은 추가로 사용자 지정 수수료율을 설정할 수 있습니다.

• 본 플러그인은 무료이며 MIT 라이선스를 따릅니다. CoinVoyage 수수료 관련 대량 할인 문의: help@coinvoyage.io.

보안 정책

• 저장소 내 비밀 정보 없음. 모든 민감 정보는 Claude Code 설정에 저장되며 런타임에 MCP 서버로 주입됩니다.

• 사용자별 키. 모든 개발자는 자신의 CoinVoyage API 키를 사용합니다. 중앙 집중식으로 호스팅되지 않으며, 침해될 수 있는 공유 서버가 없습니다.

• 최소한의 네트워크 노출. MCP 서버는 api.coinvoyage.io(또는 설정한 오버라이드 주소)와만 통신합니다.

• HMAC-SHA256 인증을 통해 권한이 필요한 작업(SALE/REFUND/웹훅/수수료 청구)을 수행합니다.

• 오픈 소스. MCP 서버 소스 코드(mcp-server/src/index.ts)를 확인하세요. 300줄 미만으로 구성되어 있습니다.

로컬 개발

git clone https://github.com/KingPeque/coinvoyage-paykit
cd coinvoyage-paykit/mcp-server
npm install
npm run build
# Point your MCP client at ./mcp-server/dist/index.js with COINVOYAGE_API_KEY set

skills/coinvoyage-payments/를 ~/.claude/skills/에 심볼릭 링크로 연결하거나 개발 모드에서 플러그인을 설치하여 로컬에서 스킬을 실행하세요.

기여

이슈 및 PR은 https://github.com/KingPeque/coinvoyage-paykit/issues 에서 환영합니다. API 키, 비밀 키, 지갑 주소를 커밋하지 않도록 주의해 주세요.

라이선스

MIT — LICENSE를 참조하세요.

링크

• CoinVoyage 사이트: https://coinvoyage.io

• CoinVoyage 문서: https://docs.coinvoyage.io

• 대시보드: https://dashboard.coinvoyage.io

• 지원: help@coinvoyage.io

• 본 플러그인 이슈: https://github.com/KingPeque/coinvoyage-paykit/issues