Tmp.CjEaIYrjQd

核心用法

zola-mcp 是一个基于 Model Context Protocol (MCP) 的服务器，通过与 Zola 官方移动 API (mobile-api.zola.com) 对接，提供 30 个工具函数，覆盖婚礼规划的完整生命周期。用户需提供 ZOLA_REFRESH_TOKEN（有效期约 1 年的 JWT refresh token）或通过 fetchproxy 扩展自动获取认证凭证。

核心功能模块

| 模块 | 工具数 | 典型场景 |

|------|--------|---------|

| 供应商管理 | 5 | 搜索、预订、更新、取消婚礼服务商 |

| 预算追踪 | 2 | 查看婚礼总预算、调整单项费用 |

| 宾客管理 | 4 | 添加宾客组、更新地址、移除名单 |

| 座位编排 | 4 | 创建座位图、分配宾客到指定座位 |

| 询价管理 | 3 | 查看供应商对话、标记已读 |

| 活动与 RSVP | 6 | 追踪回复状态、批量邀请、管理多场次活动 |

| 礼品登记 | 2 | 查看注册清单、追踪礼物及感谢状态 |

| 发现与收藏 | 4 | 搜索市场商家、查看婚礼仪表盘 |

认证方式

• 推荐方案：安装 fetchproxy 0.3.0 扩展，登录 zola.com 后自动读取 HttpOnly usr cookie
• 备选方案：手动从 DevTools 复制 usr cookie 值作为 ZOLA_REFRESH_TOKEN

显著优点

1. 官方 API 直连：直接调用 Zola 移动后端，数据实时同步，非爬虫方案
2. 完整功能覆盖：30 个工具涵盖从预算到座位图的全流程，是目前最全面的婚礼规划 MCP 服务器
3. 智能自动化：支持批量操作（如批量设置活动宾客）、自动解析账户/注册表 ID
4. 开发者友好：清晰的工具命名、详尽的工作流示例、支持 Claude Code 直接集成

潜在缺点与局限性

| 问题 | 说明 |

|------|------|

| 认证门槛 | 需手动获取 refresh token 或安装浏览器扩展，对非技术用户不够友好 |

| 令牌有效期 | ~1 年过期后需重新认证，无自动续期机制 |

| 平台锁定 | 仅支持 Zola 平台，无法迁移到其他婚礼规划工具 |

| API 稳定性风险 | 依赖未公开的移动 API，Zola 可能随时变更端点或加强防护 |

| 无官方背书 | 社区开源项目，非 Zola 官方开发，无 SLA 保障 |

适合人群

• 准新人/婚礼策划师：需要批量管理数百宾客 RSVP 和复杂座位编排
• 开发者/技术用户：希望将婚礼数据接入自定义工作流或自动化脚本
• Claude Code 用户：寻求在 AI 对话中直接查询和修改婚礼规划数据

常规风险

• 隐私敏感：涉及宾客姓名、地址、礼物金额等 PII 数据，需确保 MCP 服务器配置在安全环境
• 误操作风险：remove_vendor、remove_guest 等删除操作不可逆，建议操作前确认
• API 变更风险：非官方集成可能因 Zola 更新而中断，需关注上游仓库更新