mcp-niubiz — MCP-сервер для Niubiz: что делает и как установить
MCP-сервер для перуанского эквайера Niubiz: создаёт сессию оплаты, авторизует платёж и отменяет его в тот же день.
claude mcp add --env NIUBIZ_USER=<NIUBIZ_USER> --env NIUBIZ_PASSWORD=<NIUBIZ_PASSWORD> --env NIUBIZ_MERCHANT_ID=<NIUBIZ_MERCHANT_ID> --env NIUBIZ_ENV=<NIUBIZ_ENV> --transport stdio niubiz -- npx -y @codespar/mcp-niubizЧто делает mcp-niubiz
Сервер проводит покупку по трёхшаговой схеме Niubiz: сначала берёт security-токен, потом создаёт checkout-сессию с суммой и антифрод-данными, затем авторизует платёж по transactionToken. Токен кэшируется на 20 минут, остальные инструменты подтягивают его сами.
Данные карты через сервер не идут. Клиент вводит их в форме Niubiz, оттуда возвращается transactionToken, и authorize_transaction закрывает сделку. Для возврата в тот же день есть reverse_transaction.
Понадобятся API-логин, пароль и NIUBIZ_MERCHANT_ID — без них сервер не авторизуется. Переменная NIUBIZ_ENV по умолчанию sandbox, так что боевые списания сами не начнутся.
Какие задачи решает
- создать сессию оплаты Niubiz с суммой и антифрод-данными
- авторизовать покупку по
transactionTokenиз формы - отменить авторизацию в тот же день
- проверить интеграцию на sandbox без реальных списаний
- получить security-токен Niubiz из агента
Примеры запросов агенту
- Создай сессию Niubiz на сумму 120.50 и верни
transactionToken - Авторизуй платёж по последнему
transactionToken - Отмени вчерашнюю авторизацию через reverse
Как установить mcp-niubiz
Командой платформы
claude mcp add --env NIUBIZ_USER=<NIUBIZ_USER> --env NIUBIZ_PASSWORD=<NIUBIZ_PASSWORD> --env NIUBIZ_MERCHANT_ID=<NIUBIZ_MERCHANT_ID> --env NIUBIZ_ENV=<NIUBIZ_ENV> --transport stdio niubiz -- npx -y @codespar/mcp-niubizВместо <…> подставьте свои значения
Командой платформы
codex mcp add niubiz --env NIUBIZ_USER=<NIUBIZ_USER> --env NIUBIZ_PASSWORD=<NIUBIZ_PASSWORD> --env NIUBIZ_MERCHANT_ID=<NIUBIZ_MERCHANT_ID> --env NIUBIZ_ENV=<NIUBIZ_ENV> -- npx -y @codespar/mcp-niubizВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"niubiz": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-niubiz"
],
"env": {
"NIUBIZ_USER": "<NIUBIZ_USER>",
"NIUBIZ_PASSWORD": "<NIUBIZ_PASSWORD>",
"NIUBIZ_MERCHANT_ID": "<NIUBIZ_MERCHANT_ID>",
"NIUBIZ_ENV": "<NIUBIZ_ENV>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"niubiz": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-niubiz"
],
"env": {
"NIUBIZ_USER": "<NIUBIZ_USER>",
"NIUBIZ_PASSWORD": "<NIUBIZ_PASSWORD>",
"NIUBIZ_MERCHANT_ID": "<NIUBIZ_MERCHANT_ID>",
"NIUBIZ_ENV": "<NIUBIZ_ENV>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e NIUBIZ_USER=<NIUBIZ_USER> -e NIUBIZ_PASSWORD=<NIUBIZ_PASSWORD> -e NIUBIZ_MERCHANT_ID=<NIUBIZ_MERCHANT_ID> -e NIUBIZ_ENV=<NIUBIZ_ENV> niubiz npx -y @codespar/mcp-niubizВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-niubiz
Как установить mcp-niubiz в Claude Code?
Вот команда в один шаг: `claude mcp add mcp-niubiz -e NIUBIZ_USER=<NIUBIZ_USER> -e NIUBIZ_PASSWORD=<NIUBIZ_PASSWORD> -e NIUBIZ_MERCHANT_ID=<NIUBIZ_MERCHANT_ID> -- npx -y @codespar/mcp-niubiz`.
Что делает mcp-niubiz?
Даёт агенту четыре инструмента Niubiz: security-токен, сессию оформления заказа, авторизацию и отмену в тот же день.
Что нужно для работы mcp-niubiz?
API-пользователь, пароль и идентификатор мерчанта. NIUBIZ_ENV переключает sandbox и production, по умолчанию стоит sandbox.