Как подключить Lodgify к Cursor через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Lodgify, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Lodgify + Cursor

Управление посуточной арендой в Lodgify: объекты и типы номеров, календари доступности, цены за ночь и расчёт стоимости, бронирования и запросы, переписка с гостями, заезд и выезд, коды доступа и смена статуса бронирований. Работает с ключом Public API аккаунта.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

LODGIFY_API_KEY

Шаг 1 — Получите учётные данные

Настройка занимает около 2 минут. Понадобится владелец аккаунта Lodgify: только он видит API-ключ.

1. В Lodgify (https://app.lodgify.com) откройте Settings > Public API и скопируйте API-ключ.
2. Вставьте его в LODGIFY_API_KEY. Он отправляется в заголовке X-ApiKey.
3. Установите коннектор и запустите lodgify_list_properties, чтобы проверить ключ.

Ключ даёт полный доступ к аккаунту: все, кто пользуется коннектором, работают со всеми объектами, бронированиями и перепиской с гостями этого аккаунта.

Что он читает:

• Объекты и типы номеров: lodgify_list_properties, lodgify_get_property, lodgify_list_property_rooms (id типов номеров, нужные для цен, доступности, расчётов и бронирований), lodgify_get_room, объекты, удалённые с определённой даты, а также дополнительные услуги и способы оплаты объекта.
• Доступность: календарь всего аккаунта, одного объекта или одного типа номера за период, при желании с бронированиями и закрытыми периодами, которые блокируют даты.
• Цены: цена за ночь и минимальный срок проживания по дням (lodgify_get_rates_calendar), настройки тарифов (налоги, сборы, депозит, правила отмены, цена за дополнительного гостя) и lodgify_get_quote, итог возможного проживания с ценой номера, сборами, налогами, допуслугами и промокодом.
• Бронирования: lodgify_list_bookings с stay_filter Upcoming, Current, Historic, All или ArrivalDate и DepartureDate вместе с stay_filter_date (например, сегодняшние заезды); lodgify_get_booking с гостем, номерами, суммами, оплаченной и оставшейся суммой, заметками, кодами доступа и перепиской; связанные бронирования каналов (Airbnb, Booking.com, Vrbo, ...); расчёт стоимости бронирования и ссылка на оплату для гостя.
• Входящие: lodgify_list_inbox (бронирования и запросы вместе, сначала новые), lodgify_count_unread, lodgify_get_enquiry и lodgify_get_thread по thread_uid бронирования или запроса.

Что он записывает:

• Новое бронирование: ИИ проверяет lodgify_get_room_type_availability и lodgify_get_quote, затем вызывает lodgify_create_booking. Статус там Lodgify игнорирует, поэтому затем ИИ подтверждает бронирование через lodgify_set_booking_booked или держит даты через lodgify_set_booking_tentative. С from_enquiry_id существующий запрос превращается в бронирование.
• Смена статуса: lodgify_decline_booking (даты снова свободны) и lodgify_reopen_booking (обратно в Open; бронирование в статусе Booked освобождает свои даты).
• Заезд и выезд: lodgify_update_key_codes задаёт коды двери или ключницы, которые видит гость; lodgify_check_in_booking и lodgify_check_out_booking фиксируют время заезда и выезда.
• Сообщения: lodgify_add_booking_messages и lodgify_add_enquiry_messages добавляют сообщения в переписку; тип Comment сохраняет внутреннюю заметку, которую гость не видит. lodgify_mark_booking_replied и lodgify_mark_booking_not_replied отмечают переписку во входящих как отвеченную или нет.

Письма гостям: сообщения с send_notification: true, lodgify_request_payment и request_payment: true при смене статуса отправляют гостю email. ИИ показывает вам текст и ждёт вашего согласия перед отправкой.

Отключено при установке: ничего. В коннекторе нет инструментов удаления, а отклонённое бронирование можно снова открыть через lodgify_reopen_booking.

Форматы данных: id объектов, типов номеров и бронирований являются целыми числами; переписка обозначается GUID (thread_uid). Даты в формате YYYY-MM-DD; время заезда и выезда HH:mm:ss в часовом поясе объекта; даты изменений в ISO 8601. Суммы в валюте объекта (currency_code), в основных единицах (120.5 = 120,50). Статус бронирования: Open (запрос), Tentative, Booked или Declined; source называет канал (Manual, AirbnbIntegration, BookingCom, ...).

Постраничный вывод: списки v2 принимают page (с 1) и size (по умолчанию 50); с include_count: true общее число приходит в count. lodgify_list_inbox использует offset и limit и возвращает total.

Частые ошибки: 401 или 403 означает отсутствующий или неверный API-ключ, 404 неизвестный id, 400 неверные даты или параметры (тело ответа говорит, какие). 429 означает лимит запросов: ИИ ждёт и повторяет попытку.

Коннектор не меняет цены и доступность, не создаёт ссылки на оплату, не управляет вебхуками и не переносит бронирования в корзину.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Cursor

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Cursor читает MCP-серверы из ~/.cursor/mcp.json. Добавь эту запись:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти Cursor.
3. Открой Cursor → Settings → MCP и проверь, что anythingmcp есть в списке и подключён.
4. Начинай общаться: агент теперь может вызывать инструменты Lodgify.

Доступные инструменты

Примеры запросов

• «Кто сегодня заезжает в наши объекты? Покажи имя гостя, объект, число гостей и оставшуюся к оплате сумму.»
• «Свободны ли Sea View Apartment с 12 по 19 июля для 2 взрослых и собаки, и сколько будет стоить проживание?»
• «На какие сообщения гостей мы ещё не ответили? Кратко перескажи каждую переписку.»
• «Установи код ключницы 4821 для бронирования 1234567 и подготовь гостю сообщение о заезде. Покажи его мне перед отправкой.»
• «Создай бронирование для Laura Bianchi в Garden Studio с 3 по 7 марта и подтверди его.»

FAQ

Поддерживает ли Cursor собственные MCP-серверы на бесплатном тарифе? Да, MCP доступен на тарифах Hobby, Pro и Business.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Gemini
• Подключить к Meta Muse
• Подключить к Microsoft Copilot