Ontwikkelaars

Developer tools · MCP

Tritonium gebruiken vanuit uw AI-agent

Tritonium voert een externe Model Context Protocol (MCP)-server uit. Meld uw AI-agent aan met uw Tritonium-account, of geef deze een beperkte API-sleutel, en deze kan uw apps, beoordelingen, inzichten en ratingprognoses lezen, en antwoordconcepten voorbereiden die op goedkeuring van uw team wachten.

Eindpunt

Verbindingsgegevens

Elke client maakt verbinding met dezelfde URL. Clients die MCP-aanmelding ondersteunen hebben niets anders nodig; de anderen verzenden een Tritonium API-sleutel.

Endpoint
https://api.tritonium.com/mcp
Transport
Streamable HTTP met JSON-responses. Er is geen SSE-stream en geen sessie.
Protocolversies
MCP 2026-07-28, en de eerdere initialize-gebaseerde revisies 2025-03-26 tot 2025-11-25, op dezelfde URL.
Aanmelden
OAuth 2.1 met PKCE, zoals de MCP-autorisatiespecificatie beschrijft. Een verzoek zonder inloggegevens krijgt een 401-respons die naar https://api.tritonium.com/.well-known/oauth-protected-resource/mcp verwijst. De metagegevens van de autorisatieserver bevinden zich op https://api.tritonium.com/.well-known/oauth-authorization-server.
API-sleutel
Een Tritonium API-sleutel, verzonden als Authorization: Bearer <key> of in een X-API-Key-header. Dashboard-sessietokens worden niet geaccepteerd.
Statuscontrole
https://api.tritonium.com/mcp/health

Snel aan de slag

In drie stappen instellen

