Подключение ИИ-ассистента (MCP)

Wishnya умеет работать с вашим ИИ-ассистентом напрямую — по протоколу MCP (Model Context Protocol). Дайте ассистенту ключ, и он сможет от вашего имени посмотреть ваши вишлисты, добавить желание по ссылке на товар, поправить цену или описание, отметить подарок подаренным — прямо из чата с моделью, без переключения на сайт.

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

Войдите в личный кабинет и откройте Профиль → ИИ-ассистент.
Создайте ключ: дайте ему название и выберите, что ассистенту разрешено — только смотреть списки или ещё и редактировать их.
Скопируйте ключ сразу — второй раз он не показывается.
Укажите ассистенту адрес https://wishnya.com/api/mcp и ключ. Дальше — по инструкции ниже.

Ключ действует только от вашего имени и только над вашими вишлистами. Его можно отозвать в любой момент на той же странице — он сразу перестанет работать.

Что ассистент никогда не увидит

Имя и контакт гостя, который забронировал подарок — этого нет ни в API, ни в MCP, независимо от прав ключа.
Какой конкретно подарок забронирован, если у вишлиста включён режим «сюрприз» — только общее количество забронированного.
Вишлисты других пользователей — если такой вишлист попросить, ответ будет «не найден», а не «нет доступа».
Ваш пароль, email, платёжные данные — этого в API просто нет.

Техническое подключение

Адрес: POST https://wishnya.com/api/mcp
Протокол: JSON-RPC 2.0, один запрос — один ответ. Потокового вывода (SSE) нет: обычный JSON на обычный POST.
Авторизация: заголовок Authorization: Bearer ваш_ключ или X-API-Key: ваш_ключ.

Рукопожатие протокола:

POST https://wishnya.com/api/mcp
Authorization: Bearer wag_...
Content-Type: application/json

{"jsonrpc":"2.0","id":1,"method":"initialize",
 "params":{"protocolVersion":"2025-06-18","capabilities":{},
           "clientInfo":{"name":"my-agent","version":"1.0"}}}

Права ключа

Право	Что открывает ассистенту
`wishlists:read`	Смотреть вишлисты и желания, видеть, сколько подарков забронировано
`wishlists:write`	Создавать вишлисты и менять их настройки
`wishes:write`	Добавлять и редактировать желания, отмечать «подарено»
`tools:parse-url`	Читать страницу товара по ссылке — название, картинка, цена

Инструменты MCP

Инструмент	Что делает
`get_account_context`	Владелец, счётчики списков и желаний, лимиты ключа
`list_wishlists`	Вишлисты владельца (активные или из архива)
`get_wishlist`	Один вишлист с желаниями и числом резервов
`list_wishes`	Только желания списка
`create_wishlist`	Создать вишлист
`update_wishlist`	Изменить настройки вишлиста
`create_wish`	Добавить желание
`update_wish`	Изменить желание
`mark_wish_gifted`	Отметить «подарено»
`delete_wish`	Удалить желание
`parse_product_url`	Разобрать ссылку на товар

Ассистенту доступны только инструменты, разрешённые правами ключа — остальные не появятся в списке.

Ограничения

До 5 активных ключей на аккаунт; неиспользуемые можно отозвать.
Лимит запросов на ключ: по умолчанию 30 в минуту и 1000 в день.
Удалять вишлист целиком через ассистента нельзя — только желания внутри него.
Загрузка файлов ассистенту не доступна — картинка желания принимается только по внешней ссылке.

Есть вопросы по подключению — напишите нам через страницу контактов.