核心用法
zola-mcp 是一套专为 Zola 婚礼平台打造的 Model Context Protocol (MCP) 服务器，通过逆向工程 Zola 移动 API（mobile-api.zola.com）实现 30 余项婚礼管理功能的无缝自动化操作。用户需配置 JWT 刷新令牌（ZOLA_REFRESH_TOKEN）或通过 fetchproxy 浏览器扩展自动获取 Cookie 认证，即可在 Claude Code 等支持 MCP 的 AI 环境中直接管理婚礼事务。
工具覆盖六大核心模块：供应商管理（搜索、预订、更新、取消）、预算追踪（收支明细、实时调整）、宾客管理（分组添加、地址更新、批量删除）、座位编排（可视化图表、自动分配）、活动与 RSVP（多场次邀请、状态追踪）、登记与礼物（礼品清单、致谢状态）。另含发现工具用于浏览 Zola 商家市场。
显著优点
1. 全流程自动化：打破 Zola 官方仅提供网页端手动操作的限制，AI 可直接执行「将 Jennifer 安排至 1 号桌」「批量邀请所有亲属参加彩排晚宴」等复杂指令。
2. 实时数据同步：直接对接官方移动 API，操作结果即时反映于 Zola App 与网页端，无延迟。
3. 智能工作流：内置 8 条典型场景指令模板，从仪表盘概览到供应商沟通，降低新手学习成本。
4. 认证灵活：支持手动令牌与 fetchproxy 自动 Cookie 提取双模式，兼顾技术用户与便捷需求。
潜在缺点与局限性
- 非官方性质：项目为个人逆向工程（GitHub: chrischall），无 Zola 官方背书，API 变更可能导致功能中断。
- 认证门槛：需理解 JWT/HttpOnly Cookie 机制，普通用户配置存在学习曲线；令牌年有效期需手动续期。
- 隐私敏感：婚礼数据含宾客联系方式、家庭住址、财务信息，本地存储令牌存在泄露风险。
- 功能边界：仅覆盖移动 API 暴露端点，部分网页端高级定制功能（如主题深度定制）可能缺失。
适合人群
- 技术型备婚新人：熟悉命令行与 API 配置，希望用 AI 自动化繁琐的婚礼统筹工作。
- 婚礼策划师：需批量管理多客户 Zola 账户的专业人士。
- 情侣开发者：希望自建婚礼数据仪表盘或集成第三方通知系统的用户。
常规风险
- 账户安全：令牌泄露可能导致婚礼数据被恶意读取或篡改，建议配合环境变量加密管理（如
.env文件权限控制）。 - 服务连续性：依赖 Zola 移动 API 稳定性，官方接口变更或封禁非官方客户端可能导致服务中断。
- 数据合规：自动化批量操作可能违反 Zola 服务条款，存在账户限制风险。