Korra
Обсудить задачу
Меню
Обсудить задачу
MCPОфициальныйКод закрыт

Робокасса

Оплата на сайте и в боте с тестовой проверкой

Официальный MCP-сервер Робокассы. Агент встроит приём оплаты в ваш сайт или Telegram-бота, сверит подпись и чек и проверит всё тестовым платежом — деньги не списываются.

  • Удалённый сервис: Робокасса
  • Нужен ключ
  • Читает и меняет
  • Комиссия с оплат, от 1,8%
  • Данные: Робокасса, Россия

Проверено 29.09.2026: Claude Code 2.1.280, движок Korra 0.21.15 (Hermes) · 17 инструментов

Подключить через агента ↓Что можно сделать ↓Сайт проекта ↗
Пример задачи
«Добавь оплату к заказам»
Тестовая оплата прошла

Что можно поручить агенту

  • Встроить оплату в сайт или бота: ссылка на оплату, обработчик уведомлений, отметка «оплачен» у заказа.

  • Сверить подпись в вашем коде с эталонным расчётом — до первой оплаты.

  • Проверить чек по 54-ФЗ: обязательные поля, ставки НДС, признаки расчёта.

  • Собрать тестовую ссылку: вы платите тестовой картой, деньги не списываются.

  • Пройти чек-лист перехода в боевой режим. Боевые шаги вы делаете сами в личном кабинете.

Подключить

Проще всего — отправить агенту ссылку: он прочитает инструкцию, установит, подключит и проверит сам.

Сообщение агенту
Подключи инструмент «Робокасса» по инструкции: https://korra-agent.online/library/robokassa/agent.txt

Если агент не открывает ссылки — скопируйте задание целиком.

Попросите агента

Задание для агента

Подойдёт Claude Code, Codex, Cursor, Hermes, OpenClaw или Korra. Команды в задании те же, что в справке ниже.

Что понадобится от вас

Остальное агент сделает сам, а эти значения есть только у вас.

  1. Идентификатор магазина → ROBOKASSA_LOGIN«Технические настройки» магазина. Это не почта и не название магазина. Где взять
  2. Тестовый пароль №1 → ROBOKASSA_TEST_PASSWORD_1Там же, в тестовых настройках. Где взять
  3. Тестовый пароль №2 → ROBOKASSA_TEST_PASSWORD_2Там же. Боевые пароли серверу не нужны — не передавайте их. Где взять

Ключи не отправляйте агенту в чат: он подскажет, куда их сохранить, и проверит, что они на месте.

Что выполнит агент

Агент выполнит их сам — вручную только если хотите. Метка показывает, насколько глубоко мы это проверили.

Claude Code

Проверено

Задайте три переменные в профиле терминала и запускайте Claude Code из него. В конфиг попадут только ссылки на переменные.

терминал
claude mcp add-json --scope user robokassa '{"type":"http","url":"https://mcp.robokassa.ru/mcp","headers":{"X-Robokassa-Login":"${ROBOKASSA_LOGIN}","X-Robokassa-Test-Password-1":"${ROBOKASSA_TEST_PASSWORD_1}","X-Robokassa-Test-Password-2":"${ROBOKASSA_TEST_PASSWORD_2}"}}'
Проверить
claude mcp get robokassa — «Status: ✔ Connected»
Откатить
claude mcp remove robokassa -s user

Если переменные не заданы, claude mcp list предупредит: «Missing environment variables». После подключения откройте новую сессию.

Codex

Конфиг проверен

Добавьте блок в ~/.codex/config.toml. В файле остаются имена переменных, значения Codex берёт из среды при запуске.

~/.codex/config.toml
[mcp_servers.robokassa]
url = "https://mcp.robokassa.ru/mcp"
env_http_headers = { "X-Robokassa-Login" = "ROBOKASSA_LOGIN", "X-Robokassa-Test-Password-1" = "ROBOKASSA_TEST_PASSWORD_1", "X-Robokassa-Test-Password-2" = "ROBOKASSA_TEST_PASSWORD_2" }
Проверить
codex mcp get robokassa — в env_http_headers видны три заголовка; в сессии — команда /mcp
Откатить
codex mcp remove robokassa

