开发者

开发者工具 · MCP

在您的 AI 代理中使用 Tritonium

Tritonium 运行一个远程模型上下文协议 (MCP) 服务器。使用您的 Tritonium 账户登录您的 AI 代理,或为其提供一个限定权限范围的 API 密钥,它就可以读取您的应用、评价、洞察和评分预测,并准备等待您的团队批准的回复草稿。

端点

连接详情

每个客户端连接到同一个 URL。支持 MCP 登录的客户端无需其他操作;其他客户端发送 Tritonium API 密钥。

端点
https://api.tritonium.com/mcp
传输
Streamable HTTP,返回 JSON 响应。没有 SSE 流,没有会话。
协议版本
MCP 2026-07-28,以及基于 initialize 的早期修订版 2025-03-26 至 2025-11-25,均使用同一 URL。
登录
OAuth 2.1 with PKCE,如 MCP 授权规范所述。没有凭证的请求会收到 401 响应,指向 https://api.tritonium.com/.well-known/oauth-protected-resource/mcp。授权服务器的元数据位于 https://api.tritonium.com/.well-known/oauth-authorization-server。
API 密钥
Tritonium API 密钥,作为 Authorization: Bearer <key> 或在 X-API-Key 标头中发送。不接受仪表板会话令牌。
健康检查
https://api.tritonium.com/mcp/health

快速入门

三步设置

