Sviluppatori

Strumenti per sviluppatori · MCP

Usa Tritonium dal tuo agente AI

Tritonium gestisce un server Model Context Protocol (MCP) remoto. Accedi con il tuo agente IA usando il tuo account Tritonium, oppure dagli una chiave API con scope, e potrà leggere le tue app, recensioni, insight e previsioni di valutazione, e preparare bozze di risposte in attesa dell'approvazione del tuo team.

Punto di accesso

Dettagli della connessione

Ogni client si connette allo stesso URL. I client che supportano l'accesso MCP non hanno bisogno di altro; gli altri inviano una chiave API di Tritonium.

Endpoint
https://api.tritonium.com/mcp
Trasporto
Streamable HTTP con risposte JSON. Nessuno stream SSE e nessuna sessione.
Versioni del protocollo
MCP 2026-07-28 e le revisioni precedenti basate su initialize, da 2025-03-26 a 2025-11-25, sullo stesso URL.
Accesso
OAuth 2.1 con PKCE, come descritto dalla specifica di autorizzazione MCP. Una richiesta senza credenziali riceve una risposta 401 che punta a https://api.tritonium.com/.well-known/oauth-protected-resource/mcp. I metadati del server di autorizzazione sono su https://api.tritonium.com/.well-known/oauth-authorization-server.
Chiave API
Una chiave API di Tritonium, inviata come Authorization: Bearer <key> o nell'header X-API-Key. I token di sessione della dashboard non sono accettati.
Controllo di integrità
https://api.tritonium.com/mcp/health

Avvio rapido

Configura in tre passaggi

