核心用法
Attio Skill 提供通过 Maton 代理服务访问 Attio CRM REST API 的能力，采用托管式 OAuth 认证模式。用户无需直接处理 Attio 的 OAuth 流程，只需在 Maton 平台完成一次授权，后续所有 API 调用均通过 MATON_API_KEY 进行身份验证。
该 Skill 支持完整的 CRM 数据生命周期管理：
- 对象与记录管理：查询、创建、更新、删除 People、Companies 等标准对象及自定义对象的记录
- 任务与协作：管理任务（创建、分配、完成状态）、添加评论、创建笔记
- 列表与视图：操作自定义列表（Lists）及其条目（List Entries）
- 会议与通话：访问会议记录和通话录音
- 工作区管理：查询工作区成员信息
API 路径遵循 /attio/v2/{native-api-path} 格式，Maton 自动将请求代理至 api.attio.com 并注入 OAuth Token。
显著优点
1. 零配置 OAuth：托管式认证免除开发者自建 OAuth 应用的复杂度，降低接入门槛
2. 多连接管理：支持同一 Maton 账户绑定多个 Attio 工作区，通过 Maton-Connection 头灵活切换
3. 完整 API 覆盖：涵盖 Attio v2 API 的核心能力，包括 Records、Tasks、Notes、Comments、Lists、Meetings 等
4. 标准化接口：统一的 REST 风格和错误处理模式，便于集成
潜在缺点与局限性
1. 依赖第三方代理：所有流量经由 Maton 中转，存在单点依赖风险；若 Maton 服务不可用则完全中断
2. 速率限制：Attio 原有限制为 100 读请求/秒、25 写请求/秒，代理层可能增加额外延迟
3. 权限粒度：OAuth 权限由 Attio 和 Maton 共同控制，部分高级功能（如 Webhooks）可能需要额外申请
4. 写操作需确认：系统要求对创建、更新、删除操作进行显式用户确认，可能增加交互步骤
5. 无原生 SDK：仅提供 HTTP API 接入，需自行封装各语言客户端
适合人群
- 希望快速集成 Attio CRM 的自动化工作流开发者
- 需要将 CRM 数据同步至其他系统的数据工程师
- 构建内部工具或 AI Agent 需要访问 CRM 上下文的产品团队
- 缺乏 OAuth 基础设施但需企业级 CRM 集成能力的中小型团队
常规风险
- 数据隐私：CRM 数据（联系人、公司信息、通话记录）流经第三方代理，需评估 Maton 的数据处理协议
- 令牌安全：
MATON_API_KEY泄露将导致所有连接的 Attio 账户暴露，需严格保管 - 授权撤销：用户可在 Attio 端撤销 OAuth 授权，导致连接突然失效
- API 变更：Attio API 版本升级可能导致兼容性问题