coinvoyage-paykit-claudeplugin

Плагин Claude Code для интеграции CoinVoyage — некастодиального мультичейн-шлюза для криптоплатежей — в любое приложение, которое вы создаете с помощью Claude.

Включает два компонента:

1. Навык (coinvoyage-payments) — активируется, когда Claude помогает с криптоплатежами, оформлением заказа, стейблкоинами или работой с Web3-платежами. Предоставляет пошаговое руководство по интеграции: создание PayOrder на стороне сервера, React-виджет PaymentWidget, проверка подписи вебхука и REST API для стеков без JS.

2. MCP-сервер (@kingpeque/coinvoyage-mcp) — предоставляет Claude 15 инструментов для прямого вызова API CoinVoyage: создание PayOrders, проверка статуса, управление вебхуками, получение котировок свопов и многое другое.

Интеграция поддерживается сообществом. Официально не связана с CoinVoyage.

Установка

/plugin install KingPeque/coinvoyage-paykit

При установке вас попросят ввести:

Секретный ключ хранится в связке ключей вашей системы через механизм безопасной конфигурации Claude Code — он никогда не попадет в файл, который вы добавите в репозиторий.

Related MCP server: Purple Flea Wallet

Что теперь можно сказать Claude

После установки следующие запросы активируют навык и/или инструменты MCP:

• "Добавь криптоплатежи в мой чекаут на Next.js"

• "Я хочу принимать Bitcoin на своем сайте"

• "Создай страницу для пожертвований, принимающую любую криптовалюту, с конвертацией в USDC в сети Base"

• "Создай тестовый инвойс на $25 с расчетом в USDC в сети Base, вот мой кошелек"

• "Зарегистрируй вебхук по адресу 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

Поддерживаемые сети

Bitcoin, Solana, Ethereum, Optimism, Arbitrum, Base, BSC, Polygon, Sui — плюс любые токены ERC-20 / SPL / нативные токены в этих сетях. Полный список ID сетей можно найти в инструменте MCP supported_chains.

Комиссии (CoinVoyage, не этого плагина)

• 1.5% за успешный платеж

• 0% за вывод средств (offramp)

• Мерчанты могут добавить свою дополнительную комиссию

• Этот плагин бесплатен и распространяется по лицензии MIT. Скидки на объем комиссий CoinVoyage: help@coinvoyage.io.

Безопасность

• Никаких секретов в этом репозитории. Все конфиденциальные данные хранятся в конфигурации Claude Code и внедряются в MCP-сервер во время выполнения.

• Индивидуальные ключи. Каждый разработчик использует свой собственный API-ключ CoinVoyage. Ничего не хостится централизованно; нет общего сервера, который можно скомпрометировать.

• Минимальная сетевая поверхность. MCP-сервер взаимодействует только с api.coinvoyage.io (или вашим настроенным URL).

• 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