Tmp.CjEaIYrjQd

核心用法

zola-mcp 是一个面向 Zola 婚礼规划平台的开源 MCP 服务器，通过 27 个细粒度工具实现婚礼全生命周期管理。该技能采用非官方移动 API（mobile-api.zola.com）进行数据交互，需通过 JWT Refresh Token 或 fetchproxy 浏览器扩展完成身份认证。

功能模块

| 领域 | 工具数 | 典型场景 |

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

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

| **预算追踪** | 2 | 查看总览、修改单项费用与备注 |

| **宾客管理** | 4 | 按家庭单位增删改查宾客信息 |

| **座位编排** | 4 | 创建座位图、分配宾客到具体席位 |

| **咨询沟通** | 3 | 聚合商家询价对话、标记已读 |

| **活动与 RSVP** | 3 | 追踪各场次回复状态、修改活动详情 |

| **礼金登记** | 2 | 查看礼物清单、追踪感谢信发送状态 |

| **发现探索** | 4 | 搜索本地商家、收藏心仪供应商 |

认证方式

• 推荐路径：安装 fetchproxy 扩展 0.3.0，登录 zola.com 后自动读取 HttpOnly Cookie
• 手动路径：从 DevTools 复制 usr Cookie 值作为 ZOLA_REFRESH_TOKEN，有效期约 1 年

显著优点

1. 端到端覆盖：唯一将 Zola 平台数据操作原子化为可编程工具的开源方案，替代繁琐的手动网页操作
2. Claude Code 原生集成：支持 .mcp.json 配置，可直接在对话中执行复杂工作流（如"把未婚 RSVP 的宾客移到备用桌"）
3. 自动化就绪：基于 Node.js 与标准 MCP 协议，易于接入 CI/CD 或定时任务（如每日预算报告推送）
4. 隐私优先：fetchproxy 模式避免硬编码长期凭证，Token 自动复用浏览器会话

潜在局限与风险

| 类别 | 说明 |

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

| **API 非官方** | 使用未文档化的移动端私有 API，存在接口变更导致工具失效的风险 |

| **Token 有效期** | Refresh Token 约 1 年过期，需手动重新授权；无 OAuth 自动刷新机制 |

| **功能边界** | 不支持创建全新婚礼项目（需先在 Zola 网页端初始化），仅限数据操作 |

| **并发与速率** | 未披露速率限制，高频调用可能触发平台风控 |

适合人群

• 准新人：希望通过自然语言快速查询婚礼进度、批量调整座位或追踪 RSVP
• 婚礼策划师：需要为多位客户维护数据，可通过脚本自动化常规报告生成
• 开发者：研究非官方 API 调用模式，或构建婚礼相关的第三方效率工具

常规风险

• 账户安全：Refresh Token 等同于长期登录凭证，泄露可导致婚礼隐私数据暴露；建议配置环境变量而非硬编码
• 服务连续性：Zola 平台可随时调整 API 接口，导致工具集部分或全部不可用
• 数据一致性：高频并发修改可能存在竞态条件，关键操作（如预算调整）建议人工复核