Voeg Tritonium toe aan uw agent, meld u aan en keur goed wat deze mag doen, en stel uw agent vervolgens een vraag.

  1. Tritonium aan uw agent toevoegen

    Elke setup hieronder voegt de server toe via de URL. De eerste keer dat de agent verbinding maakt, vraagt deze u zich aan te melden bij Tritonium. Elke client toont ook hoe u in plaats daarvan een API-sleutel kunt gebruiken.

    Claude Code

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

    Voer vervolgens /mcp uit in Claude Code, kies tritonium en meld u aan. Vanuit een terminal doet claude mcp login tritonium hetzelfde. Via SSH voegt u --no-browser toe: open de link die deze op uw eigen computer afdrukt, en nadat u goed hebt gekeurd, plakt u het adres waar uw browser eindigt terug in de terminal.

    Een API-sleutel gebruiken

    Maak eerst een sleutel aan en sla deze op in de TRITONIUM_API_KEY-omgevingsvariabele, zoals beschreven onder API-sleutels.

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

    Door de enkele aanhalingstekens blijft ${TRITONIUM_API_KEY} letterlijk in de opgeslagen configuratie staan; Claude Code leest de variabele bij het verbinden. Controleer de verbinding met claude mcp list.

    Codex

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

    Codex merkt dat de server aanmelding ondersteunt en opent uw browser. Deze vraagt om elke machtiging die de server biedt, dus vink de machtigingen uit die uw agent niet nodig heeft voordat u goedkeurt. Om u later opnieuw aan te melden, voert u codex mcp login tritonium uit.

    Een API-sleutel gebruiken

    Maak eerst een sleutel aan en sla deze op in de TRITONIUM_API_KEY-omgevingsvariabele, zoals beschreven onder API-sleutels.

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

    Codex leest de sleutel uit de TRITONIUM_API_KEY-omgevingsvariabele.

    Cursor

    Voeg dit toe aan .cursor/mcp.json in een project, of aan ~/.cursor/mcp.json voor al uw projecten. Keur vervolgens de server goed en meld u aan met de Cursor CLI:

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

    De Cursor CLI wacht op uw browser op http://localhost:8787/callback, dus poort 8787 moet vrij zijn op de computer waarop deze wordt uitgevoerd. Via SSH stuurt u die poort door met ssh -L 8787:localhost:8787 <host>; de Cursor CLI geeft dezelfde hint.

    Een API-sleutel gebruiken

    Maak eerst een sleutel aan en sla deze op in de TRITONIUM_API_KEY-omgevingsvariabele, zoals beschreven onder API-sleutels.

    Voeg dit toe aan .cursor/mcp.json in een project, of aan ~/.cursor/mcp.json voor al uw projecten.

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

    Cursor vult ${env:TRITONIUM_API_KEY} in vanuit uw omgeving. Als Cursor een verificatiefout meldt of aanmelding aanbiedt, kon deze de sleutel niet gebruiken: controleer of de variabele is ingesteld en de sleutel nog actief is.

    GitHub Copilot CLI

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

    Start vervolgens copilot en voer /mcp auth tritonium uit. Aanmelden begint alleen in een interactieve sessie, niet met copilot -p. Als Copilot daarna nog steeds zegt dat de server verificatie vereist, start u copilot opnieuw: deze gebruikt dan de opgeslagen aanmelding, ook met copilot -p.

    Een API-sleutel gebruiken

    Maak eerst een sleutel aan en sla deze op in de TRITONIUM_API_KEY-omgevingsvariabele, zoals beschreven onder API-sleutels.

    Voeg dit toe aan ~/.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 vult ${TRITONIUM_API_KEY} in vanuit uw omgeving.

    Grok CLI

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

    Start vervolgens grok, open /mcps, selecteer tritonium en druk op i om u aan te melden.

    Een API-sleutel gebruiken

    Maak eerst een sleutel aan en sla deze op in de TRITONIUM_API_KEY-omgevingsvariabele, zoals beschreven onder API-sleutels.

    Voeg dit toe aan ~/.grok/config.toml:

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

    Grok leest de sleutel uit de TRITONIUM_API_KEY-omgevingsvariabele.

    Antigravity

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

    Start vervolgens agy, open /mcp, kies tritonium en meld u aan. Nadat u goedkeurt, toont uw browser een Antigravity-pagina met een code: plak die code in agy. De opgeslagen aanmelding werkt ook met agy --print.

    Een API-sleutel gebruiken

    Maak eerst een sleutel aan en sla deze op in de TRITONIUM_API_KEY-omgevingsvariabele, zoals beschreven onder API-sleutels.

    Voeg dit toe aan ~/.gemini/config/mcp_config.json en vervang de placeholder door uw sleutel.

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

    Antigravity breidt omgevingsvariabelen in headers niet uit, dus de sleutel zelf wordt in dit bestand opgeslagen. Houd het bestand privé (chmod 600) en buiten versiebeheer.

    OpenClaw

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

    OpenClaw wacht op uw browser op http://127.0.0.1:8989/oauth/callback. Als de browser deze niet kan bereiken, bijvoorbeeld via SSH, voltooit u met de openclaw mcp login tritonium --code <code>-opdracht die OpenClaw afdrukt.

    Een API-sleutel gebruiken

    Maak eerst een sleutel aan en sla deze op in de TRITONIUM_API_KEY-omgevingsvariabele, zoals beschreven onder API-sleutels.

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

    De enkele aanhalingstekens houden ${TRITONIUM_API_KEY} letterlijk in de opgeslagen configuratie; OpenClaw vult deze in vanuit uw omgeving wanneer deze de server laadt.

    Andere MCP-clients

    Clients die MCP-autorisatie ondersteunen hebben alleen de URL https://api.tritonium.com/mcp nodig. Ze vinden de aanmelding zelf uit de 401-respons van de server. De ingebouwde OAuth-ondersteuning van de officiële MCP Python SDK werkt zonder enige Tritonium-specifieke instellingen.

    Clients die niet kunnen aanmelden kunnen een API-sleutel gebruiken als zij externe Streamable HTTP-servers met aangepaste headers ondersteunen: verzend de header Authorization: Bearer <key>.

  2. Aanmelden en goedkeuren

    De eerste keer dat uw agent verbinding maakt, opent deze Tritonium in uw browser. Meld u aan, controleer welke app vraagt en waar deze toegang naar verzendt, kies wat de agent mag zien en doen, en keur goed. De agent werkt vervolgens voor u, binnen de machtigingen die u hebt gekozen.

    Elk workspacelid kan goedkeuren

    • Je apps apps:read Je apps en hun details bekijken.
    • Beoordelingen en antwoorden reviews:read Beoordelingen, antwoorden en conceptantwoorden lezen.
    • Inzichten en analyses analytics:read Inzichten, waarderingen, prognoses en activiteit lezen.
    • Geactiveerde waarschuwingen alerts:read De waarschuwingen lezen die je werkruimte heeft ontvangen.

    Beheerders en eigenaren kunnen ook goedkeuren

    • Conceptantwoorden reviews:write Conceptantwoorden schrijven die je team kan beoordelen. De agent kan ze niet publiceren.
    • App-analyses en prognoses starten apps:write Start een AI-analyse of waarderings- of sentimentprognose, of annuleer een analyse die nog wacht.
    • Webhook-instellingen webhooks:manage Webhook-instellingen en leveringslogboeken lezen, zonder ze te wijzigen.
  3. Stel uw agent een vraag

    Probeer bijvoorbeeld een van deze prompts. Uw agent kiest de tools, en elk conceptantwoord dat hij opstelt, wacht in Tritonium op goedkeuring.

    • Welke van mijn apps kreeg deze week de meeste eensterreviews, en waar klagen mensen over?
    • Vat de nieuwste AI-analyse van mijn iOS-app samen en noem de belangrijkste functieverzoeken.
    • Onze rating is vorige week gedaald. Vergelijk de ratinggeschiedenis met recente reviews en vertel me wat er is veranderd.
    • Stel conceptantwoorden op voor de vijf meest recente negatieve reviews zodat ik ze in Tritonium kan goedkeuren.

