核心用法
zola-mcp 是一款基于 Model Context Protocol (MCP) 的服务器，通过调用 Zola 官方移动 API (mobile-api.zola.com)，让用户能够以对话方式管理婚礼筹备的各个环节。该技能封装了 30 个工具，覆盖七大核心模块：供应商管理（Vendor）、预算控制（Budget）、宾客名单（Guests）、座位安排（Seating）、供应商咨询（Inquiries）、活动与 RSVP（Events）、礼品登记（Registry），以及婚礼市场探索（Discovery）。
用户可通过自然语言指令完成复杂操作，例如：查询 RSVP 状态、批量邀请宾客参加彩排晚宴、为特定宾客分配座位、更新场地费用，或在特定城市搜索摄影师等。配置方式灵活，支持通过 npm 直接安装或从源码构建，身份验证依赖 Zola 的 JWT refresh token（有效期约一年）。
显著优点
1. 全流程覆盖：30 个工具几乎涵盖婚礼筹备的所有关键场景，从前期供应商询价到婚后礼品追踪，实现一站式管理。
2. 自然语言交互：用户无需学习 Zola App 的复杂界面，通过对话即可完成批量操作（如批量设置宾客邀请、批量更新预算项）。
3. 自动化集成：支持 fetchproxy 扩展实现 token 自动刷新，减少手动维护成本；账户和注册表 ID 自动解析，降低配置门槛。
4. 数据实时同步：直接对接 Zola 官方移动 API，确保数据与移动端 App 保持一致。
潜在缺点与局限性
1. 认证依赖风险：需获取 Zola 的 HttpOnly usr cookie 或 refresh token，存在 token 过期（约一年）需手动更新的问题。
2. 非官方集成：由第三方开发者（chrischall）维护，非 Zola 官方出品，存在 API 变更导致服务中断的风险。
3. 功能边界：仅支持读取和基础 CRUD 操作，不支持 Zola 的某些高级功能（如自定义婚礼网站设计、在线支付处理）。
4. 隐私顾虑：婚礼数据（宾客地址、预算、礼品信息）需通过第三方 MCP 服务器传输，用户对数据流的控制力有限。
适合人群
- 准新人：希望用自然语言高效管理婚礼筹备，避免在多个 App 间切换。
- 婚礼策划师：需要批量操作客户婚礼数据，快速生成报告或调整安排。
- 技术用户：熟悉 MCP 生态，希望在 Claude Code 等环境中集成婚礼管理工具。
常规风险
- token 泄露风险：
ZOLA_REFRESH_TOKEN需妥善保管，泄露可能导致婚礼数据被未授权访问。 - API 变更风险：Zola 官方可能调整移动 API，导致工具失效或数据异常。
- 数据同步延迟：极少数情况下，第三方 MCP 操作可能与官方 App 存在短暂延迟。