MCP-сервер бронирования путешествий
для AI-агентов.

Adrasis предоставляет сервер Model Context Protocol (MCP) поверх своего Distribution Partner API. AI-агенты ищут и бронируют размещение, трансферы, туры, чартерные рейсы и турпакеты по правилам API в рамках аккаунта партнёра.

Удалённый MCP-сервер поверх Partner API.

Сервер оборачивает REST-контракт Adrasis Distribution Partner API. Агент вызывает инструменты, а не эндпоинты, и каждый инструмент работает так же, как стоящий за ним REST-вызов.

При сравнении MCP-серверов для туризма почти всё решают три вопроса: откуда берётся предложение, кто определяет, что разрешено агенту, и настоящее ли бронирование. Здесь предложением служит то, чем агентство или туроператор управляет в Adrasis Console, и этот владелец контролирует доступ через аккаунт партнёра и его права доступа. Успешный вызов book создаёт бронирование и уменьшает доступный для продажи остаток, как и бронирование через REST.

Для агентов ничего не трактуется иначе. Инструменты используют те же схемы запросов и ответов, бизнес-логику, ценообразование и правила использования, что и REST-контракт, поэтому агент и обычная интеграция работают по одним правилам.

# Удалённый MCP-сервер, streamable HTTP
https://ari.console.adrasis.com/mcp

# Токен доступа OAuth 2.0
Authorization: Bearer <access token>

Агент может обойтись и без MCP, обращаясь напрямую к REST API. Полный машиночитаемый контракт опубликован в справочнике API (на английском).

MCP и AI-оператор Adrasis.

MCP-сервер нужен AI-агенту, который бронирует из предложения другой компании через аккаунт партнёра. AI-оператор выполняет работу внутри вашей собственной организации.

Участвуют две стороны. Владелец предложения: агентство или туроператор, который ведёт свои контракты и цены в Adrasis Console. Агента создаёт партнёр: OTA (онлайн-турагентство), туристическое приложение, другое агентство или технологический партнёр. Владелец создаёт аккаунт партнёра, открывает доступ к объектам, которые партнёр может бронировать, и выдаёт учётные данные, а агент работает только внутри этого аккаунта.

AI-оператор работает с вашими собственными данными

Ваша команда отправляет поручения через чат-панель в Console, по электронной почте или в WhatsApp. AI-оператор Adrasis готовит операции с вашим каталогом, тарифами, контрактами и дистрибуцией. SMS используется для уведомлений и подтверждения операций. Запросы, которые только читают данные, выполняются сразу. Всё, что меняет данные, сначала показывается в предпросмотре и выполняется только после вашего подтверждения, а данные других организаций AI-оператор никогда не читает. Подробнее о том, как работает AI-оператор.

Какие инструменты может вызывать агент?

Каждый инструмент соответствует одной REST-операции и использует её схемы запросов и ответов. Инструменты сгруппированы по продуктам, и для каждого нужно одно из двух прав доступа.

Размещение

Справочные данные, контент объектов, поиск доступности и полный цикл бронирования для отелей, жилья для краткосрочной аренды, вилл и апартаментов. Список «Открытые объекты» содержит объекты, открытые для конкретного профиля партнёра.

Инструмент Что делает Право доступа
search_property_availability Находит самое дешёвое предложение по каждому объекту, до 200 объектов. distribution:read
search_place_availability Находит самые дешёвые предложения по направлению, до 100 объектов на странице. distribution:read
list_countries Возвращает список стран с ID, ISO-кодами и локализованными названиями. distribution:read
list_place_types Возвращает восемь типов мест и показывает, по каким из них доступен поиск в каждой стране. distribution:read
list_places Находит направления по стране, типу, родительскому месту или названию. distribution:read
list_properties Возвращает контент объектов из списка «Открытые объекты», без цен. distribution:read
get_property Возвращает полный контент одного объекта. distribution:read
prebook Пересчитывает цену выбранного предложения; возвращает токен предварительного бронирования, статус совпадения и условия отмены. distribution:booking
book Подтверждает бронирование с ключом идемпотентности для безопасных повторов. distribution:booking
get_booking Возвращает одно бронирование или проверяет статус ожидающего бронирования. distribution:booking
list_bookings Сверяет бронирования по вашему номеру бронирования, диапазону дат или последним изменениям. distribution:booking
cancellation_quote Показывает размер штрафа за отмену, ничего не меняя. distribution:booking
cancel Отменяет бронирование и начисляет штраф за отмену. Повторный вызов безопасен. distribution:booking

Поиск предложений по одному объекту доступен только через REST. Он возвращает лучшее предложение для всего состава гостей, а затем все доступные варианты номеров и тарифов для каждого запрошенного номера: от самых дешёвых, с выбором количества.

Трансфер, тур и перелёт

Каждый продукт работает по той же схеме, что и размещение: поиск, предварительное бронирование, бронирование. Рейсы чартерные, а перелёт туда и обратно ищется как два отдельных сегмента.