将 Tritonium 添加到您的代理,登录并批准其可执行的操作,然后向您的代理提问。

  1. 将 Tritonium 添加到您的代理

    下面的每个设置都通过其 URL 添加服务器。代理首次连接时,会要求您登录 Tritonium。每个客户端也显示如何改用 API 密钥。

    Claude Code

    终端
    claude mcp add --transport http --scope user tritonium https://api.tritonium.com/mcp

    然后在 Claude Code 中运行 /mcp,选择 tritonium 并登录。从终端,claude mcp login tritonium 执行相同操作。通过 SSH,添加 --no-browser:打开它在您自己的计算机上打印的链接,批准后,将浏览器最终到达的地址粘贴回终端。

    改用 API 密钥

    首先创建一个密钥并将其存储在 TRITONIUM_API_KEY 环境变量中,如 API 密钥 中所述。

    终端
    claude mcp add --transport http --scope user tritonium https://api.tritonium.com/mcp --header 'Authorization: Bearer ${TRITONIUM_API_KEY}'

    单引号使 ${TRITONIUM_API_KEY} 在保存的配置中保持字面值;Claude Code 在连接时读取该变量。使用 claude mcp list 检查连接。

    Codex

    终端
    codex mcp add tritonium --url https://api.tritonium.com/mcp

    Codex 注意到服务器支持登录并打开您的浏览器。它要求服务器提供的每个权限,因此在批准前取消勾选您的代理不需要的权限。要稍后再次登录,运行 codex mcp login tritonium。

    改用 API 密钥

    首先创建一个密钥并将其存储在 TRITONIUM_API_KEY 环境变量中,如 API 密钥 中所述。

    终端
    codex mcp add tritonium --url https://api.tritonium.com/mcp --bearer-token-env-var TRITONIUM_API_KEY

    Codex 从 TRITONIUM_API_KEY 环境变量读取密钥。

    Cursor

    将此添加到项目中的 .cursor/mcp.json,或添加到 ~/.cursor/mcp.json 以用于所有项目。然后批准服务器并使用 Cursor CLI 登录:

    mcp.json
    {
      "mcpServers": {
        "tritonium": {
          "url": "https://api.tritonium.com/mcp"
        }
      }
    }
    终端
    cursor-agent mcp enable tritonium
    cursor-agent mcp login tritonium

    Cursor CLI 在 http://localhost:8787/callback 上等待您的浏览器,因此运行它的计算机上的 8787 端口必须是空闲的。通过 SSH,使用 ssh -L 8787:localhost:8787 <host> 转发该端口;Cursor CLI 会打印相同的提示。

    改用 API 密钥

    首先创建一个密钥并将其存储在 TRITONIUM_API_KEY 环境变量中,如 API 密钥 中所述。

    将其添加到项目中的 .cursor/mcp.json,或添加到 ~/.cursor/mcp.json 以用于所有项目。

    mcp.json
    {
      "mcpServers": {
        "tritonium": {
          "url": "https://api.tritonium.com/mcp",
          "headers": { "Authorization": "Bearer ${env:TRITONIUM_API_KEY}" }
        }
      }
    }

    Cursor 从您的环境中填入 ${env:TRITONIUM_API_KEY}。如果 Cursor 报告身份验证错误或提供登录选项,则它无法使用密钥:检查变量是否已设置且密钥仍处于活动状态。

    GitHub Copilot CLI

    终端
    copilot mcp add --transport http tritonium https://api.tritonium.com/mcp

    然后启动 copilot 并运行 /mcp auth tritonium。登录仅在交互式会话中启动,不能使用 copilot -p。如果之后 Copilot 仍然说服务器需要身份验证,请重启 copilot:它将使用存储的登录,也适用于 copilot -p。

    改用 API 密钥

    首先创建一个密钥并将其存储在 TRITONIUM_API_KEY 环境变量中,如 API 密钥 中所述。

    将此添加到 ~/.copilot/mcp-config.json:

    mcp-config.json
    {
      "mcpServers": {
        "tritonium": {
          "type": "http",
          "url": "https://api.tritonium.com/mcp",
          "headers": { "Authorization": "Bearer ${TRITONIUM_API_KEY}" },
          "tools": ["*"]
        }
      }
    }

    Copilot 从您的环境中填入 ${TRITONIUM_API_KEY}。

    Grok CLI

    终端
    grok mcp add tritonium https://api.tritonium.com/mcp

    然后启动 grok,打开 /mcps,选择 tritonium 并按 i 登录。

    改用 API 密钥

    首先创建一个密钥并将其存储在 TRITONIUM_API_KEY 环境变量中,如 API 密钥 中所述。

    将此添加到 ~/.grok/config.toml:

    config.toml
    [mcp_servers.tritonium]
    url = "https://api.tritonium.com/mcp"
    bearer_token_env_var = "TRITONIUM_API_KEY"

    Grok 从 TRITONIUM_API_KEY 环境变量读取密钥。

    Antigravity

    终端
    agy mcp add tritonium https://api.tritonium.com/mcp

    然后启动 agy,打开 /mcp,选择 tritonium 并登录。批准后,您的浏览器会显示一个 Antigravity 页面,其中包含一个代码:将该代码粘贴到 agy 中。存储的登录也适用于 agy --print。

    改用 API 密钥

    首先创建一个密钥并将其存储在 TRITONIUM_API_KEY 环境变量中,如 API 密钥 中所述。

    将其添加到 ~/.gemini/config/mcp_config.json 并用您的密钥替换占位符。

    mcp_config.json
    {
      "mcpServers": {
        "tritonium": {
          "serverUrl": "https://api.tritonium.com/mcp",
          "headers": { "Authorization": "Bearer trtn_live_your_key" }
        }
      }
    }

    Antigravity 不会展开标头中的环境变量,因此密钥本身会保存在此文件中。请保持该文件私密(chmod 600),并且不要纳入版本控制。

    OpenClaw

    终端
    openclaw mcp set tritonium '{"url":"https://api.tritonium.com/mcp","transport":"streamable-http","auth":"oauth"}'
    openclaw mcp login tritonium

    OpenClaw 在 http://127.0.0.1:8989/oauth/callback 上等待您的浏览器。如果浏览器无法到达它,例如通过 SSH,使用 OpenClaw 打印的 openclaw mcp login tritonium --code <code> 命令完成。

    改用 API 密钥

    首先创建一个密钥并将其存储在 TRITONIUM_API_KEY 环境变量中,如 API 密钥 中所述。

    终端
    openclaw mcp set tritonium '{"url":"https://api.tritonium.com/mcp","transport":"streamable-http","headers":{"Authorization":"Bearer ${TRITONIUM_API_KEY}"}}'

    单引号将 ${TRITONIUM_API_KEY} 保持为字面量在保存的配置中;OpenClaw 在加载服务器时从您的环境中填入它。

    其他 MCP 客户端

    支持 MCP 授权的客户端仅需 URL https://api.tritonium.com/mcp。它们从服务器的 401 响应中自行查找登录。官方 MCP Python SDK 的内置 OAuth 支持无需任何 Tritonium 特定设置即可工作。

    无法登录的客户端如果支持带自定义标头的远程 Streamable HTTP 服务器,可以使用 API 密钥:发送标头 Authorization: Bearer <key>。

  2. 登录并批准

    代理首次连接时,会在您的浏览器中打开 Tritonium。登录,检查哪个应用在请求以及它发送访问权限的位置,选择代理可以查看和执行的操作,然后批准。代理随后在您选择的权限范围内为您工作。

    每个工作区成员都可以批准

    • 您的应用 apps:read 查看您的应用及其详情。
    • 评论和回复 reviews:read 阅读评论、回复和回复草稿。
    • 洞察和分析 analytics:read 阅读洞察、评分、预测和活动。
    • 触发的警报 alerts:read 阅读您的工作区收到的警报。

    管理员和所有者也可以批准

    • 回复草稿 reviews:write 为您的团队撰写需审核的回复草稿。智能体无法发布它们。
    • 启动应用分析和预测 apps:write 启动 AI 应用分析或评分或情感预测,或取消仍在等待运行的分析。
    • Webhook 设置 webhooks:manage 阅读 webhook 设置和传递日志,不进行更改。
  3. 向您的代理提问

    试试下面这样的提示。工具由代理选择,代理起草的任何回复都会在 Tritonium 中等待批准。

    • 我的哪个应用本周获得了最多一星评论,人们在抱怨什么?
    • 总结我的 iOS 应用的最新 AI 分析,并列出主要的功能请求。
    • 我们的评分上周下降了。比较评分历史与最近的评论,告诉我发生了什么变化。
    • 为最近的五条负面评论起草回复,以便我在 Tritonium 中批准。

