Roomy360

Roomy360 Developers

Бронирование в AI-агентах

Тот же guest API — поиск, цена, заявка. Хост подтверждает. Выберите один способ ниже.

Получить API-ключиAI-чат на сайтеБыстрый старт

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

Четыре входа — достаточно одного.

Гости

AI-чат на сайте

Гость входит и пишет в /ai. Без API-ключа. Инструменты на нашей стороне.

Открыть AI-чат →Ссылка

Custom GPT

Ссылка ChatGPT. Гость проходит OAuth Roomy360, Actions → /api/v1.

К разделу ChatGPT →Разработчики

MCP / коннекторы

Cursor, Claude, Gemini, Grok, ChatGPT connector → https://roomy360.com/mcp

Настройка MCP →Аккаунт

API-ключи

Ключи r360_sk_… для stdio MCP или Bearer-клиентов.

Управление ключами →

Эндпоинты

MCP (Streamable HTTP)

https://roomy360.com/mcp

OAuth authorize

https://roomy360.com/oauth/authorize

Инструменты агента

Шесть B2C-tools поверх публичного API гостя.

  • search_stays

    Поиск опубликованных объектов.

  • get_property

    Карточка, юниты, цены.

  • get_availability

    Календарь на даты.

  • create_quote

    Расчёт до заявки.

  • request_booking

    Hold / заявка (идемпотентно).

  • list_my_bookings

    Брони аккаунта ключа.

request_booking → pending_host. Хост подтверждает — мгновенного списания нет.

MCP-клиенты

Локальный stdio или remote HTTP. Для remote лучше OAuth; Bearer — где клиент позволяет.

  • Cursor / Claude Desktop

    stdio

    Локальный roomy360-mcp + ROOMY360_API_BASE и ROOMY360_AGENT_TOKEN.

  • ChatGPT Custom GPT

    Actions + OAuth

    Ссылка ниже. OAuth, затем Actions /api/v1 — не MCP URL.

  • ChatGPT / Gemini / Grok MCP

    HTTP + OAuth

    Connector URL https://roomy360.com/mcp с OAuth (mcp-connector) или Bearer.

Remote MCP и Custom GPT Actions — OAuth 2.1 (PKCE). Клиенты: mcp-connector и chatgpt-gpt-actions. Нужен verified email.

Custom GPT (ChatGPT)

Unlisted GPT с OAuth — поиск и заявка хосту из чата.

Ссылка ещё не опубликована. Пока — AI-чат на сайте или MCP.

Или AI-чат на Roomy360 →

Быстрый старт (ключ + MCP)

Для Cursor / Claude / remote-коннекторов.

  1. 01

    1. Войдите

    Гостевой аккаунт с подтверждённым email.

  2. 02

    2. Создайте API-ключ

    Аккаунт → API-ключи. Секрет один раз — храните как пароль.

  3. 03

    3. Подключите

    stdio (Cursor/Claude) или https://roomy360.com/mcp + Bearer / OAuth.

Remote (без бинаря)

https://roomy360.com/mcp + Authorization: Bearer <API key> или OAuth.

Переменные (stdio)

  • ROOMY360_API_BASE — https://roomy360.com
  • ROOMY360_AGENT_TOKEN — ключ из Аккаунт → API-ключи

Сборка MCP-бинаря

Go 1.24+ из монорепо или артефакты CI (darwin/linux/windows).

go build -o bin/roomy360-mcp ./apps/mcp

GitLab job build:mcp-binaries на зелёном main → dist/mcp/.

Pipelines GitLab

Cursor / Claude Desktop (stdio)

{
  "mcpServers": {
    "roomy360": {
      "command": "/absolute/path/to/bin/roomy360-mcp",
      "env": {
        "ROOMY360_API_BASE": "https://roomy360.com",
        "ROOMY360_AGENT_TOKEN": "r360_sk_live_…"
      }
    }
  }
}

После отзыва ключ может приниматься до ~15 с (кэш).

~120 req/мин на IP, ~60/мин на ключ. При 429 — пауза.

request_booking передаёт имя и телефон — только согласованные данные.

Готово начать?

Ключ, MCP или AI-чат на сайте.

Управление API-ключамиКонфиденциальность