Инструмент Что делает Право доступа
search_transfers Находит предложения трансферов между двумя зонами на дату услуги для заданного состава гостей. distribution:booking
prebook_transfer Пересчитывает цену предложения трансфера и возвращает токен предварительного бронирования с условиями отмены. distribution:booking
book_transfer Подтверждает трансфер с ключом идемпотентности. distribution:booking
search_tours Находит предложения тура на дату отправления для заданного состава гостей. distribution:booking
prebook_tour Пересчитывает цену предложения тура и возвращает токен предварительного бронирования с условиями отмены. distribution:booking
book_tour Подтверждает тур с ключом идемпотентности. distribution:booking
search_flights Находит предложения чартерных рейсов на дату вылета для заданного состава пассажиров. distribution:booking
prebook_flight Пересчитывает цену предложения перелёта и возвращает токен предварительного бронирования с условиями отмены. distribution:booking
book_flight Подтверждает бронирование перелёта с ключом идемпотентности. distribution:booking

Пакеты

В пакете по одной общей цене продаются от 2 до 8 услуг, уже выбранных агентом, и они должны относиться как минимум к двум типам продуктов. Подтверждаются либо все услуги, либо ни одна. После бронирования пакет можно просмотреть и отменить через get_booking, cancellation_quote и cancel, причём два последних инструмента можно применять и к отдельным услугам внутри пакета.

Инструмент Что делает Право доступа
search_packages Объединяет от 2 до 8 выбранных услуг в одно предложение с одной общей ценой. distribution:booking
prebook_package Перепроверяет каждую услугу и возвращает статус совпадения, информацию, обязательную к раскрытию, и токен предварительного бронирования. distribution:booking
book_package Бронирует весь пакет сразу: подтверждаются либо все услуги, либо ни одна. distribution:booking

Объединение в поездку

Поездка объединяет уже подтверждённые бронирования в один маршрут. У каждого бронирования остаются своя сумма, свои условия отмены и свой жизненный цикл, поэтому поездка никогда не становится пакетом с общей ценой.

Инструмент Что делает Право доступа
create_trip Объединяет подтверждённые бронирования в одну поездку. У каждого бронирования сохраняется своя цена. distribution:booking
get_trip Возвращает поездку с её бронированиями и итоговыми суммами по каждой валюте. distribution:booking
add_trip_member Добавляет существующее бронирование в поездку. distribution:booking
remove_trip_member Исключает бронирование из поездки, не меняя само бронирование. distribution:booking
cancel_trip Отменяет все бронирования в поездке и сообщает результат по каждому. distribution:booking

Как агент бронирует проживание?

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

  1. Определите географию. Вызовите list_countries, list_place_types и list_places, чтобы найти страну, типы мест, по которым там доступен поиск, и само направление, например Анталью.
  2. Соберите контекст без цен. Получите контент объектов из списка «Открытые объекты» через list_properties и get_property. Ни один из этих вызовов не принимает точку продаж.
  3. Выполните поиск. Вызовите search_property_availability для известных объектов или search_place_availability, чтобы перебрать объекты направления. Укажите режим распределения: strict сохраняет каждый номер точно как в запросе, flexible позволяет распределить гостей максимум по девяти номерам. Храните selection_token выбранного предложения на стороне сервера.
  4. Выполните предварительное бронирование. Передайте этот токен в prebook, который пересчитает цену предложения. Проверьте статус совпадения и условия отмены, затем согласуйте и то и другое с пользователем.
  5. Забронируйте. Вызовите book с данными гостей, контактными данными и уникальным idempotency_key. Повторный запрос с тем же ключом и неизменённым телом в течение 24 часов после первого запроса вернёт исходное бронирование, а не создаст второе.
  6. Опрашивайте статус. Если бронирование вернулось в статусе ожидания, например по тарифу, который ждёт подтверждения от объекта, вызывайте get_booking, пока статус не станет окончательным.
  7. Сверьте данные. Сопоставьте бронирования по всей учётной записи с помощью list_bookings, используя собственный agency_reference или ограниченный диапазон дат либо период изменений. Результаты не содержат персональных данных гостей.
  8. Отменяйте по запросу. Покажите штраф через cancellation_quote, а cancel вызывайте только после подтверждения пользователя.

Предварительное бронирование не блокирует номера. Доступность проверяется повторно при вызове book, поэтому между этими шагами последний номер может уйти другому покупателю, и тогда агент снова выполняет поиск. Токен предварительного бронирования действует 30 минут и позволяет создать только одно бронирование.

Платежи через сервер не проходят. Продавцом, принимающим оплату, остаётся партнёр. Тарифы, требующие оплаты в другом месте, например списания с карты или графика депозитов, так забронировать нельзя.

Как агент проходит аутентификацию?

С теми же учётными данными клиента OAuth 2.0, что и интеграция через REST. Сессия агента проходит аутентификацию точно так же, как REST-клиент.

