Быстрый старт
Эта статья поможет вам подключить MCP-сервер ЮKassa и создать первый платеж с помощью AI-агента.
В статье описан самый простой сценарий работы. Подробные настройки для разных AI-платформ — в разделе Подключение и настройка.
Подготовка
Подготовка к проведению платежей через MCP-сервер состоит из четырех этапов:
Подготовьте магазин
Для работы понадобится магазин ЮKassa. Если у вас уже есть магазин, можно использовать его: отдельный магазин для MCP-сервера не нужен. Если магазина пока нет, зарегистрируйтесь в ЮKassa и создайте тестовый или настоящий магазин.
Тестовый магазин подойдет, если вы хотите проверить сценарий без реальных платежей. Настоящий магазин используйте, если готовы принимать оплату от пользователей.
В тестовом магазине оплата проходит так же, как в настоящем магазине: AI-агент выбирает инструмент создания платежа, AI-платформа вызывает MCP-сервер ЮKassa, MCP-сервер создает платеж и возвращает ссылку, а пользователь переходит на страницу оплаты и подтверждает платеж. Во время тестирования можно проверить оплату банковской картой и из кошелька ЮMoney. Создание и оплата счетов в тестовом магазине недоступны. Подробнее о тестировании
Выпустите токен
После создания тестового или настоящего магазина выпустите токен для доступа к MCP-серверу. Для этого в личном кабинете перейдите в раздел Интеграция — Доступы к магазину, укажите описание и срок действия токена, затем подтвердите выпуск.
ЮKassa покажет значение токена один раз. Сразу сохраните его в хранилище секретов или переменной окружения: после закрытия окна посмотреть токен снова не получится.
Если в разделе Интеграция — Доступы к магазину отсутствует блок Токены для MCP-сервера, проверьте, отключена ли отправка чеков в разделе Настройки — Онлайн-касса. При создании платежа или счета через MCP-сервер нельзя передавать данные для отправки чеков.
Если вы тестировали MCP-сервер в тестовом магазине, перед приемом реальных платежей удалите из конфигурации AI-платформы настройки с токеном тестового магазина и добавьте настройки с токеном настоящего магазина. Это нужно, чтобы AI-агент по ошибке не создал тестовый платеж для реального пользователя.
Подключите MCP-сервер
Добавьте MCP-сервер ЮKassa в настройки AI-платформы:
URL MCP-сервера
https://mcp.yookassa.ru
Значение заголовка Authorization
Bearer <ваш токен для MCP-сервера>
Не добавляйте значение токена в публично доступный файл или файл, который добавляется в репозиторий. Используйте обращение к переменной окружения или хранилищу секретов. Примеры настройки AI-платформ
Проверьте подключение
Откройте список MCP-серверов или инструментов в AI-платформе и проверьте, что MCP-сервер ЮKassa подключен. Если платформа позволяет обращаться к AI-агенту в чате, напишите AI-агенту:
Покажи, какие инструменты доступны в MCP-сервере ЮKassa.
В настоящем магазине должны быть доступны инструменты создания платежа и счета, получения информации о платеже, счете и возврате, получения списков платежей и возвратов. В тестовом магазине операции со счетами недоступны.
AI-платформа запрашивает список инструментов с помощью
tools/list автоматически. Вручную отправлять JSON-RPC-запрос не нужно.Шаг 1. Создайте платеж
Напишите AI-агенту:
Создай платеж на 10 рублей. Описание платежа: Тест оплаты через MCP. Верни идентификатор платежа, статус, сумму, описание и ссылку на страницу оплаты.
AI-агент выберет инструмент
create_payment, а AI-платформа передаст сумму и описание MCP-серверу ЮKassa. В ответ MCP-сервер вернет идентификатор платежа, статус, сумму, описание и ссылку на страницу оплаты. Если AI-агент попросит подтвердить действие или уточнить данные, проверьте сумму и описание, а затем подтвердите создание платежа.Результат работы зависит от модели и ее настроек. В некоторых случаях AI-агент может показать только часть полученных данных. Если в ответе нет идентификатора платежа, напишите AI-агенту:
Покажи идентификатор созданного платежа.
Шаг 2. Перейдите на страницу оплаты
Откройте ссылку, которую вернул AI-агент. На странице ЮKassa проверьте сумму и описание, выберите способ оплаты и подтвердите платеж.
Если вы проводите платеж в настоящем магазине, деньги будут списаны, когда пользователь подтвердит оплату и платеж перейдет в статус
succeeded. Если вы проводите платеж в тестовом магазине, используйте для оплаты кошелек ЮMoney или тестовые банковские карты — деньги не спишутся.Шаг 3. Проверьте статус платежа
После оплаты напишите AI-агенту:
Проверь статус платежа с идентификатором <идентификатор платежа>.
Вместо
<идентификатор платежа> укажите идентификатор, который вернул AI-агент при создании платежа.AI-агент выберет инструмент
get_payment, AI-платформа отправит запрос MCP-серверу ЮKassa, а затем агент вернет вам актуальную информацию о платеже в чате.Платеж можно считать успешным, как только он перешел в статус
succeeded. Если платеж перешел в статус canceled, проверьте причину отмены. Подробнее о неуспешных платежах Также платеж можно найти на странице Платежи в личном кабинете и посмотреть его детали.Готово! Вы создали первый платеж с помощью MCP-сервера ЮKassa.
Если вы использовали тестовый магазин, перед приемом реальных платежей удалите тестовый токен из конфигурации AI-платформы и подключите MCP-сервер с токеном настоящего магазина.
Дальше вы можете перейти к использованию MCP-сервера или изучить подробную инструкцию по подключению и настройке для разных AI-платформ.
Что почитать еще