Источник

Cursor

По документации агента

Добавьте сервер в ~/.cursor/mcp.json или в .cursor/mcp.json проекта. Cursor подставляет ${env:…} из среды при запуске.

~/.cursor/mcp.json
{
  "mcpServers": {
    "robokassa": {
      "url": "https://mcp.robokassa.ru/mcp",
      "headers": {
        "X-Robokassa-Login": "${env:ROBOKASSA_LOGIN}",
        "X-Robokassa-Test-Password-1": "${env:ROBOKASSA_TEST_PASSWORD_1}",
        "X-Robokassa-Test-Password-2": "${env:ROBOKASSA_TEST_PASSWORD_2}"
      }
    }
  }
}
Проверить
Customize → MCP — сервер robokassa включён; при ошибке смотрите Output → MCP Logs
Откатить
удалите запись robokassa из mcp.json

Источник

Hermes

Проверено

Попросите агента подключить Робокассу: он сам выполнит команды ниже, в конфиг попадут только ссылки на переменные. Значения положите в ~/.hermes/.env или на страницу ключей в дашборде. Затем отправьте в чат /reload-mcp.

терминал агента
hermes config set mcp_servers.robokassa.url https://mcp.robokassa.ru/mcp
hermes config set mcp_servers.robokassa.headers.X-Robokassa-Login '${ROBOKASSA_LOGIN}'
hermes config set mcp_servers.robokassa.headers.X-Robokassa-Test-Password-1 '${ROBOKASSA_TEST_PASSWORD_1}'
hermes config set mcp_servers.robokassa.headers.X-Robokassa-Test-Password-2 '${ROBOKASSA_TEST_PASSWORD_2}'
Проверить
hermes mcp test robokassa
Откатить
hermes mcp remove robokassa

Проверено на движке Korra 0.21.15 — это сборка Hermes: команды, подключение и тестовый платёж. Форма MCP в дашборде принимает только Bearer-токен, поэтому три заголовка удобнее задать командами.

OpenClaw

По документации агента

Добавьте сервер в реестр OpenClaw. Подстановка ${…} берёт значения из переменных окружения.

терминал
openclaw mcp set robokassa '{"url":"https://mcp.robokassa.ru/mcp","transport":"streamable-http","headers":{"X-Robokassa-Login":"${ROBOKASSA_LOGIN}","X-Robokassa-Test-Password-1":"${ROBOKASSA_TEST_PASSWORD_1}","X-Robokassa-Test-Password-2":"${ROBOKASSA_TEST_PASSWORD_2}"}}'
Проверить
openclaw mcp probe robokassa
Откатить
openclaw mcp unset robokassa

Источник

Korra

Проверено

Сохраните три значения в «Настройки → Ключи и доступы → Пользовательские ключи» и попросите агента подключить Робокассу — он сам выполнит команды ниже и проверит подключение. Потом отправьте в чат /reload-mcp. Главный агент может подключить сервер и другому агенту: те же команды с korra -p <имя агента>.

терминал агента
korra config set mcp_servers.robokassa.url https://mcp.robokassa.ru/mcp
korra config set mcp_servers.robokassa.headers.X-Robokassa-Login '${ROBOKASSA_LOGIN}'
korra config set mcp_servers.robokassa.headers.X-Robokassa-Test-Password-1 '${ROBOKASSA_TEST_PASSWORD_1}'
korra config set mcp_servers.robokassa.headers.X-Robokassa-Test-Password-2 '${ROBOKASSA_TEST_PASSWORD_2}'
Проверить
korra mcp test robokassa — «Подключено», 17 инструментов
Откатить
korra mcp remove robokassa

Проверено на движке Korra 0.21.15: команды, подключение, тестовый платёж. Сам диалог с агентом в чате не прогоняли. Форма «MCP → Добавить сервер» в кабинете пока принимает только Bearer-токен, поэтому для Робокассы — через агента.

Проверьте, что работает

Пробный запрос
Создай тестовый платёж Робокассы на 10 ₽ и покажи ссылку.

Что должно получиться. Ссылка на auth.robokassa.ru с IsTest=1. Ответ «Не переданы учётные данные мерчанта» значит, что переменные не дошли до агента: проверьте их и перезапустите клиент.

