Robokassa MCP — быстрый старт

Подключите сервер к своему ИИ-ассистенту и скажите «Интегрируй Робокассу» — приём оплаты появится в проекте, а ассистент сам проверит его на тестовой оплате.

Для подключения понадобятся магазин в Робокассе и тестовые Пароль #1 и Пароль #2 из раздела «Технические настройки» личного кабинета. Дальше — одна команда для вашего клиента.

claude mcp add --transport http robokassa \
  https://mcp.robokassa.ru/mcp \
  --header "X-Robokassa-Login: <логин>" \
  --header "X-Robokassa-Test-Password-1: <тест-пароль 1>" \
  --header "X-Robokassa-Test-Password-2: <тест-пароль 2>"

Как это работает #

Три шага. Первый делаете вы, остальные — ассистент, не выходя из редактора.

Семнадцать инструментов #

Первые пять работают без сети — это знания и точные расчёты. Остальные обращаются к API Робокассы: тестовый контур платежей плюс справочные и сервисные операции (холды, рекуррентные списания, возвраты, счета).

Сервер не даст ошибиться в деньгах

Каждая денежная операция проходит строгую проверку ещё до обращения к Робокассе: суммы — только положительные и с точностью до копейки, номер счёта — в допустимом диапазоне, сумма позиций чека обязана сходиться с суммой платежа (требование фискализации), а противоречивые цены в позициях отклоняются с понятным объяснением. Если платёжная ссылка с чеком выходит длиннее лимита браузеров — ассистент получит совет перейти на POST-форму, а не «молча обрезанный» запрос.

Подключение #

Логин — это ID вашего магазина. Найти его и сгенерировать тестовые пароли можно в личном кабинете Робокассы, в разделе «Технические настройки» вашего магазина. Ниже — конфигурация для популярных клиентов.

Claude Code

claude mcp add --transport http robokassa \
  https://mcp.robokassa.ru/mcp \
  --header "X-Robokassa-Login: <логин>" \
  --header "X-Robokassa-Test-Password-1: <тест-пароль 1>" \
  --header "X-Robokassa-Test-Password-2: <тест-пароль 2>"

Codex CLI

Добавьте сервер командой (Codex ≥ 0.146):

codex mcp add robokassa --url https://mcp.robokassa.ru/mcp

Флага для заголовков у команды нет — допишите их в ~/.codex/config.toml. Пароли лучше передавать через env_http_headers: в файле остаются только имена переменных окружения, сами значения задаёте в среде.

[mcp_servers.robokassa.http_headers]
"X-Robokassa-Login" = "<логин>"

[mcp_servers.robokassa.env_http_headers]
"X-Robokassa-Test-Password-1" = "ROBOKASSA_TEST_PASSWORD_1"
"X-Robokassa-Test-Password-2" = "ROBOKASSA_TEST_PASSWORD_2"

Cursor

Добавьте сервер в ~/.cursor/mcp.json (или в настройках MCP проекта):

{
  "mcpServers": {
    "robokassa": {
      "url": "https://mcp.robokassa.ru/mcp",
      "headers": {
        "X-Robokassa-Login": "<логин>",
        "X-Robokassa-Test-Password-1": "<тест-пароль 1>",
        "X-Robokassa-Test-Password-2": "<тест-пароль 2>"
      }
    }
  }
}

Claude Desktop

Диалог Settings → Connectors принимает только стандартные имена заголовков авторизации, поэтому заголовки X-Robokassa-* через него передать нельзя. Подключите сервер локальным мостом mcp-remote — добавьте в claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "robokassa": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://mcp.robokassa.ru/mcp",
        "--header", "X-Robokassa-Login:<логин>",
        "--header", "X-Robokassa-Test-Password-1:<тест-пароль 1>",
        "--header", "X-Robokassa-Test-Password-2:<тест-пароль 2>"
      ]
    }
  }
}

Внутри значений --header не ставьте пробел после двоеточия: Claude Desktop разбивает аргументы по пробелам. Нужен установленный Node.js; после правки конфига перезапустите приложение.

Проверить подключение

После подключения спросите ассистента: «какие инструменты Робокассы тебе доступны?» — в ответе должно быть 17 инструментов, начиная со start_integration. Затем попросите «создай тестовый платёж на 10 ₽»: успех — ссылка на оплату с IsTest=1; ошибка «Нет заголовков X-Robokassa-*» означает, что заголовки не дошли — проверьте конфигурацию клиента и перезапустите его. Ошибка TLS при корпоративном прокси — добавьте корневой сертификат вашей сети в доверенные для клиента.

Что можно попросить #

Первые четыре сценария целиком работают в тестовом контуре. Списание холда, оплата по сохранённой карте и сплитование — боевые операции: соответствующие инструменты по умолчанию выключены, их включает оператор сервера (ROBOKASSA_ALLOW_LIVE=1), а сплитование ещё и подключается по согласованию с Робокассой.

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