ЮKassa MCP
yookassa-mcp
MCP-сервер ЮKassa: платежи, возвраты, чеки по 54-ФЗ, выплаты и вебхуки прямо из диалога с агентом
Установка
claude mcp add yookassa -e YOOKASSA_SHOP_ID=your-id -e YOOKASSA_SECRET_KEY=your-key -- npx -y @theyahia/yookassa-mcpДля проверок подставьте ключи тестового магазина.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключает агента к API ЮKassa v3. Агент может создавать платежи, в том числе через СБП, сплит-платежи для маркетплейсов и рекуррентные списания по сохраненному способу оплаты, подтверждать и отменять двухстадийные платежи. Есть возвраты, фискальные чеки, выплаты на карту, в ЮMoney или через СБП, регистрация и удаление вебхуков, а также проверка режима магазина. Каждый POST-запрос получает стабильный ключ идемпотентности, поэтому повтор при сбое сети не спишет деньги дважды. Инструменты, которые двигают деньги, помечены как разрушающие, чтобы клиент спрашивал подтверждение.
Для кого. Для разработчиков и владельцев интернет-магазинов, которые принимают оплату через ЮKassa и хотят разбирать платежи и возвраты через агента.
Подходит, если
- Нужно найти платеж и сделать по нему возврат
- Нужно проверить интеграцию на тестовом магазине без написания кода
- Нужно выгрузить список успешных платежей за период
- Нужно настроить вебхуки магазина
Не подходит, если
- Нет отдельного тестового магазина, а экспериментировать приходится на боевом
- Нужна полноценная платежная интеграция в продукте, а не ручные операции через агента
Пример запроса к агенту
Покажи успешные платежи за последние 7 дней и сделай возврат 2500 рублей по платежу, который я укажуОграничения
Нужны идентификатор магазина и секретный ключ ЮKassa. Выплаты подключаются в ЮKassa отдельно и требуют своих ключей шлюза, передача номера карты без сертификата PCI DSS не допускается. В боевом магазине платежи, возвраты и выплаты необратимы. Эндпоинта баланса у ЮKassa нет. HTTP-режим требует токен и не должен смотреть в интернет без прокси с авторизацией. Сервер сделан сообществом, это не продукт ЮKassa.
Как отключить. Выполните claude mcp remove yookassa в Claude Code или удалите блок yookassa из конфигурации MCP клиента. Секретный ключ после отключения лучше перевыпустить в личном кабинете.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| YOOKASSA_SHOP_ID обязательная | Идентификатор магазина ЮKassa |
| YOOKASSA_SECRET_KEY обязательная, секрет | Секретный ключ API магазина |
| YOOKASSA_PAYOUT_AGENT_ID | Идентификатор шлюза выплат, нужен только для выплат |
| YOOKASSA_PAYOUT_SECRET_KEY секрет | Секретный ключ шлюза выплат |
| MCP_AUTH_TOKEN секрет | Обязателен в HTTP-режиме, Bearer-токен для клиентов |
Проверка безопасности
- Создает платежи, возвраты и выплаты с реальными деньгами
- Требует секретный ключ магазина
- Рекуррентные списания проходят без участия покупателя
Коротко о README
README дает конфигурации для Claude Desktop, Claude Code, VS Code, Cursor и Windsurf через npx, а также запуск в HTTP-режиме с токеном. Описаны переменные окружения, включая отдельные ключи для выплат, и порядок работы с тестовым магазином. Инструменты разбиты на платежи, возвраты, чеки, выплаты, вебхуки и аккаунт. В разделе архитектуры объяснены ключи идемпотентности, таймауты и повторы. Сервер входит в серию WWmcp автора, лицензия MIT.
Частые вопросы
Как не списать реальные деньги при проверке?
Заведите тестовый магазин в ЮKassa, подставьте его ключи и проверьте инструментом get_shop_info, что в ответе test равен true.
Можно ли запустить сервер удаленно?
Да, есть режим Streamable HTTP с Bearer-токеном. По умолчанию он слушает только localhost, выставлять его в интернет без прокси с авторизацией нельзя.
Похожие
Официальные MCP-сервер, плагины и скиллы Stripe: агент ищет по API и документации, читает и меняет данные аккаунта
Скиллы и MCP-сервер для опционных трейдеров: котировки, технический анализ, греки, спреды, сканеры и портфель Interactive Brokers
Square MCP Server
Square Model Context Protocol Server
Официальный MCP-сервер Square: агент вызывает любые методы API Square, от каталога и клиентов до заказов и платежей
CLI и скилл для доступа агента к счету Т-Инвестиций: портфель, доходность, скринеры облигаций и заявки с подтверждением