Что можно сделать

6 готовых сценариев. Каждый промпт можно отправить агенту после подключения.

Оплата на сайте

Кнопка «Оплатить» у заказа, обработчик уведомлений и отметка «оплачен». Проверка — тестовой оплатой.

  • start_integration даёт план и эталонный код под ваш стек: FastAPI, Django, Express, PHP.
  • calc_signature и verify_result_signature сверяют подпись с эталоном.
  • create_test_payment собирает тестовую ссылку для оплаты тестовой картой.
Промпт для агента
Промпт
Подключи приём оплаты Робокассой в этом проекте. Начни с инструмента start_integration и работай только в тестовом режиме.

1. У заказа есть кнопка «Оплатить», она ведёт на страницу оплаты с суммой и номером заказа.
2. Обработчик уведомлений (ResultURL) проверяет подпись и сумму, отмечает заказ оплаченным и отвечает OK и номер заказа. Повторное уведомление не меняет заказ второй раз.
3. После оплаты покупатель видит страницу «Спасибо», при отказе — понятный текст и кнопку «Попробовать снова».
4. Логин и пароли магазина — только в переменных окружения, их нет в коде и логах.

Сверь подпись через calc_signature, создай тестовый платёж через create_test_payment и в конце скажи, какие адреса ResultURL, SuccessURL и FailURL вписать в «Технические настройки».

Совет. Заранее посмотрите алгоритм подписи в «Технических настройках». Если там не MD5, скажите агенту — иначе подписи не сойдутся.

Совет. Уведомление приходит из интернета: для полной проверки сайт должен быть доступен снаружи. Логику обработчика агент может проверить и локально — по эталонной подписи.

Чек по 54-ФЗ

Позиции, ставка НДС и признаки расчёта в каждом платеже. Агент проверит чек по схеме Робокассы до первой оплаты.

  • get_recipe("receipt") даёт поля чека и допустимые значения.
  • validate_receipt называет ошибочное поле и допустимые варианты.
  • Чек входит в подпись — calc_signature считает её с чеком.
Промпт для агента
Промпт
Добавь к оплате Робокассой чек по 54-ФЗ. Позиции бери из заказа: название, количество, цена. Моя система налогообложения: УСН «доходы», без НДС. Если в проекте видно другое, спроси меня.

Собери чек по рецепту get_recipe("receipt") и проверь его через validate_receipt. Сумма позиций должна сходиться с суммой платежа до копейки. Пересчитай подпись с чеком через calc_signature.

Совет. Ставку НДС и систему налогообложения сверьте с бухгалтером: они должны совпадать с настройками организации.

Совет. Ошибки проверки сервер пишет по-английски, например «Input should be greater than 0». Попросите агента перевести.

Самозанятым: чеки через «Мой налог»

Для плательщика НПД подключение то же, а чеки формирует Робокасса через «Робочеки СМЗ». Агент не будет добавлять кассовый чек.

  • get_recipe("self-employed") объясняет, что меняется для НПД.
  • Интеграция — обычная: ссылка, подпись, уведомления.
Промпт для агента
Промпт
Я самозанятый. Подключи приём оплаты Робокассой в этом проекте по рецепту get_recipe("self-employed"). Работай в тестовом режиме, начни с start_integration. Не добавляй параметр Receipt и кассовый чек: чеки НПД формирует Робокасса. В конце перечисли, что мне нужно включить в личном кабинете и в «Моём налоге».

Совет. Услугу «Робочеки СМЗ» и разрешение в «Моём налоге» включаете вы сами. Следить за годовым лимитом дохода — тоже ваша задача.

Оплата в Telegram-боте

Бот присылает кнопку оплаты, сервер получает уведомление, бот сам пишет покупателю «Оплата прошла».

  • Ссылку собирает сервер бота — пароли не попадают в код клиента.
  • Свои параметры Shp_ возвращаются в уведомлении: так обработчик узнаёт, кому написать.
Промпт для агента
Промпт
В моём Telegram-боте добавь оплату через Робокассу. Работай в тестовом режиме, начни с start_integration.

