跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用,一键添加 Lodgify,然后将你的 AI 客户端(Claude、ChatGPT、Copilot 或 Cursor)指向生成的 MCP 端点。无需 Docker,无需 git clone,无需任何工程经验。
摘要
使用 Lodgify 管理度假租赁:房源和房型、空房日历、每晚价格和报价、预订和咨询、与房客的消息会话、入住和退房、门锁密码以及预订状态变更。使用账户的 Public API 密钥。
试试这样问
Lodgify 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Lodgify、粘贴凭证、生成 MCP API key,即可完成。无 Docker、无
git clone、无本地服务器。
Lodgify + ChatGPT
使用 Lodgify 管理度假租赁:房源和房型、空房日历、每晚价格和报价、预订和咨询、与房客的消息会话、入住和退房、门锁密码以及预订状态变更。使用账户的 Public API 密钥。
前提条件
完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:
LODGIFY_API_KEY
步骤 1 — 获取凭证
设置大约需要 2 分钟。只有 Lodgify 账户所有者能看到 API 密钥,所以需要所有者操作。
- 在 Lodgify(https://app.lodgify.com)中打开 Settings > Public API,复制 API 密钥。
- 把它粘贴到
LODGIFY_API_KEY。它通过X-ApiKey请求头发送。 - 安装连接器并运行
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,或与stay_filter_date搭配的 ArrivalDate 和 DepartureDate(例如今天到店的预订);lodgify_get_booking返回房客、房间、总额、已付和待付金额、备注、门锁密码和消息会话;还有关联的渠道预订(Airbnb、Booking.com、Vrbo 等)、预订报价和给房客的付款链接。 - 收件箱:
lodgify_list_inbox(预订和咨询合在一起,按时间倒序)、lodgify_count_unread、lodgify_get_enquiry,以及用预订或咨询的thread_uid调用的lodgify_get_thread。
可写入的操作:
- 新预订:AI 先查
lodgify_get_room_type_availability和lodgify_get_quote,再调用lodgify_create_booking。Lodgify 在这一步会忽略状态,所以 AI 随后用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 都会给房客发邮件。AI 会在发送前向你展示内容,等你确认。
安装时关闭:没有。此连接器没有删除工具,被拒绝的预订可以用 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 是频率限制:AI 会等待后重试。
此连接器不修改价格或空房,不创建付款链接,不管理 Webhook,也不把预订移到回收站。
步骤 2 — 安装 adapter
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 — 在 ChatGPT 中添加连接器
你的服务器 URL: 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器,复制它的 URL(
https://cloud.anythingmcp.com/mcp/…)。本指南中出现YOUR_SERVER_ID的地方都用它替换。
ChatGPT 在网页版的 Plugins 页面把 MCP 服务器添加为插件,仅付费套餐可用,不再需要开发者模式。在 Business 工作区中只有管理员和所有者可以添加;在 Enterprise 和 Edu 中,管理员可以授予 Create plugins with MCPs 权限。
- 前往 chatgpt.com/plugins,点击 Add,然后选择 Add custom MCP server。
- 填写名称,例如 Name:
Lodgify。 - 在 Connection 下的 Server URL 中填入
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID,Authentication 保持为 OAuth。 - 选择 I understand and want to continue,然后点击 Create as a plugin。ChatGPT 提示时,登录 AnythingMCP 并允许访问。
- 在个人插件中安装这个新插件,然后在对话中输入 @ 并选择它。
可用工具
| Tool | What it does |
|---|---|
lodgify_list_properties | List the properties (rentals) of the account with id, name, address, coordinates, currency, check-in and check-out times and room types |
lodgify_get_property | One property with address, description, amenities, rating, currency, room types and, optionally, check-in and check-out hours |
lodgify_list_property_rooms | Room types of a property with id, name, max people, bedrooms, bathrooms and amenities |
lodgify_get_room | Details of one room type of a property (Public API v1): name, description, max people, beds, images and amenities |
lodgify_list_deleted_properties | Properties deleted from the account since a date, so a synced list can drop them |
lodgify_list_property_addons | Add-ons (extras such as cleaning, pets or late check-out) that can be booked for a property, optionally only those valid for a stay and… |
lodgify_list_property_payment_options | Payment options configured for a property (for example bank transfer or card), useful when creating a booking |
lodgify_get_availability | Availability calendar of all properties and room types of the account for a period: for each day whether units are available, and with… |
lodgify_get_property_availability | Availability calendar of one property (all its room types) for a period, with the number of available units per period and, optionally, the… |
lodgify_get_room_type_availability | Availability calendar of one room type of a property for a period |
lodgify_get_rates_calendar | Nightly rates of a room type for a period: price per night, minimum stay and rate settings per day, in the property currency |
lodgify_get_rate_settings | Rate settings of a property: currency, taxes, fees, deposit and cancellation rules and the price per additional guest |
lodgify_get_quote | Price quote for a possible stay in one room type: total, breakdown of room rate, fees, taxes, add-ons and promotion, per rate plan |
lodgify_list_bookings | List bookings with id, property, room types, guest, arrival and departure, status (Booked, Tentative, Open, Declined), source (Manual… |
lodgify_get_booking | One booking with guest (name, email, phone, country), rooms and guest breakdown, status, source, totals, subtotals, amount paid and due… |
lodgify_list_external_bookings | Channel bookings (Airbnb, Booking.com, Vrbo, ...) linked to a Lodgify booking |
lodgify_get_booking_payment_link | The guest payment link of a booking's current quote, with amount and expiry, to share with the guest |
lodgify_get_booking_quote | The current quote of a booking (Public API v1): room rates, fees, taxes, discounts, add-ons, total and payment schedule |
lodgify_list_inbox | List the inbox (Public API v1): bookings and enquiries together, newest first, with status, property, guest, dates, replied and read flags |
lodgify_count_unread | Number of bookings and enquiries whose messages are not read yet |
lodgify_get_enquiry | One enquiry (a guest request that is not a booking yet) with guest, property, dates, people, status and messages |
lodgify_get_thread | The message thread of a booking or enquiry: guest name and email, read and closed flags and every message with sender, subject, text and… |
lodgify_create_booking | Create a booking for a property and stay (Public API v1); returns the new booking id |
lodgify_set_booking_booked | Confirm a booking: status Booked, the dates are blocked in the calendar. request_payment also emails the guest a payment request |
lodgify_set_booking_tentative | Set a booking to Tentative (dates held until it is confirmed or expires). request_payment also emails the guest a payment request |
lodgify_decline_booking | Decline a booking: status Declined, the dates become free again. lodgify_reopen_booking sets it back to Open |
lodgify_reopen_booking | Reopen a booking: status Open |
lodgify_check_in_booking | Check a booking in: record the time the guest arrived (or will arrive) on the booking |
lodgify_check_out_booking | Check a booking out: record the time the guest left (or will leave) on the booking |
lodgify_update_key_codes | Set the access key codes (door or lockbox codes) of the rooms of a booking, shown to the guest |
lodgify_add_booking_messages | Add messages to the thread of a booking, for example a reply to the guest or an internal comment |
lodgify_add_enquiry_messages | Add messages to the thread of an enquiry, for example an answer to a guest question |
lodgify_mark_booking_replied | Mark a booking's thread as replied, so it leaves the to-answer list in the inbox |
lodgify_mark_booking_not_replied | Mark a booking's thread as not replied, so it shows again in the to-answer list |
lodgify_request_payment | Email the guest a payment request for the next due amount of a booking |
示例提示
- “今天哪些房客入住我们的房源?列出房客姓名、房源、人数和待付金额。”
- “Sea View Apartment 7 月 12 日到 19 日能住 2 位成人和一只狗吗?费用是多少?”
- “哪些房客消息还没回复?把每个会话总结一下。”
- “为预订 1234567 设置钥匙盒密码 4821,并起草一条发给房客的入住消息。发送前先给我看。”
- “为 Laura Bianchi 创建 Garden Studio 3 月 3 日到 7 日的预订,并确认。”
FAQ
ChatGPT 免费套餐能用自定义 MCP 服务器吗? OpenAI 只为付费套餐提供自定义 MCP 服务器的说明,Free 套餐不在其列。
下一步
这份指南对你有帮助吗?