MCP-сервер ЮKassa: платежи и счета в Codex, Claude Code и Cursor

yookassa/yookassa-mcp· Проверено 12.11.2026· 32на GitHub

Агент создаёт платёжные ссылки и счета ЮKassa, проверяет платежи и смотрит возвраты прямо в чате. Сторонние серверы добавляют возвраты, чеки 54-ФЗ, выплаты и проверку интеграции.

3 реализации:

Удалённый сервер на стороне ЮKassa по MCP-токену магазина: платежи, счета, чтение платежей и возвратов; разворачивать и ставить ничего не нужно.

Как подключить

Что сделать до подключения

Магазин в ЮKassa; для знакомства — тестовый магазин

MCP-токен в переменной окружения YOOKASSA_MCP_TOKEN, видимой процессу агента

YOOKASSA_MCP_TOKEN

личный кабинет ЮKassa → Интеграция → Доступы к магазину → Токены для MCP-сервера → выпустить токен; доступно Владельцу и Управляющему, значение показывается один раз; shopId и секретный ключ API не подходят

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport http yukassa https://mcp.yookassa.ru \
  --header 'Authorization: Bearer <MCP-токен ЮKassa>'

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.yukassa]
url = "https://mcp.yookassa.ru"
http_headers = { "Authorization" = "Bearer <MCP-токен ЮKassa>" }

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "yukassa": {
      "url": "https://mcp.yookassa.ru",
      "headers": {
        "Authorization": "Bearer <MCP-токен ЮKassa>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "yukassa": {
      "type": "http",
      "url": "https://mcp.yookassa.ru",
      "headers": {
        "Authorization": "Bearer <MCP-токен ЮKassa>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "yukassa": {
      "httpUrl": "https://mcp.yookassa.ru",
      "headers": {
        "Authorization": "Bearer <MCP-токен ЮKassa>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "yukassa": {
      "httpUrl": "https://mcp.yookassa.ru",
      "headers": {
        "Authorization": "Bearer <MCP-токен ЮKassa>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "yukassa": {
        "type": "remote",
        "url": "https://mcp.yookassa.ru",
        "headers": {
          "Authorization": "Bearer <MCP-токен ЮKassa>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

Customize → Connectors → добавить свой коннектор.
Адрес сервера: https://mcp.yookassa.ru
Request headers: Authorization: Bearer <MCP-токен ЮKassa>

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "yukassa": {
      "url": "https://mcp.yookassa.ru",
      "headers": {
        "Authorization": "Bearer <MCP-токен ЮKassa>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

create_paymentсоздаёт платёж и ссылку на оплату

get_paymentпроверяет платёж по ID

get_payments_listвыводит платежи с фильтрами

create_invoiceвыставляет счёт

get_invoiceпроверяет счёт

get_refundпоказывает возврат

get_refunds_listвыводит список возвратов

Пакет npm по ключу API магазина с 20 инструментами: возвраты, чеки 54-ФЗ, СБП, рекуррентные и двухстадийные платежи, сплит, выплаты и вебхуки.

Как подключить

Что сделать до подключения

Node.js с командой npx

ID магазина и секретный ключ ЮKassa; на время разработки — от тестового магазина

YOOKASSA_SHOP_ID

ЮKassa → Настройки → Магазин

YOOKASSA_SECRET_KEY

ЮKassa → Интеграция → Ключи API

YOOKASSA_PAYOUT_AGENT_ID

для выплат: ID шлюза продукта «Выплаты», Настройки → Выплаты

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'YOOKASSA_SHOP_ID=<ID магазина>' --env 'YOOKASSA_SECRET_KEY=<секретный ключ>' --transport stdio yookassa-mcp \
  -- npx -y @theyahia/yookassa-mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.yookassa-mcp]
command = "npx"
args = ["-y", "@theyahia/yookassa-mcp"]

[mcp_servers.yookassa-mcp.env]
YOOKASSA_SHOP_ID = "<ID магазина>"
YOOKASSA_SECRET_KEY = "<секретный ключ>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "yookassa-mcp": {
      "command": "npx",
      "args": ["-y", "@theyahia/yookassa-mcp"],
      "env": {
        "YOOKASSA_SHOP_ID": "<ID магазина>",
        "YOOKASSA_SECRET_KEY": "<секретный ключ>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "yookassa-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@theyahia/yookassa-mcp"],
      "env": {
        "YOOKASSA_SHOP_ID": "<ID магазина>",
        "YOOKASSA_SECRET_KEY": "<секретный ключ>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "yookassa-mcp": {
      "command": "npx",
      "args": ["-y", "@theyahia/yookassa-mcp"],
      "env": {
        "YOOKASSA_SHOP_ID": "<ID магазина>",
        "YOOKASSA_SECRET_KEY": "<секретный ключ>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "yookassa-mcp": {
      "command": "npx",
      "args": ["-y", "@theyahia/yookassa-mcp"],
      "env": {
        "YOOKASSA_SHOP_ID": "<ID магазина>",
        "YOOKASSA_SECRET_KEY": "<секретный ключ>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "yookassa-mcp": {
        "type": "local",
        "command": ["npx", "-y", "@theyahia/yookassa-mcp"],
        "environment": {
          "YOOKASSA_SHOP_ID": "<ID магазина>",
          "YOOKASSA_SECRET_KEY": "<секретный ключ>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "yookassa-mcp": {
      "command": "npx",
      "args": ["-y", "@theyahia/yookassa-mcp"],
      "env": {
        "YOOKASSA_SHOP_ID": "<ID магазина>",
        "YOOKASSA_SECRET_KEY": "<секретный ключ>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "yookassa-mcp": {
      "command": "npx",
      "args": ["-y", "@theyahia/yookassa-mcp"],
      "env": {
        "YOOKASSA_SHOP_ID": "<ID магазина>",
        "YOOKASSA_SECRET_KEY": "<секретный ключ>"
      }
    }
  }
}

Инструменты сервера

create_paymentсоздаёт платёж со ссылкой

get_paymentчитает платёж

capture_paymentсписывает удержанные деньги

cancel_paymentотменяет платёж

list_paymentsвыводит платежи с фильтрами

create_sbp_paymentсоздаёт платёж через СБП

save_payment_methodпривязывает карту для списаний

create_recurring_paymentсписывает по сохранённой карте

create_split_paymentделит платёж между партнёрами

create_refundделает возврат

list_refundsвыводит возвраты

create_receiptсоздаёт чек 54-ФЗ

create_payoutделает выплату

create_webhookрегистрирует вебхук

get_shop_infoпоказывает магазин и тестовый режим

Показано 15 из 20.

Плагин для Codex со skills и 13 инструментами только на чтение: поиск по документации и OpenAPI, проверка запросов без отправки, диагностика тестового магазина.

Как подключить

Что сделать до подключения

Для Codex: codex plugin marketplace add Belolipetsky/YooKassa-MCP --ref main и codex plugin add yookassa-integration-agent@yookassa

Для других клиентов: склонировать репозиторий, собранный server/dist/index.js лежит в git

YOOKASSA_SHOP_ID

необязательно: shopId тестового магазина для живой диагностики

YOOKASSA_SECRET_KEY

необязательно: секретный ключ тестового магазина

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'YOOKASSA_SHOP_ID=<shopId тестового магазина>' --env 'YOOKASSA_SECRET_KEY=<секретный ключ тестового магазина>' --transport stdio yookassa-mcp \
  -- node /path/to/YooKassa-MCP/plugins/yookassa-integration-agent/server/dist/index.js

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.yookassa-mcp]
command = "node"
args = ["/path/to/YooKassa-MCP/plugins/yookassa-integration-agent/server/dist/index.js"]

[mcp_servers.yookassa-mcp.env]
YOOKASSA_SHOP_ID = "<shopId тестового магазина>"
YOOKASSA_SECRET_KEY = "<секретный ключ тестового магазина>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "yookassa-mcp": {
      "command": "node",
      "args": [
        "/path/to/YooKassa-MCP/plugins/yookassa-integration-agent/server/dist/index.js"
      ],
      "env": {
        "YOOKASSA_SHOP_ID": "<shopId тестового магазина>",
        "YOOKASSA_SECRET_KEY": "<секретный ключ тестового магазина>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "yookassa-mcp": {
      "type": "stdio",
      "command": "node",
      "args": [
        "/path/to/YooKassa-MCP/plugins/yookassa-integration-agent/server/dist/index.js"
      ],
      "env": {
        "YOOKASSA_SHOP_ID": "<shopId тестового магазина>",
        "YOOKASSA_SECRET_KEY": "<секретный ключ тестового магазина>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "yookassa-mcp": {
      "command": "node",
      "args": [
        "/path/to/YooKassa-MCP/plugins/yookassa-integration-agent/server/dist/index.js"
      ],
      "env": {
        "YOOKASSA_SHOP_ID": "<shopId тестового магазина>",
        "YOOKASSA_SECRET_KEY": "<секретный ключ тестового магазина>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "yookassa-mcp": {
      "command": "node",
      "args": [
        "/path/to/YooKassa-MCP/plugins/yookassa-integration-agent/server/dist/index.js"
      ],
      "env": {
        "YOOKASSA_SHOP_ID": "<shopId тестового магазина>",
        "YOOKASSA_SECRET_KEY": "<секретный ключ тестового магазина>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "yookassa-mcp": {
        "type": "local",
        "command": [
          "node",
          "/path/to/YooKassa-MCP/plugins/yookassa-integration-agent/server/dist/index.js"
        ],
        "environment": {
          "YOOKASSA_SHOP_ID": "<shopId тестового магазина>",
          "YOOKASSA_SECRET_KEY": "<секретный ключ тестового магазина>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "yookassa-mcp": {
      "command": "node",
      "args": [
        "/path/to/YooKassa-MCP/plugins/yookassa-integration-agent/server/dist/index.js"
      ],
      "env": {
        "YOOKASSA_SHOP_ID": "<shopId тестового магазина>",
        "YOOKASSA_SECRET_KEY": "<секретный ключ тестового магазина>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "yookassa-mcp": {
      "command": "node",
      "args": [
        "/path/to/YooKassa-MCP/plugins/yookassa-integration-agent/server/dist/index.js"
      ],
      "env": {
        "YOOKASSA_SHOP_ID": "<shopId тестового магазина>",
        "YOOKASSA_SECRET_KEY": "<секретный ключ тестового магазина>"
      }
    }
  }
}

Инструменты сервера

yookassa_search_documentationищет по документации

yookassa_api_searchищет метод API

yookassa_api_detailsпоказывает детали метода

yookassa_validate_requestпроверяет запрос по OpenAPI

yookassa_explain_errorобъясняет ошибку

yookassa_diagnose_connectionпроверяет связь с магазином

yookassa_get_paymentчитает платёж

yookassa_list_refundsвыводит возвраты

yookassa_list_receiptsвыводит чеки

Показано 9 из 13.

Что попросить агента

«Создай тестовый платёж на 10.00 RUB, описание «Тест оплаты через MCP»; верни ID, сумму, статус и ссылку на оплату»Агент вызовет create_payment

«Проверь через get_payment платёж <ID>: текущий статус и сумма»Агент вызовет get_payment

«Покажи успешные платежи за вчера по московскому времени, получи все страницы и посчитай сумму по каждой валюте»Агент вызовет get_payments_list с фильтрами и пройдёт все страницы

«Найди возвраты по платежу <ID> и покажи их статусы и суммы»Агент вызовет get_refunds_list

«Создай платёж на 5000 рублей по заказу #123 со способом оплаты СБП»theYahia/yookassa-mcp вызовет create_sbp_payment

Для каких задач

Создать платёж и получить ссылку на оплату

Выставить счёт клиенту

Найти успешные платежи за вчера и посчитать сумму по валютам

Посмотреть возвраты по платежу и их статусы

Сделать возврат, выплату или фискальный чек по 54-ФЗ

Проверить JSON платежа и чека по OpenAPI до отправки

Ограничения

Сервер ЮKassa не создаёт возвраты и не берёт на себя чеки, автоплатежи, двухстадийные платежи, выплаты, сплитование и «Безопасную сделку»

В тестовом магазине у сервера ЮKassa недоступны операции со счетами

theYahia/yookassa-mcp в боевом магазине двигает реальные деньги, платежи, возвраты и выплаты необратимы; у проекта 4 звезды

Belolipetsky/YooKassa-MCP — плагин с 0 звёзд, работает только на чтение и только с тестовым магазином

Если не работает

Ошибка авторизации на mcp.yookassa.ru

Проверьте, что MCP-токен действует и не отозван, что процесс агента видит переменную и что используется синтаксис переменных именно вашего клиента.

Сервер ЮKassa не появился в клиенте

Проверьте, что запись добавлена в нужный файл настроек, и начните новую сессию агента.

Подключение есть, а нужного инструмента нет

Запросите текущий список инструментов и проверьте тип магазина и ограничения MCP: часть операций сервер не поддерживает.

Не получается работать со счетами

В тестовом магазине операции со счетами недоступны: подключите токен настоящего магазина.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
MCP-сервер ЮKassaразработчик сервиса	ЮKassa	32	HTTP	токен	7	30 октября 2026
@theyahia/yookassa-mcp	theYahia	4	локально	токен	20	3 сентября 2026
ЮKassa: ИИ-агент технической интеграции	Belolipetsky	0	локально	токен	13	29 июля 2026

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

Чем отличаются три сервера ЮKassa?

Сервер ЮKassa удалённый и работает по MCP-токену: платежи, счета, чтение платежей и возвратов. theYahia/yookassa-mcp работает по ключу API и умеет больше, включая возвраты, чеки и выплаты. Belolipetsky/YooKassa-MCP помогает писать интеграцию и ничего не проводит.

Как проверить подключение?

Напишите агенту: «Покажи инструменты подключенного MCP-сервера ЮKassa. Ничего не создавай и не изменяй». Для настоящего магазина сервер ЮKassa сейчас отдаёт семь инструментов.

Ссылка на оплату значит, что клиент заплатил?

Нет. Успех подтверждает только статус succeeded, полученный при проверке платежа через get_payment.

Как не провести платёж в боевом магазине по ошибке?

Для theYahia/yookassa-mcp возьмите ключи тестового магазина и вызовите get_shop_info: должно быть "test": true. Платёжные инструменты помечены как разрушающие, клиент спросит подтверждение. Плагин Belolipetsky при test=false блокирует работу.

Почему агент не видит токен?

Переменная должна быть доступна процессу агента: export в терминале не передаётся в уже открытое приложение, файл .env сам по себе загрузку не гарантирует. Запускайте агент из того же терминала.

Как подключить ЮKassa MCP к Codex?

Выполните codex mcp add yookassa --url https://mcp.yookassa.ru --bearer-token-env-var YOOKASSA_MCP_TOKEN или добавьте в ~/.codex/config.toml url и bearer_token_env_var. Codex сам подставит Bearer к значению переменной.

Как подключить ЮKassa MCP к Claude Code?

В каталоге проекта выполните claude mcp add-json yookassa '{"type":"http","url":"https://mcp.yookassa.ru","headers":{"Authorization":"Bearer ${YOOKASSA_MCP_TOKEN}"}}', затем запустите claude из терминала с токеном и проверьте сервер через /mcp.

Работает ли сервер из России?

Нужен магазин в ЮKassa; сервер ЮKassa работает на её стороне, сторонние серверы запускаются у вас и ходят в API ЮKassa.

MCP-сервер ЮKassa: платежи и счета в Codex, Claude Code и Cursor

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

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

Похожие серверы