1. Покупатель выбирает тариф, бот создаёт заказ и присылает кнопку со ссылкой на оплату.
2. Уведомление приходит на ResultURL моего сервера; обработчик проверяет подпись и сумму и отмечает заказ оплаченным.
3. Бот пишет покупателю, что оплата прошла, и выдаёт покупку.
4. Если оплаты нет 30 минут, заказ отменяется, бот предлагает попробовать снова.

Номер заказа передавай в InvId, chat_id покупателя — в своём параметре Shp_. Проверь подпись с Shp_ через calc_signature.

Совет. Параметры Shp_ входят в подпись в алфавитном порядке. Если подпись не сходится, начните с проверки порядка.

Оплата прошла, а заказ не отметился

Агент найдёт расхождение: формула подписи, пароль, алгоритм, порядок параметров или ответ обработчика.

  • verify_result_signature проверяет подпись тестовым паролем №2 из заголовков — пароль в чат не нужен.
  • get_recipe("errors") расшифровывает коды страницы оплаты.
Промпт для агента
Промпт
Тестовая оплата Робокассой прошла, а заказ не отметился оплаченным. Найди причину.

1. Найди обработчик ResultURL и покажи, как он считает подпись.
2. Возьми из логов последнее тестовое уведомление (OutSum, InvId, SignatureValue, Shp_) и проверь его через verify_result_signature.
3. Если подпись не сходится, сравни формулу с get_recipe("signature"): порядок полей, Shp_ по алфавиту, пароль №2, алгоритм из настроек магазина.
4. Проверь, что обработчик отвечает OK и номер заказа и что его адрес открывается из интернета.

Пароли в чат не проси и в логи не выводи.

Совет. Статус тестового платежа запросом не узнать: его видно только в уведомлении на ResultURL.

Перевод в боевой режим

Агент сверит код с чек-листом Робокассы и скажет, что сделать вам в кабинете. Боевые пароли он не спрашивает.

  • get_recipe("go-live-checklist") — чек-лист для человека: агент сверяет его с кодом, а не выполняет.
Промпт для агента
Промпт
Тестовые оплаты Робокассой работают. Подготовь перевод в боевой режим по get_recipe("go-live-checklist"). По каждому пункту скажи, что уже сделано в коде, а что нужно сделать мне в личном кабинете. Боевые пароли у меня не спрашивай: я сам впишу их в переменные окружения на сервере.

Совет. Контрольную оплату сделайте на минимальную сумму и сразу верните её через личный кабинет.

Пример работы

Задача
Проверить подключение и расчёты до первой оплаты
Запрос
Дай план подключения для Node.js, проверь чек на 990 ₽ без НДС и собери тестовую ссылку на 10 ₽.
Что сделано
  • start_integration (node-express): пошаговый план, эталонный код и чек-лист самопроверки.
  • validate_receipt: верный чек — valid: true; чек с нулевой суммой, ставкой vat18 и признаком расчёта по-русски — три ошибки с допустимыми значениями.
  • calc_signature с паролем-пустышкой: подпись совпала с нашим независимым расчётом MD5.
  • create_test_payment: ссылка на auth.robokassa.ru с IsTest=1.
  • check_payment_status с выдуманным магазином: понятный отказ «магазин не найден или не активирован».
Результат
Каждый вызов занял около 0,45 секунды. Реальных денег и настоящих паролей в проверке не было.

Korra Hub, 29.09.2026: прямые вызовы сервера 1.28.1 и подключение из Claude Code и движка Korra с ключами-пустышками.

Инструменты сервера · 17

