MCP для Robokassa: полный охват API

robokassa-mcp

Python-клиент и MCP-сервер для Robokassa: счета, статусы, возвраты, холдирование, рекуррентные платежи и чеки 54-ФЗ, 18 инструментов

MCP-серверРоссийский стек

artgas1/robokassa-mcpАвтор:artgas1

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/robokassa-mcp

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.

Выполните в терминале

claude mcp add --transport stdio --env 'ROBOKASSA_LOGIN=<значение ROBOKASSA_LOGIN>' robokassa-mcp -- uvx robokassa-mcp==0.1.2

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "robokassa-mcp": {
      "command": "uvx",
      "args": [
        "robokassa-mcp==0.1.2"
      ],
      "env": {
        "ROBOKASSA_LOGIN": "<значение ROBOKASSA_LOGIN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

ROBOKASSA_LOGINобязательная: Merchant login identifier for the Robokassa shop.
ROBOKASSA_PASSWORD1секрет, необязательная: Shop's Password #1 — used for checkout URL signing, SuccessURL signature verification, CalcOutSumm, fiscal receipts, and SMS.
ROBOKASSA_PASSWORD2секрет, необязательная: Shop's Password #2 — used for OpStateExt payment status checks and ResultURL signature verification.
ROBOKASSA_PASSWORD3секрет, необязательная: Shop's Password #3 — used for Refund API (JWT HS256). Refund API access must be enabled in the cabinet.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "robokassa-mcp": {
      "command": "uvx",
      "args": [
        "robokassa-mcp==0.1.2"
      ],
      "env": {
        "ROBOKASSA_LOGIN": "<значение ROBOKASSA_LOGIN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Ключи и настройки

ROBOKASSA_LOGINобязательная: Merchant login identifier for the Robokassa shop.
ROBOKASSA_PASSWORD1секрет, необязательная: Shop's Password #1 — used for checkout URL signing, SuccessURL signature verification, CalcOutSumm, fiscal receipts, and SMS.
ROBOKASSA_PASSWORD2секрет, необязательная: Shop's Password #2 — used for OpStateExt payment status checks and ResultURL signature verification.
ROBOKASSA_PASSWORD3секрет, необязательная: Shop's Password #3 — used for Refund API (JWT HS256). Refund API access must be enabled in the cabinet.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

code --add-mcp '{"name":"robokassa-mcp","type":"stdio","command":"uvx","args":["robokassa-mcp==0.1.2"],"env":{"ROBOKASSA_LOGIN":"<значение ROBOKASSA_LOGIN>"}}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "robokassa-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "robokassa-mcp==0.1.2"
      ],
      "env": {
        "ROBOKASSA_LOGIN": "<значение ROBOKASSA_LOGIN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Ключи и настройки

ROBOKASSA_LOGINобязательная: Merchant login identifier for the Robokassa shop.
ROBOKASSA_PASSWORD1секрет, необязательная: Shop's Password #1 — used for checkout URL signing, SuccessURL signature verification, CalcOutSumm, fiscal receipts, and SMS.
ROBOKASSA_PASSWORD2секрет, необязательная: Shop's Password #2 — used for OpStateExt payment status checks and ResultURL signature verification.
ROBOKASSA_PASSWORD3секрет, необязательная: Shop's Password #3 — used for Refund API (JWT HS256). Refund API access must be enabled in the cabinet.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

codex mcp add robokassa-mcp --env 'ROBOKASSA_LOGIN=<значение ROBOKASSA_LOGIN>' -- uvx robokassa-mcp==0.1.2

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.robokassa-mcp]
command = "uvx"
args = ["robokassa-mcp==0.1.2"]
env = { ROBOKASSA_LOGIN = "<значение ROBOKASSA_LOGIN>" }

Если файл уже есть, допишите блок в конец.

Ключи и настройки

ROBOKASSA_LOGINобязательная: Merchant login identifier for the Robokassa shop.
ROBOKASSA_PASSWORD1секрет, необязательная: Shop's Password #1 — used for checkout URL signing, SuccessURL signature verification, CalcOutSumm, fiscal receipts, and SMS.
ROBOKASSA_PASSWORD2секрет, необязательная: Shop's Password #2 — used for OpStateExt payment status checks and ResultURL signature verification.
ROBOKASSA_PASSWORD3секрет, необязательная: Shop's Password #3 — used for Refund API (JWT HS256). Refund API access must be enabled in the cabinet.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

gemini mcp add -s user -e 'ROBOKASSA_LOGIN=<значение ROBOKASSA_LOGIN>' robokassa-mcp uvx robokassa-mcp==0.1.2

Или добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "robokassa-mcp": {
      "command": "uvx",
      "args": [
        "robokassa-mcp==0.1.2"
      ],
      "env": {
        "ROBOKASSA_LOGIN": "<значение ROBOKASSA_LOGIN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

ROBOKASSA_LOGINобязательная: Merchant login identifier for the Robokassa shop.
ROBOKASSA_PASSWORD1секрет, необязательная: Shop's Password #1 — used for checkout URL signing, SuccessURL signature verification, CalcOutSumm, fiscal receipts, and SMS.
ROBOKASSA_PASSWORD2секрет, необязательная: Shop's Password #2 — used for OpStateExt payment status checks and ResultURL signature verification.
ROBOKASSA_PASSWORD3секрет, необязательная: Shop's Password #3 — used for Refund API (JWT HS256). Refund API access must be enabled in the cabinet.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "robokassa-mcp": {
      "command": "uvx",
      "args": [
        "robokassa-mcp==0.1.2"
      ],
      "env": {
        "ROBOKASSA_LOGIN": "<значение ROBOKASSA_LOGIN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Ключи и настройки

ROBOKASSA_LOGINобязательная: Merchant login identifier for the Robokassa shop.
ROBOKASSA_PASSWORD1секрет, необязательная: Shop's Password #1 — used for checkout URL signing, SuccessURL signature verification, CalcOutSumm, fiscal receipts, and SMS.
ROBOKASSA_PASSWORD2секрет, необязательная: Shop's Password #2 — used for OpStateExt payment status checks and ResultURL signature verification.
ROBOKASSA_PASSWORD3секрет, необязательная: Shop's Password #3 — used for Refund API (JWT HS256). Refund API access must be enabled in the cabinet.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "robokassa-mcp": {
      "command": "uvx",
      "args": [
        "robokassa-mcp==0.1.2"
      ],
      "env": {
        "ROBOKASSA_LOGIN": "<значение ROBOKASSA_LOGIN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Ключи и настройки

ROBOKASSA_LOGINобязательная: Merchant login identifier for the Robokassa shop.
ROBOKASSA_PASSWORD1секрет, необязательная: Shop's Password #1 — used for checkout URL signing, SuccessURL signature verification, CalcOutSumm, fiscal receipts, and SMS.
ROBOKASSA_PASSWORD2секрет, необязательная: Shop's Password #2 — used for OpStateExt payment status checks and ResultURL signature verification.
ROBOKASSA_PASSWORD3секрет, необязательная: Shop's Password #3 — used for Refund API (JWT HS256). Refund API access must be enabled in the cabinet.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "robokassa-mcp": {
      "command": "uvx",
      "args": [
        "robokassa-mcp==0.1.2"
      ],
      "env": {
        "ROBOKASSA_LOGIN": "<значение ROBOKASSA_LOGIN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

ROBOKASSA_LOGINобязательная: Merchant login identifier for the Robokassa shop.
ROBOKASSA_PASSWORD1секрет, необязательная: Shop's Password #1 — used for checkout URL signing, SuccessURL signature verification, CalcOutSumm, fiscal receipts, and SMS.
ROBOKASSA_PASSWORD2секрет, необязательная: Shop's Password #2 — used for OpStateExt payment status checks and ResultURL signature verification.
ROBOKASSA_PASSWORD3секрет, необязательная: Shop's Password #3 — used for Refund API (JWT HS256). Refund API access must be enabled in the cabinet.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "robokassa-mcp": {
      "type": "local",
      "command": [
        "uvx",
        "robokassa-mcp==0.1.2"
      ],
      "environment": {
        "ROBOKASSA_LOGIN": "<значение ROBOKASSA_LOGIN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Ключи и настройки

ROBOKASSA_LOGINобязательная: Merchant login identifier for the Robokassa shop.
ROBOKASSA_PASSWORD1секрет, необязательная: Shop's Password #1 — used for checkout URL signing, SuccessURL signature verification, CalcOutSumm, fiscal receipts, and SMS.
ROBOKASSA_PASSWORD2секрет, необязательная: Shop's Password #2 — used for OpStateExt payment status checks and ResultURL signature verification.
ROBOKASSA_PASSWORD3секрет, необязательная: Shop's Password #3 — used for Refund API (JWT HS256). Refund API access must be enabled in the cabinet.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "robokassa-mcp": {
      "command": "uvx",
      "args": [
        "robokassa-mcp==0.1.2"
      ],
      "env": {
        "ROBOKASSA_LOGIN": "<значение ROBOKASSA_LOGIN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Ключи и настройки

ROBOKASSA_LOGINобязательная: Merchant login identifier for the Robokassa shop.
ROBOKASSA_PASSWORD1секрет, необязательная: Shop's Password #1 — used for checkout URL signing, SuccessURL signature verification, CalcOutSumm, fiscal receipts, and SMS.
ROBOKASSA_PASSWORD2секрет, необязательная: Shop's Password #2 — used for OpStateExt payment status checks and ResultURL signature verification.
ROBOKASSA_PASSWORD3секрет, необязательная: Shop's Password #3 — used for Refund API (JWT HS256). Refund API access must be enabled in the cabinet.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "robokassa-mcp": {
      "command": "uvx",
      "args": [
        "robokassa-mcp==0.1.2"
      ],
      "env": {
        "ROBOKASSA_LOGIN": "<значение ROBOKASSA_LOGIN>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

ROBOKASSA_LOGINобязательная: Merchant login identifier for the Robokassa shop.
ROBOKASSA_PASSWORD1секрет, необязательная: Shop's Password #1 — used for checkout URL signing, SuccessURL signature verification, CalcOutSumm, fiscal receipts, and SMS.
ROBOKASSA_PASSWORD2секрет, необязательная: Shop's Password #2 — used for OpStateExt payment status checks and ResultURL signature verification.
ROBOKASSA_PASSWORD3секрет, необязательная: Shop's Password #3 — used for Refund API (JWT HS256). Refund API access must be enabled in the cabinet.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Понадобится: uv

Сверено с репозиторием 25 сент. 2026, коммит 5f2ae1f.

Текст для агента

Установи сервер командой uvx robokassa-mcp, задай ROBOKASSA_LOGIN, ROBOKASSA_PASSWORD1, ROBOKASSA_PASSWORD2 и ROBOKASSA_PASSWORD3 из личного кабинета Robokassa и добавь в claude_desktop_config.json или через claude mcp add robokassa -e ... -- uvx robokassa-mcp.

Другие способы из описания автора

uvx robokassa-mcp

Установка и запуск MCP-сервера через uvx, требует заданных переменных ROBOKASSA_*.

Проверка безопасности

Как мы проверяем

Высокий рискВысокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.

Инструменты создают счета, инициируют возвраты, холдируют и списывают деньги с карт клиентов
Стоит хранить Password#3 отдельно и включать доступ к Refund API только когда он реально нужен

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Проект дает Python-библиотеку robokassa и MCP-сервер robokassa-mcp поверх нее, публикуется в PyPI и в реестре MCP. Покрывает восемь групп официального API Robokassa: формирование подписанной ссылки на оплату с опциональным чеком 54-ФЗ, проверку статуса платежа через XML-интерфейс OpStateExt, расчет суммы к зачислению, возвраты и опрос их статуса, двухэтапное холдирование карты, родительские и дочерние рекуррентные списания, мультиполучательские сплит-платежи для маркетплейсов, платное SMS-уведомление и проверку подписи вебхуков ResultURL и SuccessURL. Всего 18 инструментов MCP, плюс низкоуровневые функции подписи доступны только из Python. Запускается через uvx, pip или Docker, поддерживает stdio, HTTP, streamable-http и SSE.

Для кого. Для разработчиков интернет-магазинов и сервисов на Robokassa, которым нужен полный охват платежного API, а не только выставление счета.

Подходит, если

Нужно формировать счета на оплату с чеком 54-ФЗ и проверять их статус
Нужны возвраты, холдирование карты или рекуррентные списания через Robokassa
Нужна проверка подписи вебхуков ResultURL и SuccessURL на своем сервере

Не подходит, если

Нужен только базовый счет и проверка статуса: более простой сервер theYahia/robokassa-mcp меньше и проще в настройке
Покрытие Partner API нужно шире, чем один инструмент partner_refund: остальные методы Partner API не реализованы

Пример запроса к агенту

Сформируй ссылку на оплату 599 рублей за подписку с чеком 54-ФЗ и пришли ее клиенту

MCP

Транспорт: stdio, http, sse
Авторизация: API-ключ

Переменные окружения

ROBOKASSA_LOGIN обязательная: Логин магазина в Robokassa
ROBOKASSA_PASSWORD1 обязательная, секрет: Пароль 1: подпись чеков, оплаты, фискализации и SMS
ROBOKASSA_PASSWORD2 обязательная, секрет: Пароль 2: проверка статуса платежа и подписи ResultURL
ROBOKASSA_PASSWORD3 секрет: Пароль 3: инициирование возвратов через refund_create

Ограничения

README пишет install (once published), то есть публикация в PyPI на момент README считалась завершающим шагом релиза, актуальность пакета стоит проверить в PyPI перед установкой. Возвраты и рекуррентные списания требуют отдельного доступа в личном кабинете Robokassa (Refund API, JWT для Partner API). Автор описывает поддержку проекта как drop-and-forget: PR принимаются, но без гарантии быстрого ревью.

Как отключить. Удалите сервер robokassa из конфигурации MCP-клиента, например claude mcp remove robokassa.

Частые вопросы

Нужны ли все три пароля сразу?

Нет, каждый инструмент требует свой: Password#1 для чеков и оплаты, Password#2 для проверки статуса и подписи ResultURL, Password#3 для возвратов.

Работают ли возвраты сразу после установки?

Нет, refund_create требует, чтобы в личном кабинете Robokassa был включен доступ к Refund API.

MCP-серверы

AI Berkshire

Выбор редакции

Набор скиллов для инвестиционного исследования компаний в Claude Code и Codex по методологиям четырех инвесторов. Это исследовательский инструмент, не инвестици

СкиллСредний риск16,6 тыс.

Stripe AI

Официальный

Официальные MCP-сервер, плагины и скиллы Stripe: агент ищет по API и документации, читает и меняет данные аккаунта

MCP-серверВысокий риск1,8 тыс.

Alpaca MCP Server

Официальный

Официальный MCP-сервер брокера Alpaca: заявки по акциям, ETF, крипте и опционам, управление позициями и рыночные данные на естественном языке

MCP-серверВысокий риск995

inn-check-ru: светофор риска по ИНН

inn-check-ru

Выбор редакции

Открытый скилл, который по ИНН сверяет ЕГРЮЛ, ФССП, суды, банкротства и санкции сразу по нескольким источникам и выдает светофор риска с датой и причиной

СкиллНизкий риск4

Коротко о README

README дает примеры использования и как Python-библиотеки, и как MCP-сервера: построение подписанной ссылки на оплату, полный цикл возврата с опросом статуса, проверка подписи вебхука на FastAPI, конфиги для Claude Desktop, Claude Code, Cursor, VS Code Copilot и Windsurf, таблицу всех 18 инструментов с указанием, какой пароль нужен каждому, таблицу покрытия восьми групп официального API и переменные окружения с их назначением.

Установка

Проверка безопасности

Что делает

Подходит, если

Не подходит, если

Пример запроса к агенту

MCP

Переменные окружения

Ограничения

Частые вопросы

Похожие

AI Berkshire

Stripe AI

Alpaca MCP Server

inn-check-ru: светофор риска по ИНН

Коротко о README