mcp-nupay — MCP-сервер для Claude Code: что делает и как установить
Инструмент подключает ИИ-ассистентов к платёжному шлюзу NuPay от Nubank. Он позволяет проводить списания через Pix, оформлять возвраты и настраивать регулярную оплату.
claude mcp add --env NUPAY_MERCHANT_KEY=<NUPAY_MERCHANT_KEY> --env NUPAY_MERCHANT_TOKEN=<NUPAY_MERCHANT_TOKEN> --env NUPAY_CLIENT_ID=<NUPAY_CLIENT_ID> --env NUPAY_CLIENT_SECRET=<NUPAY_CLIENT_SECRET> --env NUPAY_ENV=<NUPAY_ENV> --transport stdio nupay -- npx -y @codespar/mcp-nupayЧто делает mcp-nupay
Сервер содержит 22 инструмента для взаимодействия с эквайрингом NuPay. Через вызовы функций агент может выставлять счета, проверять статус транзакций по идентификатору pspReferenceId, отменять неподтверждённые списания и формировать возвраты. Поддерживаются также сплит-платежи с регистрацией конечных получателей и выгрузка отчётов о выплатах на банковский счёт.
Авторизация делится на два сценария. Для стандартных операций продавца требуются ключи NUPAY_MERCHANT_KEY и NUPAY_MERCHANT_TOKEN. Для работы с рекуррентными списаниями задействован механизм CIBA и одноразовые пароли по OAuth2. Формирование подписанного JWT client_assertion остаётся на стороне вызывающего сервиса: готовый токен передаётся в exchange_token.
Какие задачи решает
- выставить счёт для оплаты через Pix или приложение Nubank
- проверить статус транзакции по идентификатору
pspReferenceId - оформить частичный или полный возврат средств покупателю
- запустить авторизацию регулярных платежей через одноразовый пароль
Примеры запросов агенту
- Создай платёж NuPay на сумму 150 BRL и покажи статус операции
- Проверь статус возврата по идентификаторам
pspReferenceIdиrefundId - Запусти процесс предварительной авторизации покупателя через
backchannel_start
Как установить mcp-nupay
Командой платформы
claude mcp add --env NUPAY_MERCHANT_KEY=<NUPAY_MERCHANT_KEY> --env NUPAY_MERCHANT_TOKEN=<NUPAY_MERCHANT_TOKEN> --env NUPAY_CLIENT_ID=<NUPAY_CLIENT_ID> --env NUPAY_CLIENT_SECRET=<NUPAY_CLIENT_SECRET> --env NUPAY_ENV=<NUPAY_ENV> --transport stdio nupay -- npx -y @codespar/mcp-nupayВместо <…> подставьте свои значения
Командой платформы
codex mcp add nupay --env NUPAY_MERCHANT_KEY=<NUPAY_MERCHANT_KEY> --env NUPAY_MERCHANT_TOKEN=<NUPAY_MERCHANT_TOKEN> --env NUPAY_CLIENT_ID=<NUPAY_CLIENT_ID> --env NUPAY_CLIENT_SECRET=<NUPAY_CLIENT_SECRET> --env NUPAY_ENV=<NUPAY_ENV> -- npx -y @codespar/mcp-nupayВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"nupay": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-nupay"
],
"env": {
"NUPAY_MERCHANT_KEY": "<NUPAY_MERCHANT_KEY>",
"NUPAY_MERCHANT_TOKEN": "<NUPAY_MERCHANT_TOKEN>",
"NUPAY_CLIENT_ID": "<NUPAY_CLIENT_ID>",
"NUPAY_CLIENT_SECRET": "<NUPAY_CLIENT_SECRET>",
"NUPAY_ENV": "<NUPAY_ENV>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"nupay": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-nupay"
],
"env": {
"NUPAY_MERCHANT_KEY": "<NUPAY_MERCHANT_KEY>",
"NUPAY_MERCHANT_TOKEN": "<NUPAY_MERCHANT_TOKEN>",
"NUPAY_CLIENT_ID": "<NUPAY_CLIENT_ID>",
"NUPAY_CLIENT_SECRET": "<NUPAY_CLIENT_SECRET>",
"NUPAY_ENV": "<NUPAY_ENV>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e NUPAY_MERCHANT_KEY=<NUPAY_MERCHANT_KEY> -e NUPAY_MERCHANT_TOKEN=<NUPAY_MERCHANT_TOKEN> -e NUPAY_CLIENT_ID=<NUPAY_CLIENT_ID> -e NUPAY_CLIENT_SECRET=<NUPAY_CLIENT_SECRET> -e NUPAY_ENV=<NUPAY_ENV> nupay npx -y @codespar/mcp-nupayВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-nupay
Как установить mcp-nupay в Claude Code?
Выполните команду `claude mcp add mcp-nupay -e NUPAY_MERCHANT_KEY=<NUPAY_MERCHANT_KEY> -e NUPAY_MERCHANT_TOKEN=<NUPAY_MERCHANT_TOKEN> -e NUPAY_CLIENT_SECRET=<NUPAY_CLIENT_SECRET> -- npx -y @codespar/mcp-nupay. При необходимости добавьте остальные переменные окружения, такие как NUPAY_ENV или NUPAY_CLIENT_ID`.
Что делает mcp-nupay?
Предоставляет ассистенту 22 функции для управления транзакциями NuPay в Бразилии. С его помощью агент создаёт платежи, делает возвраты, проверяет поступления и настраивает сплит-выплаты.
Как настроить рекуррентные списания через сервер?
Для подписок и повторных списаний нужен протокол CIBA с кодами подтверждения. Вызывающее приложение обязано самостоятельно сформировать и подписать JWT-токен для метода exchange_token.