Описания и схемы инструментов — около 21 тыс. символов, это несколько тысяч токенов контекста. Пометок «только чтение» автор не ставил: уровни ниже — по описаниям Робокассы и нашим вызовам.

  • start_integrationПлан подключения под стек проекта, эталонный код, чек-листчитает
  • get_recipeРецепты: ссылка, уведомления, чек, подпись, самозанятые, ошибки, боевой запускчитает
  • calc_signatureЭталонная подпись для сверки с вашим кодомчитает
  • verify_result_signatureПроверка подписи уведомления паролем №2 из заголовковчитает
  • validate_receiptПроверка чека по схеме до отправкичитает
  • get_payment_methodsСпособы оплаты, доступные магазинучитает
  • check_payment_statusСтатус боевой операции; тестовые платежи не видитчитает
  • list_invoicesСписок счетов магазина за периодчитает
  • get_refund_stateСостояние заявки на возвратчитает
  • create_test_paymentТестовая ссылка на оплату с IsTest=1; ветка боевого счёта выключенатестовый режим
  • deactivate_invoiceОтключает ссылку на оплату по счётуменяет
  • confirm_holdСписание зарезервированных денегвыключен
  • cancel_holdСнятие резерва с карты покупателявыключен
  • create_recurring_paymentПовторное списание по подпискевыключен
  • create_saved_card_paymentОплата сохранённой картойвыключен
  • create_split_paymentРазделение платежа между магазинамивыключен
  • create_refundВозврат денег покупателювыключен

Когда не нужен

Сайт на Tilda, WordPress или 1С-Битрикс проще подключить готовым модулем Робокассы — без кода. Сервер нужен, когда сайт или бот написан вами или агентом.

Частые проблемы

«Не переданы учётные данные мерчанта»

Заголовки не дошли до сервера: переменные заданы после запуска клиента или приложение открыто не из того терминала. Задайте три переменные, откройте клиент заново и повторите запрос.

Claude Code пишет «Missing environment variables»

Claude Code запущен без переменных ROBOKASSA_*. Задайте их в профиле терминала и откройте новую сессию: значения подставляются при запуске.

Подпись не сходится с calc_signature

Чаще всего в «Технических настройках» выбран не MD5. Скажите агенту алгоритм магазина: инструменты подписи принимают его аргументом hash_algo, а для всего подключения можно добавить заголовок X-Robokassa-Hash, например sha256.

«Магазин не найден или не активирован» (код 2 или 26)

В ROBOKASSA_LOGIN указана почта или название. Нужен идентификатор магазина из «Технических настроек».

check_payment_status не находит тестовую оплату

Так и должно быть: статус тестового платежа виден только в уведомлении на ResultURL. Проверьте, дошло ли уведомление и ответил ли обработчик OK и номер заказа.

«Боевые операции отключены»

Инструменты с реальными деньгами Робокасса выключила на сервере. Это не поломка: возвраты, холды и перевод в бой делает человек в личном кабинете.

Агент Korra или Hermes просит подтвердить правку config.yaml

Прямую правку файла Korra защищает подтверждением. Попросите агента использовать штатные команды korra config set (в Hermes — hermes config set) из вкладки: они не требуют правки файла вручную.

Безопасность и данные

Кто сделал
Робокасса, официальный сервер: адрес на её домене, ссылка на него есть в документации docs.robokassa.ru. Исходный код закрыт, поэтому мы проверяли поведение.
Что видит сервер
Идентификатор магазина и тестовые пароли из заголовков, а также суммы, номера заказов и состав чеков, которые передаёт агент. Код проекта и базу сервер не видит. Робокасса пишет, что пароли не сохраняет и в журналы не пишет.
Куда уходят данные
Робокасса, Россия
Что может изменить
С тестовыми паролями деньги не двигаются: сервер строит тестовые ссылки и считает подписи. Инструменты с реальными деньгами, по данным Робокассы, выключены на сервере по умолчанию. Код вашего проекта меняет агент — под вашим контролем.
Наша проверка
29.09.2026: версия сервера 1.28.1, 17 инструментов. Подпись совпала с независимым расчётом, тестовая ссылка собирается с IsTest=1. Описания инструментов прочитаны целиком: посторонних указаний нет, агенту прямо запрещено передавать настоящие пароли в аргументах.
Версия
Сервер удалённый, версию обновляет Робокасса. На 29.09.2026 — 1.28.1.

Что учесть

Сервер работает только в тестовом режиме. Уведомление об оплате приходит из интернета, поэтому полный путь проверяется на сайте или боте, доступном снаружи. Боевые пароли и перевод в бой — вручную, в личном кабинете.

Ещё может пригодиться

Весь Korra Hub →
Telegram MCPTelegram в инструментах агента →First Customer FinderНайти первых потенциальных клиентов →