核心用法
Ogment CLI 作为 MCP（Model Context Protocol）工具的统一调用入口，将 Linear、Notion、Gmail、PostHog 等 100 余种 SaaS 服务封装为标准化工具接口。核心工作流遵循「状态检查 → 服务发现 → 工具列举 → 模式查看 → 工具调用」的五步闭环：
1. 认证管理：ogment auth status/login 处理 OAuth 设备流，人工在 dashboard.ogment.ai 批准后完成授权
2. 服务发现：ogment catalog 列出已连接的 MCP 服务器及工具数量
3. 工具调用：ogment invoke <server>/<tool> --input '<json>' 执行具体操作，支持 --debug 排障
4. 权限治理：所有工具访问通过 Ogment 仪表板逐代理配置，写操作默认受限
显著优点
- 统一治理层：单一 CLI 管理多 SaaS OAuth，无需分别维护各平台凭证
- 企业级安全：TLS 加密传输，无直连 SaaS API，凭证集中存储于
~/.config/ogment/ - 精细化权限：按代理粒度配置工具可见性，支持读写分离
- 结构化输出：标准 JSON 响应含
ok状态、error.category分类及next_actions建议 - 丰富调试能力：
--debug暴露原始 MCP 错误，jq过滤支持复杂查询
潜在局限
- 网络依赖：所有调用强制路由至
dashboard.ogment.ai，离线不可用 - 人工介入：OAuth 设备码需人工点击批准，无法实现完全自动化
- 权限摩擦：写工具默认禁用，需人工在仪表板开启，增加配置成本
- 服务耦合：SaaS 连接过期（HTTP 401）时需人工重新授权，中断工作流
- CLI 依赖：需全局安装 Node.js 包
@ogment-ai/cli，对环境有前置要求
适合人群
- 企业团队需集中治理 AI 代理对 SaaS 的访问权限
- 开发者希望以统一接口调用多平台 API 而无需分别处理 OAuth
- 需审计追踪的场景（通过 Ogment 仪表板查看代理工具使用记录）
常规风险
- 令牌泄露：
~/.config/ogment/credentials.json存储访问令牌，需确保文件权限 600 - 权限提升：若仪表板配置不当，代理可能获得超出预期的写权限
- 供应链风险：
@ogment-ai/cli包的更新需审计，避免恶意版本 - 隐私集中化：所有 API 流量经过 Ogment 服务器，存在数据驻留合规考量
- 会话过期：长期运行的自动化流程可能因令牌刷新失败中断