開発者向け

開発者ツール · MCP

AI エージェントから Tritonium を使用する

Tritonium はリモート Model Context Protocol (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 で提供します。
サインイン
MCP 認可仕様で説明されている OAuth 2.1 with PKCE です。認証情報なしのリクエストは https://api.tritonium.com/.well-known/oauth-protected-resource/mcp を指す 401 レスポンスを取得します。認可サーバーのメタデータは https://api.tritonium.com/.well-known/oauth-authorization-server にあります。
API キー
Tritonium API キー。Authorization: Bearer <key> として、または X-API-Key ヘッダーで送信されます。ダッシュボードのセッショントークンは受け入れられません。
ヘルスチェック
https://api.tritonium.com/mcp/health

クイックスタート

3 つのステップでセットアップ

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 キーを使用

    まず API キー で説明されているようにキーを作成し、TRITONIUM_API_KEY 環境変数に保存してください。

    ターミナル
    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 キーを使用

    まず API キー で説明されているようにキーを作成し、TRITONIUM_API_KEY 環境変数に保存してください。

    ターミナル
    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 キーを使用

    まず API キー で説明されているようにキーを作成し、TRITONIUM_API_KEY 環境変数に保存してください。

    プロジェクト内の .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 キーを使用

    まず API キー で説明されているようにキーを作成し、TRITONIUM_API_KEY 環境変数に保存してください。

    これを ~/.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 キーを使用

    まず API キー で説明されているようにキーを作成し、TRITONIUM_API_KEY 環境変数に保存してください。

    これを ~/.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 キーを使用

    まず API キー で説明されているようにキーを作成し、TRITONIUM_API_KEY 環境変数に保存してください。

    ~/.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 キーを使用

    まず API キー で説明されているようにキーを作成し、TRITONIUM_API_KEY 環境変数に保存してください。

    ターミナル
    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 で承認を待ちます。

    • 今週、1 つ星レビューが最も多かったアプリはどれですか?ユーザーは何に不満を持っていますか?
    • iOS アプリの最新 AI 分析を要約し、トップの機能リクエストをリストアップしてください。
    • 先週評価が下がりました。評価の履歴と最近のレビューを比較し、何が変わったか教えてください。
    • 最新のネガティブレビュー 5 件への返信下書きを作成してください。Tritonium で承認します。

API キー

代わりに API キーを使用

API キーはこのページのすべてのクライアントで使えます。クライアントがサインインできない場合、スクリプトや CI、Tritonium CLI で使用してください。

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 1 つのアプリの詳細、現在の同期および分析ステータス、新しいレビューが引き続き届いているかどうか。 apps:read
search_reviews テキスト、評価、センチメント(ラベルがない場合は星評価に従います)、言語、日付で 1 つのアプリのレビューを絞り込みます。 reviews:read
get_review 翻訳と開発者の返信を含む 1 つのレビュー全体。 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 1 つの 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 1 つの 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 独自のオリジンからのみ接続できます。
  • 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 のアプリを接続してから、サーバーをエージェントに追加してサインインしてください。