API 密钥

改用 API 密钥

API 密钥仍适用于此页面上的每个客户端。客户端无法登录时,或者用于脚本、CI 和 Tritonium CLI 时,可以使用 API 密钥。

创建 API 密钥

工作区管理员或所有者在 Tritonium 仪表板的 设置 → API 密钥 中创建密钥。只为密钥授予代理所需的权限范围,然后在客户端运行的环境中将其设置为环境变量:

终端
export TRITONIUM_API_KEY="trtn_live_…"

然后在您的客户端设置中打开 改用 API 密钥。

对于脚本和 CI,Tritonium CLI 调用相同的工具并输出 JSON。请参阅 CLI 指南。

参考

工具

服务器有 21 个工具。您的代理仅看到其权限允许的工具,:write 权限范围也在同一域中授予读取访问权限。

Tritonium MCP 工具及各工具所需的权限范围
工具 功能 权限范围
get_workspace_context 您的工作区、授予的权限范围以及代理可以使用的工具。 始终可用
list_apps 应用及其评论计数、同步和分析状态,以及是否仍在收到新评论。 apps:read
get_app 一个应用的详情、当前同步和分析状态,以及是否仍在收到新评论。 apps:read
search_reviews 按文本、评分、情感(无标签时取决于星级)、语言和日期筛选一个应用的评论。 reviews:read
get_review 一条完整的评论,包括其翻译和任何开发者回复。 reviews:read
list_reply_drafts 等待批准的 AI 回复草稿。 reviews:read
get_reply_draft 按 ID 获取一条回复草稿,包括当前状态、文本和评论标识符。 reviews:read
generate_reply_draft 编写 AI 回复草稿,供人工批准。草稿绝不会被发布。 写入 reviews:write
start_app_analysis 将新的应用评论 AI 分析加入队列。支持试运行。 写入 apps:read (dry_run) / apps:write (start)
get_analysis_run 一次 AI 分析运行:其状态、阶段、进度和任何失败信息。 apps:read
list_analysis_runs 应用的 AI 分析运行,按从新到旧排列,包括评论同步后启动的运行。 apps:read
cancel_analysis_run 取消仍在等待运行的 AI 分析运行。已在处理中的运行将继续进行。 写入 apps:write
get_app_insights 最新的 AI 分析:摘要、关键问题和优势、功能请求、错误和主题。 analytics:read
get_rating_history 每日或每周星级评分趋势。 analytics:read
get_cached_rating_forecast 查看已缓存的 AI 评分预测,不会启动新的生成。 analytics:read
get_rating_forecast 未来 7 到 90 天的 AI 评分预测。 写入 第一个请求可能会开始生成预测。 analytics:read + apps:write
list_feature_requests 从评论中提取的功能请求。 analytics:read
list_alerts 为工作区触发的提醒。 alerts:read
list_webhooks Webhook 端点及投递次数。绝不返回签名密钥。 webhooks:manage
list_webhook_deliveries 单个 Webhook 的最近投递尝试。 webhooks:manage
list_activity 工作区活动源。 analytics:read

