如何通过 MCP 将 Lodgify 连接到 Cursor

💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Lodgify、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无 git clone、无本地服务器。

Lodgify + Cursor

使用 Lodgify 管理度假租赁：房源和房型、空房日历、每晚价格和报价、预订和咨询、与房客的消息会话、入住和退房、门锁密码以及预订状态变更。使用账户的 Public API 密钥。

前提条件

完整的设置说明已内置在连接器中 (在 store 中选择连接器时可见)。所需环境变量:

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，或与 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 — 在 Cursor 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 此连接器所在的服务器，复制它的 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都用它替换。

Cursor 从 ~/.cursor/mcp.json 读取 MCP 服务器。添加以下条目：

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

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 中创建 MCP API 密钥，并用它替换 YOUR_MCP_API_KEY。
2. 保存文件并重启 Cursor。
3. 打开 Cursor → Settings → MCP，确认 anythingmcp 已列出并处于已连接状态。
4. 开始对话，智能体现在可以调用 Lodgify 的工具。

可用工具

示例提示

• “今天哪些房客入住我们的房源？列出房客姓名、房源、人数和待付金额。”
• “Sea View Apartment 7 月 12 日到 19 日能住 2 位成人和一只狗吗？费用是多少？”
• “哪些房客消息还没回复？把每个会话总结一下。”
• “为预订 1234567 设置钥匙盒密码 4821，并起草一条发给房客的入住消息。发送前先给我看。”
• “为 Laura Bianchi 创建 Garden Studio 3 月 3 日到 7 日的预订，并确认。”

FAQ

Cursor 免费套餐支持自定义 MCP 服务器吗？ 支持，Hobby、Pro 和 Business 套餐均可使用 MCP。

下一步

• 连接器主页
• 连接到 Claude
• 连接到 ChatGPT
• 连接到 Gemini
• 连接到 Meta Muse
• 连接到 Microsoft Copilot