Adrasis предоставляет сервер Model Context Protocol (MCP) поверх своего Distribution Partner API. AI-агенты ищут и бронируют размещение, трансферы, туры, чартерные рейсы и турпакеты по правилам 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-агенту, который бронирует из предложения другой компании через аккаунт партнёра. AI-оператор выполняет работу внутри вашей собственной организации.
Участвуют две стороны. Владелец предложения: агентство или туроператор, который ведёт свои контракты и цены в Adrasis Console. Агента создаёт партнёр: OTA (онлайн-турагентство), туристическое приложение, другое агентство или технологический партнёр. Владелец создаёт аккаунт партнёра, открывает доступ к объектам, которые партнёр может бронировать, и выдаёт учётные данные, а агент работает только внутри этого аккаунта.
Ваша команда отправляет поручения через чат-панель в 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 |
Документированный сценарий состоит из восьми шагов, от географии до отмены. Агент дважды ждёт подтверждения пользователя: перед бронированием и перед отменой.
list_countries, list_place_types и list_places, чтобы найти страну, типы мест, по которым там доступен поиск, и само направление, например Анталью.list_properties и get_property. Ни один из этих вызовов не принимает точку продаж.search_property_availability для известных объектов или search_place_availability, чтобы перебрать объекты направления. Укажите режим распределения: strict сохраняет каждый номер точно как в запросе, flexible позволяет распределить гостей максимум по девяти номерам. Храните selection_token выбранного предложения на стороне сервера.prebook, который пересчитает цену предложения. Проверьте статус совпадения и условия отмены, затем согласуйте и то и другое с пользователем.book с данными гостей, контактными данными и уникальным idempotency_key. Повторный запрос с тем же ключом и неизменённым телом в течение 24 часов после первого запроса вернёт исходное бронирование, а не создаст второе.get_booking, пока статус не станет окончательным.list_bookings, используя собственный agency_reference или ограниченный диапазон дат либо период изменений. Результаты не содержат персональных данных гостей.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. Для разработки, сертификации и рабочего трафика используется один и тот же хост.
Владелец открывает «Подключения», затем «Каналы продаж», «API-партнёры» и «Учётные записи партнёров» и создаёт для этого партнёра одну учётную запись. Вместе с ней создаётся профиль по умолчанию.
Владелец открывает нужные объекты в каждом профиле: по одному, группой или с помощью фильтров по стране и населённому пункту.
Отдельные учётные данные со своим названием для каждой среды и с минимальными правами доступа. Секрет показывается один раз, поэтому его сразу сохраняют в менеджер секретов.
Пилотные учётные данные дают доступ к демонстрационному каталогу. При переводе на реальное предложение client ID, хост и порядок интеграции не меняются.
Цены и доступность в демонстрационном каталоге сгенерированы для тестирования, а тестовые бронирования не влияют на реальные номера в продаже и не приводят к списаниям. И всё же отменяйте каждое тестовое бронирование: открытое тестовое бронирование занимает демонстрационные номера, и при повторных тестах может начать возвращаться SOLD_OUT.
Фиксированный предел запросов не публикуется. Лимиты запросов согласуются для каждого подключения, поэтому уточните их у своего контактного лица в Adrasis, прежде чем увеличивать трафик. Дополнительные учётные данные или профили не увеличивают лимит. Владелец может сменить, отключить или отозвать учётные данные на вкладке «Доступ к API» учётной записи; отключённые или отозванные учётные данные перестают работать вместе с выпущенными по ним токенами.
Порядок действий владельца описан в разделе «API-партнёры и учётные данные (на английском)». Если ваша команда создаёт AI-агента для сферы путешествий и хочет стать партнёром, свяжитесь с нами.
Запросите доступ к Console, чтобы настроить собственное предложение, или расскажите нам, какого агента вы создаёте и какой доступ ему нужен.