核心用法
API Gateway 是 Maton 提供的托管式 API 路由服务，让用户无需自行管理 OAuth 凭证即可安全调用 150+ 第三方 SaaS 服务（Slack、HubSpot、Salesforce、Notion、Google Workspace 等）。核心使用模式为：
1. 认证：通过 maton login 获取 MATON_API_KEY，设置为环境变量
2. 建连：使用 maton connection create {app} 创建服务连接，完成 OAuth 授权
3. 调用：通过 https://api.maton.ai/{app}/{native-api-path} 或直接运行 maton {app} {command} 访问原生 API
4. 管理：使用 --connection 参数指定多账户场景，支持连接状态查询与删除
关键约束：写操作（POST/PUT/PATCH/DELETE）默认被拦截，必须获取用户明确确认——包括目标账户、资源ID、操作内容及预期效果——方可执行。
显著优点
- 零凭证管理：OAuth 令牌由 Maton 托管加密存储，用户仅需保管单一
MATON_API_KEY - 广泛集成：覆盖 150+ 主流服务，从 CRM、项目管理到 AI 模型推理（如 fal.ai、ElevenLabs）
- 多语言支持：CLI、Python、JavaScript/Node.js、curl 等调用方式齐全，示例丰富
- 企业级安全：TLS 1.3 加密、最小权限原则、连接级隔离、支持多账户区分
- 透明路由：直接透传第三方原生 API，保留完整功能与文档兼容性
潜在缺点与局限性
- 网络依赖：必须保持与
api.maton.ai的连通，无法离线使用 - 速率限制：10 req/s 每账户，高频场景需自行实现重试与限流
- 服务商耦合：第三方 API 变更或权限范围调整可能影响可用性
- 功能边界：仅代理已有服务，不支持自定义私有 API 接入
- 延迟开销：相比直连增加一跳路由，对实时敏感场景或显瓶颈
适合人群
- 多 SaaS 运营团队：需统一管理 Slack、Notion、HubSpot 等 10+ 服务的自动化工作流
- 无后端开发者：快速构建集成原型，无需搭建 OAuth 服务器
- 安全合规企业：希望集中审计 API 调用、避免密钥分散存储的组织
- AI Agent 构建者：为 LLM 提供标准化工具调用接口，降低接入成本
常规风险
| 风险类别 | 说明 | 缓解建议 |
|---------|------|---------|
| 凭证泄露 | `MATON_API_KEY` 一旦泄露，所有连接服务面临风险 | 使用环境变量、定期轮换、禁止日志打印 |
| 过度授权 | OAuth 范围申请过大，导致潜在数据暴露 | 仅申请任务必需 scope，定期审计连接列表 |
| 误操作风险 | 批量删除、发送消息、财务操作需二次确认 | 严格遵守"先读取验证、后写入确认"协议 |
| 服务商可用性 | Maton 或目标服务中断导致调用失败 | 关键路径实现熔断降级，监控状态码 |
| 数据驻留 | 敏感数据流经 Maton 网关 | 评估数据分类，必要时选择直连方案 |
综合评估
该 Skill 作为纯文档型网关，本身无可执行代码，安全风险极低（S+ 级）。实际风险集中于用户侧的密钥管理与操作规范。适合追求快速集成、降低 OAuth 复杂度的场景，但高吞吐量或强实时性需求需评估架构成本。