Партнёр обменивает client ID и client secret на токен доступа по адресу https://ari.console.adrasis.com/api/v1/oauth/token. Токен действует один час, refresh-токен не выдаётся: когда срок истекает, агент запрашивает новый с теми же учётными данными. В документации рекомендуется хранить один токен и обновлять его незадолго до истечения срока, а не запрашивать новый для каждого вызова.

Токен передаётся в заголовке Authorization сессии MCP. Учётная запись партнёра и права доступа токена передаются без изменений при каждом вызове инструмента, а вызов инструмента, для которого у токена нет нужного права, отклоняется.

Два права доступа

Право доступа Что охватывает
distribution:read Справочные данные, контент объектов и поиск доступности размещения.
distribution:booking Проверка перед бронированием и бронирование размещения, просмотр бронирований, расчёт штрафа за отмену и отмена, а также все инструменты для трансферов, туров, перелётов, пакетов и поездок, включая инструменты поиска.

Выдавайте только то, что нужно агенту. Агент, который отвечает на вопросы о доступности, но не должен бронировать, получает только distribution:read. Новые учётные данные по умолчанию получают оба права, поэтому при создании учётных данных для агента выберите минимальный набор. Токен также можно запросить с меньшими правами, чем есть у его учётных данных. Коды ошибок и остальные подробности приведены в руководстве по аутентификации (на английском).

Что видит агент?

Только то, что ему открыл владелец предложения. Для размещения это список «Открытые объекты» одного профиля партнёра.

Инструменты для объектов возвращают только опубликованные объекты размещения, явно открытые в разделе «Открытые объекты» выбранного профиля, и ничего больше. У каждой учётной записи партнёра изначально есть профиль по умолчанию: в нём зафиксирован список объектов, опубликованных на момент создания учётной записи. Объект, опубликованный позже, остаётся закрытым для партнёра, пока владелец его не откроет. Закрытие объекта убирает его из результатов этого профиля, но не удаляет объект и не закрывает его в других профилях.

Если одному партнёру нужны отдельные каталоги для разных аудиторий, владелец добавляет в учётную запись новые профили. Инструменты, работающие в рамках профиля, принимают необязательный параметр profile_public_id: без него используется профиль по умолчанию, а с ним выбирается другой профиль той же учётной записи. В каждом успешном ответе указан профиль, который фактически использовался. Учётные данные принадлежат учётной записи, поэтому одни и те же учётные данные работают со всеми профилями.

Видеть объект ещё не значит продавать его

list_properties и get_property показывают то, что открыто для профиля, и не принимают страну продажи. Цены, номера в продаже и правила по направлениям не расширяют и не сужают их результат. Можно ли продать проживание путешественнику, решают только инструменты доступности: они принимают страну продажи для путешественника в виде кода страны.

На list_bookings выбор профиля не распространяется. Этот инструмент читает бронирования по всей учётной записи, а profile_public_id здесь лишь сужает отчёт до бронирований, созданных в указанном профиле.

Как партнёр получает доступ?

Владелец предложения подключает партнёра в Adrasis Console. Для разработки, сертификации и рабочего трафика используется один и тот же хост.

  1. Учётная запись партнёра

    Владелец открывает «Подключения», затем «Каналы продаж», «API-партнёры» и «Учётные записи партнёров» и создаёт для этого партнёра одну учётную запись. Вместе с ней создаётся профиль по умолчанию.

  2. Открытые объекты

    Владелец открывает нужные объекты в каждом профиле: по одному, группой или с помощью фильтров по стране и населённому пункту.

  3. Учётные данные

    Отдельные учётные данные со своим названием для каждой среды и с минимальными правами доступа. Секрет показывается один раз, поэтому его сразу сохраняют в менеджер секретов.

  4. Сертификация и запуск

    Пилотные учётные данные дают доступ к демонстрационному каталогу. При переводе на реальное предложение client ID, хост и порядок интеграции не меняются.

Цены и доступность в демонстрационном каталоге сгенерированы для тестирования, а тестовые бронирования не влияют на реальные номера в продаже и не приводят к списаниям. И всё же отменяйте каждое тестовое бронирование: открытое тестовое бронирование занимает демонстрационные номера, и при повторных тестах может начать возвращаться SOLD_OUT.

Фиксированный предел запросов не публикуется. Лимиты запросов согласуются для каждого подключения, поэтому уточните их у своего контактного лица в Adrasis, прежде чем увеличивать трафик. Дополнительные учётные данные или профили не увеличивают лимит. Владелец может сменить, отключить или отозвать учётные данные на вкладке «Доступ к API» учётной записи; отключённые или отозванные учётные данные перестают работать вместе с выпущенными по ним токенами.

Порядок действий владельца описан в разделе «API-партнёры и учётные данные (на английском)». Если ваша команда создаёт AI-агента для сферы путешествий и хочет стать партнёром, свяжитесь с нами.

Готовы подключить агента?

Запросите доступ к Console, чтобы настроить собственное предложение, или расскажите нам, какого агента вы создаёте и какой доступ ему нужен.