mcp-unblockpay — MCP-сервер для Claude Code: как установить
MCP-сервер для работы с платёжным шлюзом UnblockPay. Позволяет агенту регистрировать клиентов, открывать кошельки и проводить переводы между фиатом и стейблкоинами.
claude mcp add --env UNBLOCKPAY_API_KEY=<UNBLOCKPAY_API_KEY> --env UNBLOCKPAY_BASE_URL=<UNBLOCKPAY_BASE_URL> --transport stdio unblockpay -- npx -y @codespar/mcp-unblockpayЧто делает mcp-unblockpay
Сервер связывает ИИ-агента с API шлюза UnblockPay через набор из 13 инструментов. Он закрывает сквозную цепочку операций: регистрацию физических или юридических лиц, запуск проверки личности (KYC), открытие кошельков и фиксацию курса обмена. Котировка фиксируется ровно на пять минут. Сумму в запросе можно передавать либо для отправителя, либо для получателя, но не для обоих сразу. Без одобренного статуса KYC (approved) создать кошелёк клиенту не получится.
Для ввода средств из фиата в стейблкоины вызывается инструмент create_payin, который возвращает платёжные реквизиты — например, строку Pix для Бразилии. Вывод оформляется через create_payout на внешние реквизиты (BRL Pix, USD wire, EUR SEPA, MXN SPEI). За транзакцией можно следить по цепочке статусов от ожидания депозита до завершения. Отменить операцию разрешено только на шаге awaiting_deposit.
Для подключения нужен ключ UNBLOCKPAY_API_KEY, который сервис передаёт напрямую в заголовке Authorization. Чтобы тестировать сценарии без списания денег, базовый адрес переопределяют через UNBLOCKPAY_BASE_URL на https://api.sandbox.unblockpay.com/v1.
Какие задачи решает
- регистрировать клиентов и запускать их проверку KYC
- фиксировать валютный курс и комиссию перед проведением обмена
- получать платёжные инструкции на ввод фиата в стейблкоины
- отправлять выплаты на внешние банковские счета и Pix
- отслеживать статусы и отменять ожидающие транзакции
Примеры запросов агенту
- Зарегистрируй нового корпоративного клиента в UnblockPay и укажи дату регистрации компании.
- Зафиксируй курс обмена для отправки 500 USD в стейблкоины и выведи полученный идентификатор котировки.
- Проверь статус транзакции с указанным ID.
Как установить mcp-unblockpay
Командой платформы
claude mcp add --env UNBLOCKPAY_API_KEY=<UNBLOCKPAY_API_KEY> --env UNBLOCKPAY_BASE_URL=<UNBLOCKPAY_BASE_URL> --transport stdio unblockpay -- npx -y @codespar/mcp-unblockpayВместо <…> подставьте свои значения
Командой платформы
codex mcp add unblockpay --env UNBLOCKPAY_API_KEY=<UNBLOCKPAY_API_KEY> --env UNBLOCKPAY_BASE_URL=<UNBLOCKPAY_BASE_URL> -- npx -y @codespar/mcp-unblockpayВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"unblockpay": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-unblockpay"
],
"env": {
"UNBLOCKPAY_API_KEY": "<UNBLOCKPAY_API_KEY>",
"UNBLOCKPAY_BASE_URL": "<UNBLOCKPAY_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"unblockpay": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-unblockpay"
],
"env": {
"UNBLOCKPAY_API_KEY": "<UNBLOCKPAY_API_KEY>",
"UNBLOCKPAY_BASE_URL": "<UNBLOCKPAY_BASE_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e UNBLOCKPAY_API_KEY=<UNBLOCKPAY_API_KEY> -e UNBLOCKPAY_BASE_URL=<UNBLOCKPAY_BASE_URL> unblockpay npx -y @codespar/mcp-unblockpayВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-unblockpay
Как установить mcp-unblockpay в Claude Code?
Выполните в терминале команду claude mcp add mcp-unblockpay -e UNBLOCKPAY_API_KEY=<UNBLOCKPAY_API_KEY> -- npx -y @codespar/mcp-unblockpay, подставив полученный в кабинете UnblockPay ключ.
Что делает mcp-unblockpay?
Сервер даёт агенту доступ к 13 методам API UnblockPay для трансграничных расчётов. Он позволяет управлять профилями клиентов, открывать стейблкоин-кошельки, рассчитывать котировки и проводить операции через платёжные шлюзы вроде Pix, SEPA и банковские переводы.
Как переключить mcp-unblockpay на тестовую среду?
Задайте переменную окружения UNBLOCKPAY_BASE_URL=https://api.sandbox.unblockpay.com/v1 и используйте API-ключ песочницы. По умолчанию сервер направляет запросы на рабочий адрес https://api.unblockpay.com/v1.
