Инструкция для ИИ-агентов

Помогайте путешественнику пользоваться Well Travel через тот же сайт и аккаунт клиента, что доступны ему самому. Подключайтесь через разрешённые клиентом инструменты MCP или следуйте сценарию в браузере ниже: оба варианта используют действующий клиентский процесс.

Точка подключения MCP Streamable HTTP: https://well-travel.net/mcp

Подключение ИИ-агента

  1. Клиент входит в личный кабинет, открывает Профиль → Доступ для ИИ-агента, создаёт ключ с названием подключения и копирует секрет. Полный ключ показывается только один раз; каждое подключение можно отозвать отдельно.
  2. В MCP-клиенте добавьте удалённый сервер по указанной выше точке подключения, транспорт Streamable HTTP и свой заголовок Authorization: Bearer <ключ клиента>. Выбранный MCP-клиент должен поддерживать постоянный bearer-ключ. Не вставляйте ключ в чат, URL, prompt или файл с исходным кодом.
  3. Сервер поддерживает версию протокола MCP 2026-07-28 и предыдущие версии 2025 года. Все инструменты работают только с аккаунтом клиента, который выпустил ключ.

Доступны инструменты: catalog_search, property_details, my_requests, create_rental_request, update_rental_request, react_to_option, reserve_option, request_booking_service, create_payment_link и cancel_booking. MCP-ресурс welltravel://client/guide содержит принципы работы в машинно-читаемом виде.

Как помочь клиенту

  1. Начните с публичного каталога. Используйте видимые фильтры и карточки объектов. Наличие и итоговые условия всё равно нужно подтвердить на нужные даты.
  2. Чтобы сохранять заявки и следить за их ходом, откройте личный кабинет клиента. Если аккаунта ещё нет, выберите регистрацию клиента; иначе войдите. При регистрации сайт использует подтверждение email. Пароль, одноразовые коды и документы клиент вводит самостоятельно.
  3. Отправьте заявку из карточки объекта либо создайте общую заявку в кабинете: город, даты, бюджет и пожелания. Перед отправкой сверьте детали с клиентом. Заявка запускает подбор, но сама по себе не является подтверждённым бронированием.
  4. Следите за изменениями во вкладке «Мои заявки». Менеджеры Well Travel связываются с хостами и могут добавить варианты в заявку. Клиент может посмотреть вариант, отреагировать на него и воспользоваться показанным действием бронирования, если оно доступно. Вариант и нажатие «Забронировать» сами по себе не гарантируют наличие или подтверждение брони.
  5. После подтверждения объекта и бронирования Well Travel используйте карточку брони в кабинете: договор, данные гостей, график и ссылки на оплату, чат и доступные услуги. Выполняйте действие, которое показано для текущего этапа. Бронь подтверждена только тогда, когда сайт или Well Travel явно это показывают.
  6. До и во время проживания используйте только услуги, отображаемые для этой брони: например, сведения о заселении, заявки на трансфер или другие услуги, варианты раннего/позднего заезда. В конце поездки отправьте отзыв об объекте, если кабинет его запрашивает.
  7. Для вопросов используйте встроенный чат. Ведите переписку и изменения заявки в аккаунте клиента, чтобы они сохранились у правильной заявки.

Как работает сервис

  • Публичный каталог предназначен для выбора жилья. Личный кабинет после входа показывает заявки клиента и позволяет продолжать работу с бронированием.
  • После отправки заявки команда Well Travel рассматривает её и уточняет варианты у хостов. Информация в каталоге не гарантирует наличие, цену или согласие хоста.
  • По мере обработки заявки её этапы обновляются. Ориентируйтесь на текущий статус и следующий шаг в кабинете; не считайте подтверждением сообщение, реакцию или нажатие кнопки.
  • Договор, ссылки на оплату и дополнительные действия появляются, когда они доступны на конкретном этапе брони. Используйте документы и платёжные инструкции сайта; не придумывайте реквизиты и не отмечайте оплату выполненной.

Доступ и безопасная работа

MCP-ключ представляет клиента, который его создал. Он даёт доступ только к данным этого аккаунта через MCP, не является паролем от сайта и не открывает доступ менеджера или агента. Если ключ раскрыт или больше не нужен, отзовите его в профиле клиента.

  • Не просите клиента присылать пароль от сайта или одноразовый код. MCP использует отдельный отзываемый ключ.
  • Получите подтверждение клиента перед отправкой или изменением заявки, реакцией на вариант, выбором варианта для бронирования, созданием ссылки на оплату, запросом дополнительной услуги или отменой брони.
  • Запрашивайте и вводите только сведения, необходимые для текущего шага. Не публикуйте данные паспорта, личные заметки или данные аккаунта в сообщениях.
  • Ссылка на оплату сама по себе не списывает деньги. Клиент завершает оплату на странице Well Travel. Не придумывайте реквизиты и не объявляйте оплату выполненной.
  • Если действие недоступно на текущем этапе брони, объясните клиенту полученный статус и предложите продолжить через кабинет или поддержку Well Travel.