roomesto.com
Путівники

Підключіть пошук готелів Roomesto до вашого AI-асистента

roomesto.com працює з публічним MCP-сервером. Підключіть його один раз — і Claude Desktop, Cursor або будь-який інший MCP-клієнт знайде для вас актуальні ціни та наявність готелів у звичайній розмові.

Ліміти запитів

  • Без реєстрації — до 10 запитів на день з однієї IP-адреси.
  • З особистим ключем (безкоштовно, для зареєстрованих користувачів) — до 100 запитів на день.
  • Лічильники скидаються опівночі за UTC.

1Отримайте особистий ключ

Зареєструйтеся або увійдіть, потім відкрийте сторінку облікового запису — ваш ключ готовий у розділі «MCP Access»: Відкрити «Мій обліковий запис» →

2Адреса сервера

Додайте цю URL-адресу до вашого MCP-клієнта як віддалений HTTP-сервер:

https://roomesto.com/mcp

3Додайте сервер до конфігурації

Claude Desktop / Cursor (mcp.json / claude_desktop_config.json):

{
  "mcpServers": {
    "roomesto": {
      "url": "https://roomesto.com/mcp",
      "headers": { "Authorization": "Bearer rms_YOUR_KEY" }
    }
  }
}

Або один рядок у терміналі (Claude Code):

claude mcp add --transport http roomesto https://roomesto.com/mcp --header "Authorization: Bearer rms_YOUR_KEY"

Що можна запитати

  • «Готелі в Римі біля фонтану Треві, 12–15 вересня, до €150 за ніч»
  • «Сімейний готель в Анталії з дитячим клубом та системою «все включено»»
  • «Порівняйте 4-зіркові готелі в центрі Стамбула для відпочинку на вихідні»
  • «Найдешевший готель біля моря в Сочі для двох у липні»

Бронювання через MCP

Зареєстрований мандрівник може завершити бронювання через те саме MCP-підключення. Інструменти працюють по кроках, тому мандрівник бачить фінальну ціну та умови до створення замовлення й списання.

  1. search_hotels знаходить актуальні пропозиції; get_hotel_rates повертає номери, способи оплати, податки та умови скасування від постачальника.
  2. prepare_booking повторно перевіряє вибраний тариф і приймає дані всіх гостей. У разі повтору запиту передавайте той самий request_id.
  3. tokenize_booking_card використовується лише тоді, коли вибраний тариф потребує картки. Номер картки й CVC надсилаються до наявного платіжного провайдера і не зберігаються на сервері MCP.
  4. confirm_booking вимагає явного підтвердження точної суми та валюти мандрівником. Далі get_booking_status відстежує підтвердження або перевірку банку, а cancel_booking просить скасувати бронювання, створене тим самим ключем.

Якщо щось піде не так

  • 429 «Щоденний безкоштовний ліміт вичерпано» — добова квота використана. Вона скидається опівночі за UTC; зареєструйтеся, щоб отримати 100 запитів на день з особистим ключем.
  • 401 «невідомий API-ключ» — переконайтеся, що весь ключ, починаючи з rms_, скопійовано без зайвих пробілів.

Для AI-агентів і краулерів: llms.txt