Что агент умеет с платежами ЮKassa
Инструменты для ЮKassa делятся на три группы: серверы, которые работают с API магазина, помощники разработчика и наборы, где касса одна из многих интеграций.
- MCP-сервер ЮKassa от самой ЮKassa формирует счета и ссылки на оплату, проверяет статус платежа, получает данные о возвратах и выгружает список операций. Ключ для него выпускается в личном кабинете и отзывается там же в один клик.
- ЮKassa MCP от сообщества работает с API v3 шире: платежи через СБП, сплит-платежи, рекуррентные списания, подтверждение и отмена двухстадийных платежей, чеки, выплаты и вебхуки.
- Плагин технической интеграции для Codex дает 5 скиллов и 13 инструментов только на чтение: проектирование платежного флоу, код, проверка чеков по 54-ФЗ, диагностика и ревью безопасности.
- Скилл ЮKassa состоит из документации по REST API v3 и примеров на TypeScript с SDK @a2seven/yoo-checkout. Запросов к API он не делает.
- Скилл переезда с Lovable на Cloud.ru настраивает прием платежей YooKassa с перепроверкой статуса вебхука, а small-business-ru подключает кассу по желанию и без нее работает по выгрузкам CSV.
Ключи API ЮKassa и тестовый магазин
API ЮKassa принимает HTTP Basic Auth. Логин равен shopId из раздела «Настройки» личного кабинета, пункт «Магазин». Пароль равен секретному ключу со страницы «Ключи API» в разделе «Интеграция». Ключ активируют паролем из СМС. Для выплат нужны отдельный agentId шлюза и свой ключ.
Тестовый магазин добавляется в том же личном кабинете и появляется в списке в течение 1 минуты. Всего их можно завести 20. Деньги в нем не переводятся, у платежа стоит признак test со значением true. Доступны только банковская карта и кошелек ЮMoney. Для карт в документации есть тестовые номера. Выставление счетов в тестовом магазине недоступно, поэтому часть функций официального MCP проверить на нем не получится.
Серверу сообщества хватит npx skillfoxx add mcp/yookassa-mcp и ключей тестового магазина в окружении. У официального MCP нет публичного адреса: ключ и адрес подключения выдаются в кабинете магазина.
Выбор между официальным MCP и сервером сообщества
Продавцу, которому нужно выставлять счета и проверять оплаты без входа в кабинет, подходит официальный сервер. По заявлению ЮKassa он только готовит сценарий платежа, а полного списка инструментов в открытых источниках пока нет.
Разработчику интеграции безопаснее плагин для Codex: его диагностика проверяет признак test=true и блокируется, если магазин не подтвержден как тестовый. Сервер сообщества нужен там, где агент сам ведет возвраты, выплаты и вебхуки, и у него широкий доступ.
Минимальный доступ у справочного скилла и генератора карточек, где касса нужна только для подписки. У small-business-ru расширенный, у остальных инструментов широкий. VPN не нужен ни одному инструменту. По генератору карточек таких данных нет. Серверы Т-Кассы и CloudPayments входят в монорепозиторий WWmcp. Другие платежные сервисы собраны на странице российского стека.
Риски платежного агента
В боевом магазине платежи, возвраты и выплаты необратимы, а рекуррентное списание проходит без участия покупателя. Сервер сообщества передает каждому POST-запросу ключ идемпотентности, поэтому повтор при сбое сети не спишет деньги дважды. ЮKassa гарантирует идемпотентность 24 часа для ключа длиной до 64 символов.
Передавать номер карты без сертификата PCI DSS нельзя. HTTP-режим сервера сообщества требует токен и не должен смотреть в интернет без прокси с авторизацией. Проверка чеков в плагине для Codex не заменяет юриста, бухгалтера или специалиста по ККТ.
Выпустите для агента отдельный ключ, начните с тестового магазина и переходите на боевой после проверки поведения агента.