ЮKassa MCP

yookassa-mcp

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

  • 4 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

Широкий доступ

Почему такой уровень

  • Создает платежи, возвраты и выплаты с реальными деньгами
  • Требует секретный ключ магазина
  • Рекуррентные списания проходят без участия покупателя
Все причины и проверки
Российский стек

theyahia/yookassa-mcp

Установка

Сервисы

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

npx skillfoxx add mcp/yookassa-mcp

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

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

Доступ и проверки

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

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Создает платежи, возвраты и выплаты с реальными деньгами
  • Требует секретный ключ магазина
  • Рекуррентные списания проходят без участия покупателя

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

Что делает

Сервер подключает агента к API ЮKassa v3. Агент может создавать платежи, в том числе через СБП, сплит-платежи для маркетплейсов и рекуррентные списания по сохраненному способу оплаты, подтверждать и отменять двухстадийные платежи. Есть возвраты, фискальные чеки, выплаты на карту, в ЮMoney или через СБП, регистрация и удаление вебхуков, а также проверка режима магазина. Каждый POST-запрос получает стабильный ключ идемпотентности, поэтому повтор при сбое сети не спишет деньги дважды. Инструменты, которые двигают деньги, помечены как разрушающие, чтобы клиент спрашивал подтверждение.

Для кого. Для разработчиков и владельцев интернет-магазинов, которые принимают оплату через ЮKassa и хотят разбирать платежи и возвраты через агента.

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

  • Нужно найти платеж и сделать по нему возврат
  • Нужно проверить интеграцию на тестовом магазине без написания кода
  • Нужно выгрузить список успешных платежей за период
  • Нужно настроить вебхуки магазина

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

  • Нет отдельного тестового магазина, а экспериментировать приходится на боевом
  • Нужна полноценная платежная интеграция в продукте, а не ручные операции через агента

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

Покажи успешные платежи за последние 7 дней и сделай возврат 2500 рублей по платежу, который я укажу

MCP

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

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

YOOKASSA_SHOP_ID обязательная
Идентификатор магазина ЮKassa
YOOKASSA_SECRET_KEY обязательная, секрет
Секретный ключ API магазина
YOOKASSA_PAYOUT_AGENT_ID
Идентификатор шлюза выплат, нужен только для выплат
YOOKASSA_PAYOUT_SECRET_KEY секрет
Секретный ключ шлюза выплат
MCP_AUTH_TOKEN секрет
Обязателен в HTTP-режиме, Bearer-токен для клиентов

Ограничения

Нужны идентификатор магазина и секретный ключ ЮKassa. Выплаты подключаются в ЮKassa отдельно и требуют своих ключей шлюза, передача номера карты без сертификата PCI DSS не допускается. В боевом магазине платежи, возвраты и выплаты необратимы. Эндпоинта баланса у ЮKassa нет. HTTP-режим требует токен и не должен смотреть в интернет без прокси с авторизацией. Сервер сделан сообществом, это не продукт ЮKassa.

Как отключить. Выполните claude mcp remove yookassa в Claude Code или удалите блок yookassa из конфигурации MCP клиента. Секретный ключ после отключения лучше перевыпустить в личном кабинете.

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

Как не списать реальные деньги при проверке?

Заведите тестовый магазин в ЮKassa, подставьте его ключи и проверьте инструментом get_shop_info, что в ответе test равен true.

Можно ли запустить сервер удаленно?

Да, есть режим Streamable HTTP с Bearer-токеном. По умолчанию он слушает только localhost, выставлять его в интернет без прокси с авторизацией нельзя.

Обсуждение

Вопросов и отзывов пока нет.

Официальный

Официальный MCP ЮKassa: агент создает ссылки на оплату и счета, проверяет статусы и возвраты, но сам деньги не переводит

MCP-серверШирокий доступ

ЮKassa: агент технической интеграции для Codex

ЮKassa: ИИ-агент технической интеграции для Codex

Российский стек

Плагин Codex с пятью скиллами и тринадцатью read-only MCP-инструментами для интеграции ЮKassa: проектирование, код, чеки, диагностика, ревью

ПлагинШирокий доступ
Российский стек

Монорепозиторий MCP-серверов для российских сервисов и API стран СНГ: платежи, CRM, маркетплейсы, доставка, HR и справочные данные

MCP-серверШирокий доступ36Звезды репозитория

Скилл ЮKassa

Yookassa Skill

Российский стек

Справочный скилл для интеграции ЮKassa: API v3, SDK для TypeScript, одностадийные и двухстадийные платежи, вебхуки и 54-ФЗ

СкиллМинимальный доступ
Российский стек

Набор скиллов для операционки малого бизнеса в России: УСН, денежный поток, дебиторка, договоры, найм и проверка контрагента по ИНН

ПлагинРасширенный доступ29Звезды репозитория
Российский стек

Открытый исходный код SaaS на Next.js: по краткому брифу Claude пишет заголовок, описание и буллиты карточки для Wildberries, Ozon и Amazon

ВоркфлоуМинимальный доступ

Коротко о README

README дает конфигурации для Claude Desktop, Claude Code, VS Code, Cursor и Windsurf через npx, а также запуск в HTTP-режиме с токеном. Описаны переменные окружения, включая отдельные ключи для выплат, и порядок работы с тестовым магазином. Инструменты разбиты на платежи, возвраты, чеки, выплаты, вебхуки и аккаунт. В разделе архитектуры объяснены ключи идемпотентности, таймауты и повторы. Сервер входит в серию WWmcp автора, лицензия MIT.

Бейдж для README

Сообщить о проблеме

Foxx AIЮKassa MCP
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.