API-sleutels

Een API-sleutel gebruiken

API-sleutels werken nog steeds met elke client op deze pagina. Gebruik er een wanneer uw client niet kan aanmelden, voor scripts en CI of met de Tritonium CLI.

Een API-sleutel aanmaken

Een beheerder of eigenaar van de workspace maakt sleutels aan in het Tritonium-dashboard onder Instellingen → API-sleutels. Geef de sleutel alleen de scopes die uw agent nodig heeft en stel hem daarna beschikbaar als omgevingsvariabele waar uw client draait:

Terminal
export TRITONIUM_API_KEY="trtn_live_…"

Open vervolgens Een API-sleutel gebruiken in de setup van uw client hierboven.

Voor scripts en CI roept de Tritonium CLI dezelfde tools aan en geeft JSON af. Zie de CLI-gids.

Referentie

Tools

De server heeft 21 tools. Uw agent ziet alleen de tools die zijn machtigingen toestaan, en een :write-scope verleent ook leestoegang in hetzelfde domein.

Tritonium MCP-tools met de scope die elke tool nodig heeft
Tool Wat het doet Scope
get_workspace_context Uw workspace, de verleende scopes, en welke tools de agent kan gebruiken. Altijd beschikbaar
list_apps Apps met aantallen reviews, de synchronisatie- en analysestatus en of er nog nieuwe reviews binnenkomen. apps:read
get_app Details van één app met de actuele synchronisatie- en analysestatus en of er nog nieuwe reviews binnenkomen. apps:read
search_reviews Filtert de reviews van één app op tekst, rating, sentiment (volgens de sterren, tenzij gelabeld), taal en datum. reviews:read
get_review Eén volledige review, met vertaling en een eventueel antwoord van de ontwikkelaar. reviews:read
list_reply_drafts AI-conceptantwoorden die wachten op goedkeuring. reviews:read
get_reply_draft Eén conceptantwoord op ID, met de huidige status, tekst en review-identificaties. reviews:read
generate_reply_draft Schrijft een AI-conceptantwoord voor menselijke goedkeuring. Het wordt nooit gepubliceerd. Schrijven reviews:write
start_app_analysis Zet een nieuwe AI-analyse van de reviews van een app in de wachtrij. Ondersteunt een proefrun. Schrijven apps:read (dry_run) / apps:write (start)
get_analysis_run Eén AI-analyserun: de status, fase, voortgang en eventuele fouten. apps:read
list_analysis_runs De AI-analyseruns van een app, nieuwste eerst, inclusief runs die na reviewsynchronisaties zijn gestart. apps:read
cancel_analysis_run Annuleert een AI-analyserun die nog moet worden uitgevoerd. Een run die al wordt verwerkt, gaat door. Schrijven apps:write
get_app_insights De nieuwste AI-analyse: samenvatting, belangrijkste problemen en sterke punten, functieverzoeken, bugs en onderwerpen. analytics:read
get_rating_history Dagelijkse of wekelijkse trend van de sterrenrating. analytics:read
get_cached_rating_forecast Bekijk een opgeslagen AI-waarderingsprognose zonder een nieuwe berekening te starten. analytics:read
get_rating_forecast AI-ratingprognose voor de komende 7 tot 90 dagen. Schrijven Het eerste verzoek kan beginnen met het genereren van de prognose. analytics:read + apps:write
list_feature_requests Functieverzoeken geëxtraheerd uit reviews. analytics:read
list_alerts Waarschuwingen die voor de workspace zijn gegenereerd. alerts:read
list_webhooks Webhook-endpoints en aantallen afleveringen. Secrets worden nooit teruggegeven. webhooks:manage
list_webhook_deliveries Recente afleveringspogingen voor één webhook. webhooks:manage
list_activity De activiteitenfeed van de workspace. analytics:read

