核心用法
Acuity Scheduling Skill 是一个基于 Maton 网关的 API 代理服务，允许用户通过统一的 API Key 和托管 OAuth 方式访问 Acuity Scheduling 的全部功能。该 Skill 支持完整的预约生命周期管理，包括创建、查询、修改、取消和改期预约；日历和预约类型管理；客户信息维护；可用性查询；以及时间块（Blocks）和表单的管理。
用户首先需要设置 MATON_API_KEY 环境变量，然后通过 https://ctrl.maton.ai 管理 OAuth 连接。连接建立后，所有请求通过 https://gateway.maton.ai/acuity-scheduling/{resource} 代理到 Acuity 官方 API。对于多连接场景，可通过 Maton-Connection 头部指定特定连接。
显著优点
1. 托管 OAuth 简化集成：无需自行处理 OAuth 流程，Maton 负责令牌管理和刷新，降低开发复杂度
2. 统一认证层：单一 API Key 访问多个 Acuity 账户，适合代运营或多租户场景
3. 完整功能覆盖：支持预约、日历、客户、可用性查询、时间块、标签、表单等全量 API
4. 多语言示例：提供 Python、JavaScript、Bash 等丰富的代码示例，降低接入门槛
5. 连接可视化管理：通过 ctrl.maton.ai 可以查看、创建、删除连接，并获取 OAuth 授权链接
潜在缺点与局限性
1. 网关依赖：所有请求必须通过 Maton 网关，存在单点故障风险和服务可用性依赖
2. 功能代理限制：作为代理层，部分 Acuity 原生功能（如 Webhook 配置）可能无法直接通过网关暴露
3. 调试复杂度：错误需要区分是网关层问题还是 Acuity API 本身问题，增加了排查难度
4. 环境变量敏感性：文档多次强调 API Key 环境变量在管道传输时的扩展问题，表明实际使用中存在常见陷阱
5. 客户数据限制：客户更新/删除仅支持已有预约的客户，部分操作存在业务逻辑限制
适合人群
- 需要自动化预约管理的中小企业和服务型商家
- 代运营服务商管理多个客户 Acuity 账户的场景
- 希望将预约系统与其他业务系统（CRM、ERP）集成的开发者
- 无服务器/函数计算场景下需要简化 OAuth 管理的项目
常规风险
- 认证信息泄露：
MATON_API_KEY作为唯一凭证，一旦泄露可导致所有连接的 Acuity 数据被访问 - OAuth 授权风险：用户需点击 Maton 生成的链接完成授权，存在钓鱼链接伪造风险（需确认域名真实性）
- 数据隐私合规：客户 PII（姓名、邮箱、电话）流经 Maton 网关，需评估是否符合 GDPR/CCPA 等法规
- 服务连续性：Maton 作为第三方网关，其服务条款、数据保留政策、业务持续性需审慎评估
- 速率限制：Acuity API 本身存在限流，高频调用场景需实现退避重试机制