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

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

Claude Desktop и claude.ai

Customize → Connectors → «+» → Add custom connector
Вставьте адрес сервера в поле URL
Сохраните — инструменты появятся в списке доступных

https://mcp.sanatory.ru/api/mcp

Веб-версия claude.ai тоже поддерживается. В Team и Enterprise коннектор добавляет владелец: Organization settings → Connectors → Add → Custom → Web, остальные нажимают Connect. На бесплатном плане — один свой коннектор.

Аккаунт и заказы

Перед сохранением выберите Authentication → Sign in now и OAuth client → Register automatically. Claude откроет Sanatory.ru: войдите и разрешите доступ. Вариант Use Claude's published identity наш сервер не поддерживает — вход с ним не пройдёт. Способ входа потом не поменять: уже добавленный коннектор удалите и добавьте заново.

ChatGPT

Settings → Security and login → включите Developer mode
chatgpt.com/plugins → «+»: название Sanatory, описание и адрес сервера в разделе Connection
В чате назовите его в запросе: «Sanatory, найди санаторий в Кисловодске на октябрь»

https://mcp.sanatory.ru/api/mcp

Работает в веб-версии на планах Plus, Pro, Business, Enterprise и Edu. В рабочих пространствах режим разработчика может быть выключен администратором.

Аккаунт и заказы

При создании выберите аутентификацию OAuth: ChatGPT откроет Sanatory.ru — войдите и разрешите доступ. С Mixed Authentication заказы не появятся.

Cursor

{
  "mcpServers": {
    "sanatory": { "url": "https://mcp.sanatory.ru/api/mcp" }
  }
}

Файл ~/.cursor/mcp.json — глобально, .cursor/mcp.json — в проекте. Или Settings → Tools & MCP → Add new MCP server, транспорт streamable-http.

Аккаунт и заказы

{
  "mcpServers": {
    "sanatory": {
      "url": "https://mcp.sanatory.ru/api/mcp",
      "headers": { "Authorization": "Bearer skm_ваш_ключ" }
    }
  }
}

Ключ — из раздела «Аккаунт и заказы» ниже. Храните его в глобальном ~/.cursor/mcp.json, а не в файле проекта, чтобы он не попал в git.

Claude Code

claude mcp add --transport http sanatory https://mcp.sanatory.ru/api/mcp

После добавления просто спросите: «найди санаторий в Кисловодске на октябрь для двоих».

Аккаунт и заказы

claude mcp add --transport http sanatory https://mcp.sanatory.ru/api/mcp --header "Authorization: Bearer skm_ваш_ключ"

Ключ — из раздела «Аккаунт и заказы» ниже. Если сервер уже добавлен без ключа, сначала claude mcp remove sanatory. Если Sanatory подключён со входом в claude.ai под тем же аккаунтом, ключ не нужен: Claude Code подхватит коннектор сам.

Codex CLI

[mcp_servers.sanatory]
url = "https://mcp.sanatory.ru/api/mcp"

Добавьте в ~/.codex/config.toml и перезапустите codex. Это не то же самое, что коннектор в ChatGPT, — настройки не общие.

Аккаунт и заказы

[mcp_servers.sanatory]
url = "https://mcp.sanatory.ru/api/mcp"
bearer_token_env_var = "SANATORY_MCP_KEY"

Сам ключ — в переменной окружения, например в ~/.zshrc: export SANATORY_MCP_KEY=skm_ваш_ключ. В конфиге его не будет.

VS Code с GitHub Copilot

{
  "servers": {
    "sanatory": { "type": "http", "url": "https://mcp.sanatory.ru/api/mcp" }
  }
}

Файл .vscode/mcp.json в проекте — ключ servers, не mcpServers. Или Ctrl+Shift+P → MCP: Add Server → HTTP. Работает в agent mode.

Аккаунт и заказы

{
  "inputs": [
    { "type": "promptString", "id": "sanatory-key", "description": "Ключ Sanatory.ru", "password": true }
  ],
  "servers": {
    "sanatory": {
      "type": "http",
      "url": "https://mcp.sanatory.ru/api/mcp",
      "headers": { "Authorization": "Bearer ${input:sanatory-key}" }
    }
  }
}

При первом запуске VS Code спросит ключ и сохранит его в защищённом хранилище — в файле проекта его не будет.

Cherry Studio, Windsurf, Cline, Continue, Zed и другие

Найдите в настройках раздел MCP
Транспорт — streamable-http (иногда называется просто HTTP)

https://mcp.sanatory.ru/api/mcp

Подойдёт любой клиент с поддержкой удалённых MCP-серверов: для поиска ключи, токены и заголовки не нужны.

Аккаунт и заказы

Если клиент позволяет задать заголовки, добавьте Authorization со значением Bearer и личным ключом из раздела «Аккаунт и заказы» ниже.

Аккаунт и заказы

Поиск и цены работают без входа. Чтобы помощник бронировал в вашем аккаунте и видел ваши заказы — статус брони и оплаты, даты, санаторий и сумму, — подключите аккаунт Sanatory.ru. Как именно, написано в карточке вашего клиента выше.

