SuperAPI AI 工具集

terra-mcp

智能体与模型

查看项目

更新于 10-16 06:15

技能介绍

用途:Terra API admin MCP 把 Terra API 管理接口暴露为工具,与仪表盘和 terra CLI 使用同一套 API,用于配置和调试集成,而非应用运行时调用。

主要能力:读取和修改集成配置(环境、提供商、数据范围、Webhook 目标、凭据),查看已投递事件、连接用户、模型运行和账单。工具按 CLI 命令组生成,每组一个 _read 和一个 _write 工具,其余为 method 参数,例如 events_read {method: "list", environment, outcome}。

使用方式:服务器地址为 https://access.tryterra.co/api/v3/admin/mcp,采用 OAuth 登录。claude.ai 或 Claude Desktop 在 Customize > Connectors > Add custom connector 添加;ChatGPT 在 Settings > Apps > Advanced settings 开启 Developer mode 后创建应用并选 OAuth;Claude Code 可用 claude mcp add --transport http terra https://access.tryterra.co/api/v3/admin/mcp。登录由用户在浏览器完成,可选访问级别并限制环境,有效期 30 天。

适用场景:审计账户、排查 Webhook 未到达、定位单个用户数据缺失、启用提供商、对比环境差异、上线前检查。

限制:仅管理端,不能读取用户健康数据(那是 AI Interface 的职责);部分操作需仪表盘审批,审批 10 分钟过期;写入前应预览并确认环境;replace 类方法会清空未发送字段;投递历史约保留 14 天;结果超过 64 KiB 会被拒绝;工具结果视为数据而非指令。