核心用法
zola-mcp 是一个基于 Model Context Protocol (MCP) 的服务器，通过逆向 Zola 移动 API (mobile-api.zola.com) 提供 27 个工具，覆盖婚礼策划的完整生命周期：
- 供应商管理：搜索、预订、更新婚礼服务商（摄影师、场地、餐饮等）
- 预算控制：查看总预算明细，调整单项费用与备注
- 宾客管理：批量导入宾客 household、更新邮寄地址、移除宾客
- 座位编排：创建多版本座位图、智能分配宾客到指定座位、追踪未入座宾客
- RSVP 追踪：按活动统计出席确认状态，识别未回复宾客
- 礼品登记：浏览婚礼 registry、追踪收到的礼物价值及感谢信发送状态
- 供应商询盘：集中管理 vendor 询价对话，标记已读未读
认证依赖 ZOLA_REFRESH_TOKEN（~1 年有效期）或 fetchproxy 浏览器扩展自动获取 HttpOnly cookie。支持 Claude Code 直接集成或源码本地部署。
显著优点
1. 全功能覆盖：27 个工具原生对应 Zola 官方几乎所有核心功能，无需网页来回切换
2. 对话式操作：自然语言即可查询 "谁还没 RSVP"、"把 Jennifer 安排到 1 桌"
3. 实时数据同步：直接调用官方移动 API，数据与 Zola App 完全一致
4. 灵活认证路径：fetchproxy 浏览器扩展实现无感登录，降低 token 管理负担
潜在缺点与局限
- 非官方实现：依赖个人逆向工程，Zola 官方 API 变更可能导致功能中断
- 单点认证风险：refresh token 泄露意味着完整账户接管（含支付信息、宾客隐私数据）
- 缺乏审计日志：所有操作通过 MCP 执行，Zola 后台可能难以区分人工与自动化操作
- 地理位置限制：供应商搜索主要面向北美市场，其他地区支持有限
- 依赖第三方扩展：fetchproxy 方案需安装未经验证的浏览器扩展
适合人群
- 正在使用 Zola 进行婚礼策划且偏好命令行/AI 辅助工作流的用户
- 需要批量处理宾客名单、座位表等重复性操作的情侣或婚礼策划师
- 希望将婚礼数据整合到个人知识库或自动化工作流的技术用户
常规风险
| 风险类型 | 说明 |
|---------|------|
| 账户安全 | JWT refresh token 需妥善保管，建议配合密码管理器使用 |
| 数据隐私 | 宾客姓名、地址、联系方式流经第三方 MCP 服务器 |
| 服务稳定性 | 非官方项目，无 SLA 保障，API 变更可能导致功能失效 |
| 操作不可逆 | 删除宾客、取消供应商等操作无二次确认机制，需谨慎 |
| 法律合规 | 自动化抓取可能违反 Zola ToS，存在账户封禁风险 |