Вход через браузер. Приложение откроет Sanatory.ru, вы входите в аккаунт и разрешаете смотреть заказы и бронировать. Ничего копировать не нужно, доступ продлевается сам.

Личный ключ — для клиентов, где сервер прописывается в конфиге. Войдите на Sanatory.ru и откройте Профиль → Приложения, нажмите «Создать ключ». Ключ показывается один раз и действует 90 дней, завести можно до десяти.

Нет аккаунта — зарегистрируйтесь на Sanatory.ru: значок профиля в шапке сайта → «Зарегистрироваться».

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

Проверить, что работает

Найди санаторий в Кисловодске на две недели в октябре для двоих и пришли ссылку, чтобы забронировать.
Покажи санатории в Сочи с лечением и трёхразовым питанием на неделю в октябре для двоих, с фото.
На эти даты мест нет — когда ближайшие свободные?

Инструменты

find_regionsРегион, курорт, город или страну по названию, опечатки допустимы. Отдаёт place_id для поиска и родительский регион: если по городу вариантов мало, помощник предложит искать шире — например, по Кавминводам.
find_hotelsКонкретный санаторий, отель или пансионат по названию. Опечатки допустимы, «ё» и «е» равны. Одно название носят разные объекты — помощник уточнит город.
find_treatment_profilesПрофиль лечения по названию профиля или заболевания — «органы дыхания», «астма».
find_filter_optionsЗначения фильтров по названию: удобства, питание, лечебные факторы, расположение, тип объекта. Отдаёт теги для search_sanatoriums.
search_sanatoriumsПоиск по направлению, датам и составу гостей. Фильтры по лечению, питанию, расположению, типу объекта, удобствам, цене и звёздам; сортировка по цене или рейтингу. У каждого объекта — фото, цена за сутки и за срок с пометкой, что входит (питание, лечение) и на какие даты она посчитана.
find_hot_offersГорящие путёвки: готовые предложения на конкретные даты с заданным номером и составом мест. Подходят, если вы гибки в датах. Цена — за всё проживание, ссылка сразу открывает корзину с этим предложением.
find_promo_offersАкции сайта: санатории с акционными тарифами, доступными на ваши даты и состав гостей. Если акция не подошла, помощник предложит обычные номера в том же санатории или похожие варианты.
find_new_year_offersНовогодний отдых: санатории и спа-отели из новогодней подборки сайта, свободные на ваши даты и состав гостей.
get_sanatoriumКарточка санатория: описание, фото, профили лечения, программы, питание, условия оплаты, транспорт. Для бронирования и вопросов — контакты Sanatory.ru; прямых контактов санатория помощник не получает.
get_prices_availabilityЦены, типы номеров и доступность на конкретные даты. У каждого тарифа — готовая ссылка на корзину с уже подставленной бронью, а также что входит в цену (питание, процедуры, услуги), минимальный срок и условия отмены. Если мест нет, помощник подберёт ближайшие свободные даты. Если к моменту перехода тариф уже разобрали, откроется страница санатория с теми же датами — можно выбрать другой.
prepare_bookingИтог брони перед вашим подтверждением — ничего не бронирует. Цена тарифа на ваших гостей, что в неё входит, даты и время заезда, варианты оплаты с суммами — сразу, позже и всего, — условия отмены и согласие с документами: всё, что показывает корзина сайта.
create_bookingБронирует выбранный тариф — только после вашего «да» на итог. Возвращает код заказа и ссылку на оплату: платите вы сами, неоплаченная бронь отменяется. Если цена успела измениться, помощник ничего не бронирует и назовёт новую. Бронь оформляется в вашем аккаунте Sanatory.ru — помощник попросит его подключить, см. «Аккаунт и заказы».
get_payment_linkНовая ссылка на оплату заказа — на всю сумму или на остаток после предоплаты.
find_available_datesБлижайшие свободные даты санатория, когда на нужные даты мест нет или даты гибкие: ищет окна на заданное число ночей в диапазоне до 60 дней и проверяет цену на каждое. У партнёрских объектов календаря нет — проверяются несколько дат с шагом в неделю.
get_reviewsТексты отзывов гостей и рейтинг по 10-балльной шкале: свежие, лучшие или худшие первыми.
get_site_docsСправочные файлы сайта: правила бронирования, оплаты и отмены, кэшбэк, сертификаты, FAQ.
prepare_certificate_linkСсылка на форму покупки подарочного сертификата: номинал, получатель, отправитель, поздравление и дата отправки уже подставлены. Заказ не создаётся — вы проверяете форму и покупаете сами.
get_my_ordersВаши заказы на Sanatory.ru, от свежих к старым: код заказа, статус брони и отдельно оплата — сколько оплачено, сколько осталось и до какого срока; даты, санаторий и сумма. Данные попутчиков и платёжные реквизиты помощник не получает. Только с подключённым аккаунтом, см. «Аккаунт и заказы».