Использование MCP-сервера ЮKassa
В этой статье описано, как подготовить сценарии работы с MCP-сервером ЮKassa и использовать его для типовых задач: создания платежа, получения списка платежей, получения информации о возврате, выставления счета по данным внешней системы и оплаты из чата на сайте. Подробнее о возможностях MCP-сервера ЮKassa
Перед использованием MCP-сервера
Перед началом работы с MCP-сервером рекомендуется определить, как агент будет получать данные, какие проверки выполнять и в каком формате возвращать результат. Для простых операций достаточно запроса в чате, а для процессов с CRM, каталогом или другими MCP-серверами лучше заранее описать источники данных, ограничения и правила безопасности.
Подготовка сценария
Для простой операции достаточно подключить MCP-сервер и сформулировать задачу в чате. Например, вы можете попросить AI-агента создать платеж, получить информацию о платеже или возврате, показать список платежей за определенный период.
Если AI-агент участвует в более сложном процессе, добавьте инструкции, навык (скилл) или логику на своей стороне. Так можно задать источники данных, порядок проверок, ограничения и формат ответа. Например, перед созданием счета агент может получить данные из CRM, проверить товары по каталогу и запросить недостающую информацию.
ЮKassa не проверяет данные о товарах и услугах, не хранит каталог товаров и не сверяет сумму счета со стоимостью позиций из ваших внутренних систем. Результат выполнения операций зависит от модели, которая используется в AI-агенте, ее настроек и переданного контекста. Перед отправкой пользователю ссылки на оплату проверяйте сумму и другие обязательные данные платежа или счета, а также описание, если оно было указано.
Использование с внешними системами и другими MCP-серверами
MCP-сервер ЮKassa можно использовать как единственный внешний инструмент агента или вместе с MCP-серверами других систем. Например, если вы настроили агенту доступ к CRM или каталогу, агент может взять оттуда данные и выбрать инструмент MCP-сервера ЮKassa для создания платежа или счета. MCP-сервер ЮKassa не подключается к CRM, каталогу или другим вашим системам и не проверяет данные в них.
Если у агента подключено несколько MCP-серверов, в сообщении можно явно указать, что нужно использовать MCP-сервер ЮKassa:
Создай платеж через MCP-сервер ЮKassa на 2500 рублей. Описание платежа: Онлайн-консультация. Верни в ответе идентификатор платежа, сумму, описание, статус и ссылку на оплату.
Перед использованием сторонних сервисов убедитесь, что выбранный MCP-сервер соответствует вашим требованиям к безопасности и обработке данных. Используйте разные данные для аутентификации каждого сервера и передавайте агенту только данные, которые нужны для выбранного сценария.
Создание платежа в чате с AI-агентом
Этот сценарий подходит, если вы общаетесь с пользователем вне сайта: по почте или в мессенджере. Например, вы согласовали с клиентом заказ и готовы отправить ссылку на оплату. AI-агент создаст платеж, а вы передадите пользователю ссылку на страницу оплаты.
Как это работает
Вы пишете агенту, какой платеж нужно создать:
Создай платеж на 2500 рублей. Описание платежа: Онлайн-консультация. Верни в ответе идентификатор платежа, сумму, описание, статус и ссылку на оплату.
AI-агент проверяет, достаточно ли данных для создания платежа. При необходимости агент запрашивает у вас необходимую информацию в чате.
После этого AI-агент выбирает инструмент создания платежа, а AI-платформа передает MCP-серверу ЮKassa сумму и описание. MCP-сервер ЮKassa создает платеж и возвращает его идентификатор, статус, сумму, описание и ссылку на страницу оплаты. AI-агент возвращает эти данные в чат.
Вы открываете ссылку на страницу оплаты и проверяете сумму платежа и описание. Затем вы отправляете ссылку пользователю. Пользователь переходит на страницу оплаты ЮKassa, выбирает способ оплаты и подтверждает платеж.
После оплаты вы можете попросить AI-агента проверить статус платежа. В той же сессии можно сослаться на созданный платеж:
Проверь статус созданного платежа. Верни в ответе идентификатор платежа, статус, сумму, описание, способ оплаты и время создания. Если есть ссылка на оплату, тоже покажи ее.
Если агент не помнит, о каком платеже идет речь, укажите идентификатор явно:
Проверь статус платежа с идентификатором <идентификатор платежа>. Верни в ответе идентификатор платежа, статус, сумму, описание, способ оплаты и время создания. Если есть ссылка на оплату, тоже покажи ее.
AI-агент выбирает инструмент получения информации о платеже, AI-платформа отправляет запрос MCP-серверу ЮKassa, а агент возвращает актуальную информацию в чат.
Что подготовить
Для настройки агента подготовьте:
- подключенный MCP-сервер ЮKassa;
- при необходимости инструкции для AI-агента или AI-платформы: как проверять данные, сохранять идентификатор платежа и формировать ответ.
Для выполнения операции подготовьте:
- сумму платежа;
- описание платежа, если хотите показать его на странице оплаты и в личном кабинете.
Получение списка платежей
Этот сценарий подходит, если нужно оперативно посмотреть платежи или подготовить предварительную сводку. Например, можно быстро посмотреть успешные платежи за день или проверить платежи с определенным способом оплаты.
Для бухгалтерской сверки и отчетности используйте реестры платежей и возвратов ЮKassa.
Как это работает
Вы запрашиваете у AI-агента список платежей за определенный период и задаете фильтры:
Покажи успешные платежи за вчера по московскому времени. По каждому платежу верни идентификатор, статус, сумму, описание, способ оплаты и время создания. Если есть следующий фрагмент списка, сообщи об этом.
AI-агент проверяет, достаточно ли данных для поиска платежей. При необходимости агент уточняет в чате, по каким критериям нужно отфильтровать список платежей.
После этого он выбирает инструмент получения списка платежей, а AI-платформа передает MCP-серверу ЮKassa выбранные фильтры. MCP-сервер ЮKassa возвращает список платежей с идентификатором, статусом и суммой каждого платежа. В ответе также могут быть описание, способ оплаты и время создания платежа. Если в списке есть следующий фрагмент, MCP-сервер также вернет указатель на него. AI-агент показывает список в чате или готовит краткую сводку в нужном вам формате.
Что подготовить
Для настройки агента подготовьте:
- подключенный MCP-сервер ЮKassa;
- при необходимости инструкции для AI-агента или AI-платформы по формату списка или сводки.
Для выполнения операции подготовьте:
- период;
- дополнительные фильтры, если нужны: статус платежа или способ оплаты.
Получение информации о возврате
Этот сценарий подходит, если вы сделали возврат в личном кабинете ЮKassa и хотите посмотреть информацию о нем через MCP-сервер.
Создать возврат через MCP-сервер нельзя. Сделать возврат можно только в личном кабинете ЮKassa или по API. Через MCP-сервер можно только получить информацию о возврате или список возвратов.
Как это работает
Сначала вы делаете возврат в личном кабинете ЮKassa и сохраняете его идентификатор. После этого пишете AI-агенту:
Проверь возврат с идентификатором <идентификатор возврата>. Верни в ответе идентификатор возврата, идентификатор платежа, статус, сумму, время создания и описание, если оно есть.
Если у вас сохранен идентификатор возвращенного платежа, вы можете запросить информацию по нему:
Проверь возврат по платежу с идентификатором <идентификатор платежа>. Верни в ответе идентификатор возврата, идентификатор платежа, статус, сумму, время создания и описание, если оно есть.
AI-агент проверяет, достаточно ли данных для запроса информации о возврате. При необходимости агент уточняет в чате идентификатор возврата.
После этого он выбирает инструмент получения информации о возврате, а AI-платформа передает MCP-серверу ЮKassa идентификатор возврата. MCP-сервер ЮKassa возвращает идентификатор возврата, идентификатор платежа, статус, сумму и время создания возврата. Если при создании возврата было указано описание, оно также может вернуться в ответе. AI-агент показывает информацию о возврате в чате.
Что подготовить
Для настройки агента подготовьте:
- подключенный MCP-сервер ЮKassa;
- при необходимости инструкции для AI-агента или AI-платформы по формату ответа.
Для выполнения операции подготовьте:
- идентификатор платежа или возврата из личного кабинета ЮKassa.
Выставление счета по данным внешней системы
Этот сценарий подходит, если сумму, срок действия счета, состав корзины и описание нужно получить из CRM, каталога или другой системы. Подробнее о счетах
Выставление счетов через MCP-сервер в тестовом магазине недоступно.
Как это работает
Например, вам нужно выставить счет по заказу из CRM или каталога. Если вы настроили доступ агента к этой системе, он сможет получить из нее данные для счета. Вы пишете агенту, что нужно создать счет:
Выставь счет на 2500 рублей за онлайн-консультацию. Срок действия счета — 7 дней. Верни в ответе идентификатор счета, сумму, описание, статус, срок действия и ссылку на счет.
AI-агент получает сумму, срок действия, состав корзины и описание через MCP-сервер сторонней системы или другой доступный ему инструмент. Если данных недостаточно или их нельзя получить автоматически, агент должен уточнить недостающую информацию у вас. Затем он выбирает инструмент создания счета, а AI-платформа передает MCP-серверу ЮKassa данные для счета.
MCP-сервер ЮKassa создает счет и возвращает его идентификатор, статус, сумму, описание, срок действия и ссылку на страницу счета. AI-агент возвращает эти данные в чат.
Вы открываете ссылку на страницу счета и проверяете его данные, а затем отправляете ссылку пользователю. Пользователь открывает страницу счета и переходит к оплате.
После оплаты можно попросить AI-агента проверить данные счета или связанного платежа. В той же сессии можно сослаться на созданный счет, но надежнее указать идентификатор счета явно:
Проверь статус счета с идентификатором <идентификатор счета>. Верни в ответе идентификатор счета, статус, сумму, описание, срок действия и ссылку на счет. Если есть связанный платеж, верни его идентификатор и статус.
AI-агент выбирает подходящий инструмент, AI-платформа отправляет запрос MCP-серверу ЮKassa, а агент возвращает актуальную информацию в чат.
Что подготовить
Для настройки агента подготовьте:
- подключенный MCP-сервер ЮKassa;
- безопасный доступ AI-агента к CRM, каталогу или другой системе, если данные нужно получать автоматически;
- инструкции для AI-агента или AI-платформы об источниках данных и проверках, при необходимости о сохранении идентификаторов и формате ответа.
Для выполнения операции подготовьте:
- сумму счета;
- срок действия счета (он может быть не больше 30 дней);
- состав корзины;
- описание счета, если хотите показать его на странице счета и в личном кабинете.
Оплата из чата на сайте
Этот сценарий подходит, если на вашем сайте есть публичный чат с AI-агентом и пользователь может выбрать товар или услугу прямо в диалоге. Агент помогает пользователю оформить заказ, а техническую логику создания платежа выполняют AI-платформа и MCP-сервер ЮKassa по вашим настройкам.
Как это работает
Пользователь выбирает товар или услугу и пишет в чат на сайте:
Хочу оплатить онлайн-консультацию. Создай платеж и пришли ссылку на оплату.
AI-агент работает по вашим инструкциям: определяет товар или услугу, получает сумму и описание из каталога, CRM или другой системы и проверяет, достаточно ли данных для создания платежа. Если данных не хватает, агент уточняет их у пользователя в чате. Если ваш сценарий требует подтверждения перед оплатой, агент показывает пользователю сумму и описание заказа до вызова инструмента создания платежа.
Когда данных достаточно, AI-агент выбирает инструмент создания платежа. AI-платформа передает MCP-серверу ЮKassa сумму и описание платежа. MCP-сервер ЮKassa создает платеж и возвращает идентификатор платежа, статус, сумму, описание и ссылку на страницу оплаты. В зависимости от инструкций, которые вы подготовили для агента, он возвращает пользователю все полученные данные или только те, которые нужны для оплаты: сумму, описание и ссылку на страницу оплаты. Пользователь проверяет данные, переходит по ссылке, выбирает способ оплаты и подтверждает платеж на стороне ЮKassa.
Если у агента есть доступ к базе данных, CRM или другой вашей системе, вы можете добавить для него инструкции по сохранению данных платежа. Например, агент может сохранить идентификатор, статус и сумму платежа для последующей проверки и контроля за действиями агента на вашей стороне.
При проверке этого сценария убедитесь, что пользователи чата не получают доступ к списку платежей магазина или данным чужих платежей. Если AI-платформа поддерживает ограничение инструментов, оставьте для публичного чата только нужные операции.
Что подготовить
Для настройки агента подготовьте:
- подключенный MCP-сервер ЮKassa;
- публичный чат с AI-агентом;
- безопасный доступ AI-агента к каталогу или другой системе, если агент должен получать товары, цены и другие данные для платежа;
- инструкции для AI-агента или AI-платформы: какие товары и услуги можно оплачивать, откуда брать сумму и описание, когда уточнять данные у пользователя, что показывать пользователю перед отправкой ссылки и какие данные платежа сохранять;
- ограничения инструментов для публичного чата, если AI-платформа поддерживает эту возможность.
Для выполнения операции подготовьте:
- выбранный пользователем товар или услугу;
- сумму платежа;
- описание платежа, если хотите показать его на странице оплаты и в личном кабинете.
Что почитать еще