Aggiungi Tritonium al tuo agente, accedi e approva cosa può fare, poi fai una domanda al tuo agente.

  1. Aggiungi Tritonium al tuo agente

    Ogni configurazione qui sotto aggiunge il server tramite il suo URL. La prima volta che l'agente si connette, ti chiede di accedere a Tritonium. Ogni client mostra anche come usare una chiave API invece.

    Claude Code

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

    Poi esegui /mcp in Claude Code, scegli tritonium e accedi. Da un terminale, claude mcp login tritonium fa lo stesso. Su SSH, aggiungi --no-browser: apri il link che stampa sul tuo computer, e dopo che approvi, incolla l'indirizzo su cui finisce il tuo browser nel terminale.

    Usa una chiave API invece

    Per prima cosa crea una chiave e salvala nella variabile d'ambiente TRITONIUM_API_KEY, come descritto sotto Chiavi API.

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

    I singoli apici mantengono ${TRITONIUM_API_KEY} letterale nella configurazione salvata; Claude Code legge la variabile quando si connette. Verifica la connessione con claude mcp list.

    Codex

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

    Codex nota che il server supporta l'accesso e apre il tuo browser. Chiede ogni permesso che il server offre, quindi deseleziona quelli che il tuo agente non ha bisogno prima di approvare. Per accedere di nuovo più tardi, esegui codex mcp login tritonium.

    Usa una chiave API invece

    Per prima cosa crea una chiave e salvala nella variabile d'ambiente TRITONIUM_API_KEY, come descritto sotto Chiavi API.

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

    Codex legge la chiave dalla variabile d'ambiente TRITONIUM_API_KEY.

    Cursor

    Aggiungi questo a .cursor/mcp.json in un progetto, o a ~/.cursor/mcp.json per tutti i tuoi progetti. Poi approva il server e accedi con Cursor CLI:

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

    Cursor CLI attende il tuo browser su http://localhost:8787/callback, quindi la porta 8787 deve essere libera sul computer dove viene eseguito. Su SSH, inoltra quella porta con ssh -L 8787:localhost:8787 <host>; Cursor CLI stampa lo stesso suggerimento.

    Usa una chiave API invece

    Per prima cosa crea una chiave e salvala nella variabile d'ambiente TRITONIUM_API_KEY, come descritto sotto Chiavi API.

    Aggiungi questo a .cursor/mcp.json in un progetto, o a ~/.cursor/mcp.json per tutti i tuoi progetti.

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

    Cursor riempie ${env:TRITONIUM_API_KEY} dal tuo ambiente. Se Cursor segnala un errore di autenticazione o offre di accedere, non ha potuto usare la chiave: controlla che la variabile sia impostata e la chiave sia ancora attiva.

    GitHub Copilot CLI

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

    Quindi avvia copilot ed esegui /mcp auth tritonium. L'accesso inizia solo in una sessione interattiva, non con copilot -p. Se Copilot dice ancora che il server richiede l'autenticazione dopo, riavvia copilot: userà quindi l'accesso memorizzato, anche con copilot -p.

    Usa una chiave API invece

    Per prima cosa crea una chiave e salvala nella variabile d'ambiente TRITONIUM_API_KEY, come descritto sotto Chiavi API.

    Aggiungi questo a ~/.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 riempie ${TRITONIUM_API_KEY} dal tuo ambiente.

    Grok CLI

    Terminale
    grok mcp add tritonium https://api.tritonium.com/mcp

    Quindi avvia grok, apri /mcps, seleziona tritonium e premi i per accedere.

    Usa una chiave API invece

    Per prima cosa crea una chiave e salvala nella variabile d'ambiente TRITONIUM_API_KEY, come descritto sotto Chiavi API.

    Aggiungi questo a ~/.grok/config.toml:

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

    Grok legge la chiave dalla variabile d'ambiente TRITONIUM_API_KEY.

    Antigravity

    Terminale
    agy mcp add tritonium https://api.tritonium.com/mcp

    Quindi avvia agy, apri /mcp, scegli tritonium e accedi. Dopo che approvi, il tuo browser mostra una pagina Antigravity con un codice: incolla quel codice in agy. L'accesso memorizzato funziona anche con agy --print.

    Usa una chiave API invece

    Per prima cosa crea una chiave e salvala nella variabile d'ambiente TRITONIUM_API_KEY, come descritto sotto Chiavi API.

    Aggiungi questo a ~/.gemini/config/mcp_config.json e sostituisci il placeholder con la tua chiave.

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

    Antigravity non espande le variabili d'ambiente negli header, quindi la chiave stessa è memorizzata in questo file. Mantieni il file privato (chmod 600) e fuori dal controllo di versione.

    OpenClaw

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

    OpenClaw attende il tuo browser su http://127.0.0.1:8989/oauth/callback. Se il browser non riesce a raggiungerlo, per esempio su SSH, termina con il comando openclaw mcp login tritonium --code <code> che OpenClaw stampa.

    Usa una chiave API invece

    Per prima cosa crea una chiave e salvala nella variabile d'ambiente TRITONIUM_API_KEY, come descritto sotto Chiavi API.

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

    Le virgolette singole mantengono ${TRITONIUM_API_KEY} letterale nella configurazione salvata; OpenClaw la riempie dal tuo ambiente quando carica il server.

    Altri client MCP

    I client che supportano l'autorizzazione MCP hanno bisogno solo dell'URL https://api.tritonium.com/mcp. Trovano l'accesso da soli dalla risposta 401 del server. Il supporto OAuth integrato dell'SDK Python MCP ufficiale funziona senza alcuna impostazione specifica di Tritonium.

    I client che non possono accedere possono usare una chiave API se supportano server HTTP Streamable remoti con header personalizzati: invia l'header Authorization: Bearer <key>.

  2. Accedi e approva

    La prima volta che il tuo agente si connette, apre Tritonium nel tuo browser. Accedi, controlla quale app sta chiedendo e dove invia l'accesso, scegli cosa l'agente può vedere e fare, poi approva. L'agente quindi lavora per te, entro i permessi che hai scelto.

    Ogni membro del workspace può approvare

    • Le tue app apps:read Visualizza le tue app e i loro dettagli.
    • Recensioni e risposte reviews:read Leggi recensioni, risposte e bozze di risposta.
    • Approfondimenti e analitiche analytics:read Leggi approfondimenti, valutazioni, previsioni e attività.
    • Avvisi attivati alerts:read Leggi gli avvisi che il tuo spazio di lavoro ha ricevuto.

    Gli admin e i proprietari possono anche approvare

    • Bozze di risposta reviews:write Scrivi bozze di risposta per il tuo team da rivedere. L'agente non può pubblicarle.
    • Avvia analisi e previsioni apps:write Avvia un’analisi IA o una previsione delle valutazioni o del sentiment, oppure annulla un’analisi ancora in attesa.
    • Impostazioni webhook webhooks:manage Leggi le impostazioni webhook e i log di consegna, senza modificarli.
  3. Fai una domanda al tuo agente

    Prova un prompt come questi. Il tuo agente sceglie gli strumenti, e ogni bozza di risposta che prepara attende l'approvazione in Tritonium.

    • Quale delle mie app ha ricevuto più recensioni a una stella questa settimana, e di cosa si lamentano le persone?
    • Riassumi l'ultima analisi AI per la mia app iOS ed elenca le principali richieste di funzionalità.
    • La nostra valutazione è scesa la settimana scorsa. Confronta la cronologia della valutazione con le recensioni recenti e dimmi cosa è cambiato.
    • Prepara bozze di risposta alle cinque recensioni negative più recenti, così posso approvarle in Tritonium.