Ook op de server

  • Resource tritonium://guides/agents: een gids voor agenten die met Tritonium werken.
  • Prompts triage_negative_reviews en investigate_rating_change: startpunten voor het triëren van negatieve reviews en het onderzoeken van een ratingverandering.

Machtigingen

U houdt de controle

Een agent werkt binnen de machtigingen die u hebt gegeven, en de beslissingen die uw klanten bereiken blijven bij uw team.

Beperkte, intrekbare toegang

Een aangemelde agent of een API-sleutel handelt altijd als workspacelid, beperkt tot zijn machtigingen. Beheerders en eigenaren verbreken de verbinding met agents onder Instellingen → API-sleutels → Verbonden agents en trekken sleutels in of vernieuwen ze onder Instellingen → API-sleutels. Leden verbreken de verbinding met hun eigen agents onder Instellingen → Beveiliging → Verbonden agents.

Niets wordt automatisch gepubliceerd

Controleer en keur conceptantwoorden goed in het dashboard. Publiceren vereist een ondersteunde verbinding en winkelgegevens; je kunt het antwoord ook naar de winkelconsole kopiëren om het handmatig te publiceren.

Zichtbaar gebruik

Het tabblad API-sleutels toont wanneer elke sleutel voor het laatst is gebruikt en hoeveel verzoeken deze heeft gedaan. Verbonden agents toont wie elke agent heeft verbonden en wanneer deze voor het laatst is gebruikt.

Wat agents niet kunnen doen

Deze acties blijven bij aangemelde beheerders en eigenaren in het Tritonium-dashboard. Geen API-sleutel en geen machtiging die u goed hebt gekeurd laat een agent deze uitvoeren:

  • Antwoorden in de app stores publiceren, goedkeuren of afwijzen
  • Apps verbinden, verwijderen of opnieuw synchroniseren
  • Waarschuwingen bevestigen of waarschuwingsregels bewerken
  • Webhooks maken of testen
  • Exports, facturering, team- en inloggegevensinstellingen

Limieten

Goed om te weten

  • De Tritonium CLI accepteert API-sleutels of aangeleverde OAuth-toegangstokens; de CLI meldt zich niet aan en vernieuwt geen tokens.
  • Dashboard-sessietokens worden niet geaccepteerd. Meld de agent aan of gebruik een API-sleutel.
  • Elke API-sleutel en elke aangemelde agent heeft een eigen budget, gedeeld met de REST API: 600 verzoeken per minuut en 60 nieuwe AI-concepten, analyses of prognoses per 10 minuten. Verzoeken zijn ook per IP-adres beperkt. Als een tool RATE_LIMITED retourneert, controleer dan retry_after_seconds voordat u het opnieuw probeert.
  • AI-analyse en conceptantwoorden gebruiken de AI-capaciteit van uw plan. Schattingen gebruiken geschreven reviews, niet alle winkelbeoordelingen. Nauwkeurigheid tegenover toekomstige getoonde winkelbeoordelingen is niet vastgesteld. Modelbereiken zijn geen gekalibreerde betrouwbaarheidsintervallen.
  • Browsergebaseerde clients kunnen alleen verbinding maken vanaf de eigen origins van Tritonium.
  • Grok Bot, xAI's gehoste agent, is niet getest met Tritonium.

Gestructureerde fouten

Fouten komen terug als toolresultaten met een stabiele error.code, een retryable-vlag en retry_after_seconds, zodat een agent weet of en wanneer hij het opnieuw moet proberen.

Foutcodes

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

Getest met

De client-instellingen op deze pagina zijn getest op met 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 en MCP Python SDK 2.2.0. Elk daarvan meldde zich aan bij de productieserver.

Breng uw app-beoordelingen naar uw agent

Verbind uw App Store- en Google Play-apps in Tritonium, voeg vervolgens de server toe aan uw agent en meld u aan.