服务器上的其他内容

  • 资源 tritonium://guides/agents:面向使用 Tritonium 的代理的指南。
  • 提示 triage_negative_reviews 和 investigate_rating_change:用于分类处理负面评论和调查评分变化的起点。

权限

控制权在您手中

代理在您给予的权限范围内工作,到达您的客户的决定留在您的团队。

限定权限范围、可撤销的访问权限

已登录的代理或 API 密钥始终以工作区成员身份运行,并受其权限约束。管理员和所有者可在 设置 → API 密钥 → 已连接的智能体 中断开代理连接,并在 设置 → API 密钥 中撤销或轮换密钥。成员可在 设置 → 安全 → 已连接的智能体 中断开自己的代理连接。

没有任何内容自动发布

在控制面板中审核并批准回复草稿。商店发布需要受支持的连接和商店凭证;也可以将回复复制到商店控制台手动发布。

可见的使用情况

API 密钥选项卡显示每个密钥的最后使用时间以及它发出的请求数。已连接的智能体显示谁连接了每个代理以及它最后使用的时间。

代理无法执行的操作

这些操作留在 Tritonium 仪表板中已登录的管理员和所有者。没有 API 密钥和您批准的权限可以让代理执行它们:

  • 在应用商店中发布、批准或拒绝回复
  • 连接、删除或重新同步应用
  • 确认提醒或编辑提醒规则
  • 创建或测试 Webhook
  • 导出、计费、团队和凭证设置

限制

需要了解的事项

  • Tritonium CLI 接受 API 密钥或提供的 OAuth 访问令牌;它不会登录或刷新令牌。
  • 不接受仪表板会话令牌。登录代理或使用 API 密钥。
  • 每个 API 密钥和每个已登录的代理都有自己的配额,与 REST API 共享:每分钟 600 个请求,以及每 10 分钟 60 次新的 AI 草稿、分析或预测。请求还按 IP 地址限制。当工具返回 RATE_LIMITED 时,请先查看 retry_after_seconds 再重试。
  • AI 分析和回复草稿会使用您套餐的 AI 额度。 估算使用文字评论,不涵盖商店的所有评分。 尚未验证对未来商店展示评分的准确性。模型范围并非经过校准的置信区间。
  • 基于浏览器的客户端只能从 Tritonium 自己的源(origin)连接。
  • Grok Bot(xAI 的托管代理)尚未与 Tritonium 进行测试。

结构化错误

失败会作为工具结果返回,包含稳定的 error.code、retryable 标志和 retry_after_seconds,让代理知道是否以及何时重试。

错误代码

  • INVALID_ARGUMENT
  • AUTHENTICATION_FAILED
  • PERMISSION_DENIED
  • SUBSCRIPTION_INACTIVE
  • NOT_FOUND
  • CONFLICT
  • RATE_LIMITED
  • UPSTREAM_UNAVAILABLE
  • UPSTREAM_TIMEOUT
  • INTERNAL_ERROR

已测试的客户端

此页面上的客户端设置在 使用 Claude Code 2.1.277、Codex CLI 0.155.0、Cursor CLI 2026.09.15、GitHub Copilot CLI 1.0.86、Grok CLI 1.0.34、Antigravity CLI 1.2.6、OpenClaw 2026.9.4和MCP Python SDK 2.2.0 进行了测试。它们都登录到了生产服务器。

让您的代理使用应用评价

在 Tritonium 中连接您的 App Store 和 Google Play 应用,然后将服务器添加到您的代理并登录。