Chiavi API

Usa una chiave API invece

Le chiavi API funzionano ancora con ogni client di questa pagina. Usane una quando il tuo client non può accedere, per script e CI o con Tritonium CLI.

Crea una chiave API

Un admin o proprietario del workspace crea le chiavi nella dashboard di Tritonium, in Impostazioni → Chiavi API. Assegna alla chiave solo gli scope necessari al tuo agente, poi rendila disponibile come variabile d'ambiente dove viene eseguito il tuo client:

Terminale
export TRITONIUM_API_KEY="trtn_live_…"

Poi apri Usa una chiave API invece nella configurazione del tuo client qui sopra.

Per script e CI, Tritonium CLI chiama gli stessi strumenti e stampa JSON. Vedi la Guida CLI.

Riferimento

Strumenti

Il server ha 21 strumenti. Il tuo agente vede solo gli strumenti che i suoi permessi consentono, e uno scope :write concede anche accesso in lettura nello stesso dominio.

Strumenti MCP di Tritonium con lo scope richiesto da ciascuno
Strumento Cosa fa Scope
get_workspace_context Il tuo workspace, gli scope concessi, e quali strumenti l'agente può usare. Sempre disponibili
list_apps App con conteggi di recensioni, stato di sincronizzazione e analisi e se arrivano ancora nuove recensioni. apps:read
get_app I dettagli di un'app, lo stato di sincronizzazione e analisi attuale e se arrivano ancora nuove recensioni. apps:read
search_reviews Filtra le recensioni di un'app per testo, valutazione, sentiment (in base alle stelle, se non etichettata), lingua e data. reviews:read
get_review Una recensione completa, con la traduzione e l'eventuale risposta dello sviluppatore. reviews:read
list_reply_drafts Bozze di risposte AI in attesa di approvazione. reviews:read
get_reply_draft Una bozza di risposta per ID, con stato attuale, testo e identificativi della recensione. reviews:read
generate_reply_draft Scrive una bozza di risposta AI per l'approvazione umana. Non viene mai pubblicata. Scrittura reviews:write
start_app_analysis Mette in coda una nuova analisi AI delle recensioni di un'app. Supporta un'esecuzione di prova. Scrittura apps:read (dry_run) / apps:write (start)
get_analysis_run Un'esecuzione di analisi IA: il suo stato, la fase, l'avanzamento e qualsiasi errore. apps:read
list_analysis_runs Le esecuzioni di analisi IA di un'app, dalla più recente, incluse quelle avviate dopo una sincronizzazione delle recensioni. apps:read
cancel_analysis_run Annulla un'esecuzione di analisi IA che è ancora in attesa di essere eseguita. Un'esecuzione già in elaborazione continua. Scrittura apps:write
get_app_insights L'ultima analisi AI: riepilogo, problemi e punti di forza chiave, richieste di funzionalità, bug e argomenti. analytics:read
get_rating_history Andamento giornaliero o settimanale della valutazione in stelle. analytics:read
get_cached_rating_forecast Consulta una previsione delle valutazioni in cache senza avviare una nuova generazione. analytics:read
get_rating_forecast Previsione AI della valutazione per i prossimi 7-90 giorni. Scrittura La prima richiesta potrebbe iniziare a generare la previsione. analytics:read + apps:write
list_feature_requests Richieste di funzionalità estratte dalle recensioni. analytics:read
list_alerts Avvisi generati per il workspace. alerts:read
list_webhooks Endpoint webhook e conteggi di consegne. I segreti non vengono mai restituiti. webhooks:manage
list_webhook_deliveries Tentativi di consegna recenti per un webhook. webhooks:manage
list_activity Il feed di attività del workspace. analytics:read

