mcp-nequi — MCP-сервер для Claude Code: платежи и установка
Подключает Nequi к ИИ-агенту для платежей, QR-кодов, подписок и операций продавца. Нужен для сценариев с кошельком Nequi.
claude mcp add mcp-nequi -e NEQUI_API_KEY=<NEQUI_API_KEY> -e NEQUI_CLIENT_ID=<NEQUI_CLIENT_ID> -e NEQUI_CLIENT_SECRET=<NEQUI_CLIENT_SECRET> -- npx -y @codespar/mcp-nequiЧто делает mcp-nequi
mcp-nequi даёт агенту доступ к операциям Nequi: push-платежам, QR-платежам, подпискам, возвратам и проверке номера телефона. Сервер также умеет получать баланс продавца, список транзакций, данные мерчанта и расчёт за выбранную дату.
Сервер запускается через npx и общается с агентом по stdio; в README также указан HTTP-режим через флаг --http. Для авторизации используются OAuth2 client credentials, NEQUI_API_KEY, NEQUI_CLIENT_ID и NEQUI_CLIENT_SECRET. Окружение задаётся через NEQUI_ENV: sandbox или production.
Это альфа-релиз: пути API ещё не полностью проверены вживую, поэтому перед рабочими платежами нужно проверить их в окружении Nequi. Для установки используется пакет @codespar/mcp-nequi.
Какие задачи решает
- отправить push-платёж пользователю Nequi
- создать QR-код для оплаты
- проверить статус или отменить транзакцию
- получить баланс и операции мерчанта
- запланировать будущий платёж
Примеры запросов агенту
- Проверь статус платежа в Nequi и сообщи результат.
- Создай QR-код для оплаты заказа и сохрани данные ответа.
- Проверь, зарегистрирован ли этот номер телефона в Nequi.
Как установить mcp-nequi
Командой платформы
claude mcp add mcp-nequi -e NEQUI_API_KEY=<NEQUI_API_KEY> -e NEQUI_CLIENT_ID=<NEQUI_CLIENT_ID> -e NEQUI_CLIENT_SECRET=<NEQUI_CLIENT_SECRET> -- npx -y @codespar/mcp-nequiВместо <…> подставьте свои значения
Командой платформы
codex mcp add nequi --env NEQUI_API_KEY=<NEQUI_API_KEY> --env NEQUI_CLIENT_ID=<NEQUI_CLIENT_ID> --env NEQUI_CLIENT_SECRET=<NEQUI_CLIENT_SECRET> -- npx -y @codespar/mcp-nequiВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"nequi": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-nequi"
],
"env": {
"NEQUI_API_KEY": "<NEQUI_API_KEY>",
"NEQUI_CLIENT_ID": "<NEQUI_CLIENT_ID>",
"NEQUI_CLIENT_SECRET": "<NEQUI_CLIENT_SECRET>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"nequi": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-nequi"
],
"env": {
"NEQUI_API_KEY": "<NEQUI_API_KEY>",
"NEQUI_CLIENT_ID": "<NEQUI_CLIENT_ID>",
"NEQUI_CLIENT_SECRET": "<NEQUI_CLIENT_SECRET>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e NEQUI_API_KEY=<NEQUI_API_KEY> -e NEQUI_CLIENT_ID=<NEQUI_CLIENT_ID> -e NEQUI_CLIENT_SECRET=<NEQUI_CLIENT_SECRET> nequi npx -y @codespar/mcp-nequiВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-nequi
Как установить mcp-nequi в Claude Code?
Выполните `claude mcp add mcp-nequi -e NEQUI_API_KEY=<NEQUI_API_KEY> -e NEQUI_CLIENT_ID=<NEQUI_CLIENT_ID> -e NEQUI_CLIENT_SECRET=<NEQUI_CLIENT_SECRET> -- npx -y @codespar/mcp-nequi`.
Что делает mcp-nequi?
Он подключает агента к Nequi и предоставляет инструменты для платежей, QR-кодов, подписок, возвратов, транзакций и данных мерчанта.
Какие данные нужны для работы mcp-nequi?
Перед запуском задайте NEQUI_API_KEY, NEQUI_CLIENT_ID и NEQUI_CLIENT_SECRET. Сервер использует OAuth2 client credentials и передаёт API-ключ в запросах.
