Вкратце
Коммерческий MCP-сервер с размещением на нашей стороне для интеграции ЮKassa в AI-агентов: создание платежей, проверка статусов, рекуррентные списания, возвраты, выплаты на карты. Сначала тестовый режим, полный журнал аудита.
Пример в чате
Интерактивный пример: переключайте инструменты слева, «Полный сценарий» — диалог в два шага (тестовый платёж 1000 ₽ (sandbox) — демо-данные, не живой ответ).
Источник данных: ЮKassa . Atomno MCP не аффилирован с провайдером.
Установка
Один сниппет — поддержка Cursor, Claude Desktop, Claude Code, Cline, Continue.
Добавьте в ~/.cursor/mcp.json (или .cursor/mcp.json в проекте):
{
"mcpServers": {
"atomno-yukassa": {
"command": "uvx",
"args": ["atomno-mcp-yukassa"],
"env": {
"MCP_YUKASSA_API_KEY": "<your-value>",
"MCP_YUKASSA_SHOP_ID": "<your-value>"
}
}
}
}
Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"atomno-yukassa": {
"command": "uvx",
"args": ["atomno-mcp-yukassa"],
"env": {
"MCP_YUKASSA_API_KEY": "<your-value>",
"MCP_YUKASSA_SHOP_ID": "<your-value>"
}
}
}
}В терминале (Claude Code CLI):
claude mcp add atomno-yukassa -- uvx atomno-mcp-yukassa -e MCP_YUKASSA_API_KEY=<your-value> -e MCP_YUKASSA_SHOP_ID=<your-value>
Для Cline (VS Code) — в cline_mcp_settings.json.
Для Continue — в ~/.continue/config.yaml:
{
"mcpServers": {
"atomno-yukassa": {
"command": "uvx",
"args": ["atomno-mcp-yukassa"],
"env": {
"MCP_YUKASSA_API_KEY": "<your-value>",
"MCP_YUKASSA_SHOP_ID": "<your-value>"
}
}
}
}Конфигурация (переменные окружения)
| Переменная | Описание | Где взять | Required | Default |
|---|---|---|---|---|
| MCP_YUKASSA_API_KEY | API key Atomno MCP hosted MCP | Sales-команда (после demo) | yes | — |
| MCP_YUKASSA_SHOP_ID | Shop ID в ЮKassa | Личный кабинет ЮKassa → Настройки → Магазин | yes | — |
| MCP_YUKASSA_MODE | Режим работы: sandbox или production | — | no | sandbox |
Инструменты MCP-сервера
Сервер регистрирует 5 инструментов для AI-агента. Все входные данные строго проверяются.
create_payment async tool Создание платежа.
amount: int, currency: str, description: str, return_url?: str Payment { id, status, confirmation_url, amount } get_payment_status async tool Статус платежа.
payment_id: str PaymentStatus { id, status, paid_at?, error? } create_recurrent async tool Создание рекурентного списания.
payment_method_id: str, amount: int, description: str Payment create_refund async tool Возврат платежа.
payment_id: str, amount?: int Refund create_payout async tool Выплата на карту физлица.
amount: int, recipient_card: str, description: str Payout Тарифы и доступ
mcp-yukassa — коммерческая интеграция: размещение на нашей стороне или установка в вашем контуре. Публичных самостоятельных тарифов нет — стоимость рассчитываем индивидуально после демо.
mcp-yukassa
По лицензии · фаза 2Платежи через ЮKassa из AI-агентов: создание, статусы, рекуренты, payout.
Размещение на нашей стороне или установка в вашем контуре. Стоимость — индивидуальный расчёт после обсуждения нагрузки и интеграции.
Общие условия для коммерческих MCP — на странице Тарифы → B2B.
Примеры использования
Реальные запросы для AI-агента в Cursor / Claude Code:
- create_payment: «Используй mcp-yukassa инструмент
create_paymentи создание платежа.» - get_payment_status: «Используй mcp-yukassa инструмент
get_payment_statusи статус платежа.» - create_recurrent: «Используй mcp-yukassa инструмент
create_recurrentи создание рекурентного списания.»
Решение проблем
1. uvx не найден
Установите uv: pipx install uv (или pip install uv).
После этого uvx доступен в PATH.
2. MCP не подцепился в Cursor
Проверьте: ~/.cursor/mcp.json — валидный JSON. Перезапустите Cursor полностью
(Quit, не просто закрытие окна). В Settings → MCP должна появиться зелёная точка.
3. Ошибка авторизации (401 / 403)
Проверьте переменные окружения MCP_YUKASSA_API_KEY, MCP_YUKASSA_SHOP_ID.
Они должны быть доступны в окружении процесса Cursor (часто требует перезапуска IDE
после установки переменных).
Полное руководство по решению проблем → /docs/troubleshooting
FAQ
Как установить mcp-yukassa? +
Какой Python нужен? +
Что нужно настроить перед запуском? +
Это открытый код? +
Где сообщить об ошибке? +
Запросить демо
mcp-yukassa — коммерческий сервер с размещением на нашей стороне. Тестовый доступ для разработки бесплатный. Боевой доступ — после демо и обсуждения нагрузки.
Changelog
Версия пока не опубликована — проект в активной разработке. Полная история — GitHub Releases.
Исходный код и задачи
- GitHub: atomno-mcp/mcp-yukassa
- Issues: atomno-mcp/mcp-yukassa/issues
- Discussions: atomno-mcp/mcp-yukassa/discussions
Правовая оговорка
Atomno MCP не аффилирован с ЮKassa. mcp-yukassa использует публичные / коммерческие интерфейсы источника. Ответственность за соблюдение лимитов и условий использования источника — на пользователе. Лицензия: Коммерческая (Atomno MCP).