Anche sul server

  • Risorsa tritonium://guides/agents: una guida per agenti che lavorano con Tritonium.
  • Prompt triage_negative_reviews e investigate_rating_change: punti di partenza per il triage delle recensioni negative e l'analisi di una variazione della valutazione.

Autorizzazioni

Il controllo resta a te

Un agente lavora entro i permessi che gli hai dato, e le decisioni che raggiungono i tuoi clienti rimangono con il tuo team.

Accesso con scope e revocabile

Un agente collegato o una chiave API agisce sempre come membro del workspace limitato ai suoi permessi. Gli amministratori e i proprietari disconnettono gli agenti sotto Impostazioni → Chiavi API → Agenti collegati e revocano o ruotano le chiavi sotto Impostazioni → Chiavi API. I membri disconnettono i propri agenti sotto Impostazioni → Sicurezza → Agenti collegati.

Nulla viene pubblicato automaticamente

Rivedi e approva le bozze nella dashboard. La pubblicazione richiede una connessione supportata e le credenziali dello store; puoi anche copiare la risposta nella console dello store per pubblicarla manualmente.

Uso visibile

La scheda Chiavi API mostra quando ogni chiave è stata usata l'ultima volta e quante richieste ha effettuato. Agenti collegati mostra chi ha collegato ogni agente e quando è stato usato l'ultima volta.

Cosa gli agenti non possono fare

Queste azioni rimangono con gli admin e i proprietari con accesso nella dashboard di Tritonium. Nessuna chiave API e nessun permesso che approvi consente a un agente di farle:

  • Pubblicare, approvare o rifiutare risposte negli app store
  • Connettere, eliminare o risincronizzare app
  • Prendere atto degli avvisi o modificare le regole di avviso
  • Creare o testare webhook
  • Esportazioni, fatturazione, team e impostazioni delle credenziali

Limiti

Buono a sapersi

  • Tritonium CLI accetta chiavi API o token di accesso OAuth forniti; non esegue l’accesso né rinnova i token.
  • I token di sessione della dashboard non sono accettati. Accedi con l'agente o usa una chiave API.
  • Ogni chiave API e ogni agente connesso ha un proprio budget, condiviso con la REST API: 600 richieste al minuto e 60 nuove bozze, analisi o previsioni AI ogni 10 minuti. Le richieste sono limitate anche per indirizzo IP. Quando uno strumento restituisce RATE_LIMITED, controlla retry_after_seconds prima di riprovare.
  • L'analisi AI e le bozze di risposte usano la capacità AI del tuo piano. Le stime usano recensioni scritte, non tutte le valutazioni dello store. La precisione rispetto alle future valutazioni mostrate dallo store non è stata dimostrata. Gli intervalli del modello non sono intervalli di confidenza calibrati.
  • I client basati su browser possono connettersi solo dalle origini di Tritonium.
  • Grok Bot, l'agente ospitato di xAI, non è stato testato con Tritonium.

Errori strutturati

Gli errori vengono restituiti come risultati di strumenti con un error.code stabile, un flag retryable e retry_after_seconds, così un agente sa se e quando riprovare.

Codici di errore

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

Testato con

Le configurazioni client su questa pagina sono state testate il con 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 e MCP Python SDK 2.2.0. Ognuna di esse ha effettuato l'accesso al server di produzione.

Porta le tue recensioni di app al tuo agente

Connetti le tue app App Store e Google Play in Tritonium, quindi aggiungi il server al tuo agente e accedi.