Для разработчиков и партнёров

Знания об отелях как строительный блок

REST API

OpenAPI-схема, типы для фронта генерируются из неё

MCP-сервер

5 инструментов только на чтение для Claude, ChatGPT, Cursor и своих агентов

Факты с источником

У каждого ответа есть метод, источник, уверенность, дата и срок годности

Подключить агента по MCP

Streamable HTTP, без ключа, только чтение. Публичный URL для Claude и ChatGPT:

https://okno-api.fly.dev/mcp

Claude. Customize → Connectors → + Add → Add custom connector. Назовите «О!кно», вставьте URL, выберите No sign in и добавьте сервер. В чате включите его через «+» → Connectors.

ChatGPT. Откройте Plugins → «+» → Add custom MCP server. Назовите «О!кно», вставьте URL в Server URL, выберите No authentication, создайте и установите плагин. В чате выберите @О!кно. В рабочем пространстве может понадобиться доступ администратора.

Спросите: «Через О!кно найди тихий номер с закатом над морем в Сочи на 12–15 ноября вдвоём. Покажи три варианта и доказательства».

Для клиентов с JSON-конфигурацией:

JSON

{
  "mcpServers": {
    "okno": {
      "url": "https://okno-api.fly.dev/mcp"
    }
  }
}

Открыть OpenAPI →

search_hotels
Запрос словами → отели с вероятностью каждого пожелания и тем, какой номер просить
get_hotel_knowledge
Всё, что известно об отеле: факты по сторонам и этажам, неизвестное, окрестности
explain_fact
Почему мы так думаем: метод, источники, доказательство, история и уверенность
compare_hotels
Сравнение 2–3 отелей по выбранным пожеланиям
list_characteristics
Реестр характеристик: что система умеет проверять

Попробовать API прямо здесь

Запросы уходят в настоящий бэкенд. Без ключа LLM разбор делают правила, с ключом - модель.

Понять запрос

Текст гостя → пожелания из реестра и параметры поездки

POST /api/v1/intents

cURL

curl -X POST 'https://okno-api.fly.dev/api/v1/intents' \
  -H 'Content-Type: application/json' \
  -d '{"text":"Тихий номер с закатом над морем, 12–15 ноября, вдвоём, до 12 тысяч"}'

Подобрать номер

Ранжирование по фактам: балл, риск разочарования, какую сторону и этаж просить

POST /api/v1/searches

cURL

curl -X POST 'https://okno-api.fly.dev/api/v1/searches' \
  -H 'Content-Type: application/json' \
  -d '{"text":"Тихий номер с закатом над морем, 12–15 ноября, вдвоём"}'

Реестр характеристик

Каждая характеристика - данные: метод, срок годности, вопрос отелю

GET /api/v1/characteristics

cURL

curl 'https://okno-api.fly.dev/api/v1/characteristics'

Подборки

Сколько отелей подходит под настроение в выбранный месяц

GET /api/v1/moods?month=11

cURL

curl 'https://okno-api.fly.dev/api/v1/moods?month=11'