核心用法
Trello skill 是 Maton 平台提供的托管式 Trello API 集成服务，通过统一的网关代理 (gateway.maton.ai) 将用户请求转发至官方 Trello API，并自动注入 OAuth 令牌完成鉴权。用户需先在 Maton 平台获取 API Key，再通过 ctrl.maton.ai 管理 Trello OAuth 连接。认证完成后，可调用完整的 RESTful 接口操作看板(Boards)、列表(Lists)、卡片(Cards)、成员(Members)、标签(Labels)和清单(Checklists)等核心资源。
API 采用路径透传设计，将原生 Trello API 路径拼接至 https://gateway.maton.ai/trello/{native-api-path} 即可。支持多连接管理，可通过 Maton-Connection 请求头指定特定连接。所有请求需在 Header 中携带 Authorization: Bearer $MATON_API_KEY。
显著优点
1. OAuth 托管简化: 无需自行维护 Trello 应用的 Client ID/Secret，Maton 统一处理令牌生命周期，降低集成门槛。
2. 完整 API 覆盖: 支持官方 API 的所有核心功能，包括看板 CRUD、卡片移动、清单管理、成员协作、全局搜索等。
3. 多语言示例: 提供 Bash(curl)、Python、JavaScript 等完整代码示例，开发者可快速上手。
4. 连接管理灵活: 支持多账号 OAuth 连接，可为不同工作区配置独立连接并通过 Header 切换。
5. 透明代理架构: 直接透传 Trello 原生错误码和响应格式，便于调试和对照官方文档。
潜在缺点与局限性
1. 平台锁定风险: 必须依赖 Maton 网关和 API Key，若服务中断或定价变化，迁移成本较高。
2. 速率限制: 共享 10 req/sec 的账户级限速，高并发场景可能成为瓶颈。
3. 网络依赖: 所有请求必须经 Maton 网关中转，无法直连 Trello 服务器，增加单点故障风险。
4. 调试复杂度: 多层代理架构下，OAuth 令牌由平台自动注入，用户无法直接查看或调试令牌问题。
5. 功能滞后: 新特性需等待 Maton 网关适配，可能无法第一时间使用 Trello 最新 API。
适合人群
- 需要快速集成 Trello 但不愿自建 OAuth 应用的开发团队
- 使用 Maton 生态的多账户项目管理场景
- 希望通过代码自动化看板工作流的技术从业者
- 中小型团队的项目管理自动化需求
常规风险
- 密钥泄露:
MATON_API_KEY为全局凭证，若泄露可能导致所有连接被滥用，建议配合环境变量和密钥管理服务使用。 - 数据隐私: 看板内容经 Maton 网关中转，需评估第三方平台的数据处理协议。
- 误操作风险: 支持卡片/看板删除等不可逆操作，生产环境建议配合备份策略。