Développeurs

Outils développeur · MCP

Utilisez Tritonium depuis votre agent IA

Tritonium exécute un serveur Model Context Protocol (MCP) distant. Connectez votre agent IA avec votre compte Tritonium, ou donnez-lui une clé à portée limitée, et il peut lire vos applications, avis, insights et prévisions de notation, et préparer des brouillons de réponse en attente de l'approbation de votre équipe.

Point de terminaison

Détails de connexion

Chaque client se connecte à la même URL. Les clients qui supportent la connexion MCP n'ont besoin de rien d'autre ; les autres envoient une clé API Tritonium.

Point de terminaison
https://api.tritonium.com/mcp
Transport
Streamable HTTP avec réponses JSON. Il n'y a ni flux SSE ni session.
Versions du protocole
MCP 2026-07-28, ainsi que les révisions antérieures basées sur initialize, de 2025-03-26 à 2025-11-25, sur la même URL.
Connexion
OAuth 2.1 avec PKCE, comme le décrit la spécification d'autorisation MCP. Une requête sans identifiants reçoit une réponse 401 qui pointe vers https://api.tritonium.com/.well-known/oauth-protected-resource/mcp. Les métadonnées du serveur d'autorisation se trouvent à https://api.tritonium.com/.well-known/oauth-authorization-server.
Clé API
Une clé API Tritonium, envoyée en tant que Authorization: Bearer <key> ou dans un en-tête X-API-Key. Les jetons de session du tableau de bord ne sont pas acceptés.
Contrôle d'état
https://api.tritonium.com/mcp/health

Démarrage rapide

Configurer en trois étapes

Ajoutez Tritonium à votre agent, connectez-vous et approuvez ce qu'il peut faire, puis posez une question à votre agent.

  1. Ajouter Tritonium à votre agent

    Chaque configuration ci-dessous ajoute le serveur par son URL. La première fois que l'agent se connecte, il vous demande de vous connecter à Tritonium. Chaque client montre aussi comment utiliser une clé API à la place.

    Claude Code

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

    Ensuite, exécutez /mcp dans Claude Code, choisissez tritonium et connectez-vous. Depuis un terminal, claude mcp login tritonium fait la même chose. Via SSH, ajoutez --no-browser : ouvrez le lien qu'il affiche sur votre propre ordinateur, et après approbation, collez l'adresse où votre navigateur aboutit dans le terminal.

    Utiliser une clé API à la place

    Créez d'abord une clé et stockez-la dans la variable d'environnement TRITONIUM_API_KEY, comme décrit sous Clés API.

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

    Les guillemets simples conservent ${TRITONIUM_API_KEY} tel quel dans la configuration enregistrée ; Claude Code lit la variable au moment de la connexion. Vérifiez la connexion avec claude mcp list.

    Codex

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

    Codex remarque que le serveur supporte la connexion et ouvre votre navigateur. Il demande chaque permission que le serveur offre, alors décochez celles dont votre agent n'a pas besoin avant d'approuver. Pour vous reconnecter plus tard, exécutez codex mcp login tritonium.

    Utiliser une clé API à la place

    Créez d'abord une clé et stockez-la dans la variable d'environnement TRITONIUM_API_KEY, comme décrit sous Clés API.

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

    Codex lit la clé à partir de la variable d'environnement TRITONIUM_API_KEY.

    Cursor

    Ajoutez ceci à .cursor/mcp.json dans un projet, ou à ~/.cursor/mcp.json pour tous vos projets. Ensuite, approuvez le serveur et connectez-vous avec Cursor CLI :

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

    Cursor CLI attend votre navigateur sur http://localhost:8787/callback, donc le port 8787 doit être libre sur l'ordinateur où il s'exécute. Via SSH, transférez ce port avec ssh -L 8787:localhost:8787 <host> ; Cursor CLI affiche le même conseil.

    Utiliser une clé API à la place

    Créez d'abord une clé et stockez-la dans la variable d'environnement TRITONIUM_API_KEY, comme décrit sous Clés API.

    Ajoutez ceci à .cursor/mcp.json dans un projet, ou à ~/.cursor/mcp.json pour tous vos projets.

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

    Cursor remplit ${env:TRITONIUM_API_KEY} à partir de votre environnement. Si Cursor signale une erreur d'authentification ou propose de se connecter, il n'a pas pu utiliser la clé : vérifiez que la variable est définie et que la clé est toujours active.

    GitHub Copilot CLI

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

    Ensuite, démarrez copilot et exécutez /mcp auth tritonium. La connexion ne démarre que dans une session interactive, pas avec copilot -p. Si Copilot dit toujours que le serveur nécessite une authentification après, redémarrez copilot : il utilise alors la connexion stockée, également avec copilot -p.

    Utiliser une clé API à la place

    Créez d'abord une clé et stockez-la dans la variable d'environnement TRITONIUM_API_KEY, comme décrit sous Clés API.

    Ajoutez ceci à ~/.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 remplit ${TRITONIUM_API_KEY} à partir de votre environnement.

    Grok CLI

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

    Ensuite, démarrez grok, ouvrez /mcps, sélectionnez tritonium et appuyez sur i pour vous connecter.

    Utiliser une clé API à la place

    Créez d'abord une clé et stockez-la dans la variable d'environnement TRITONIUM_API_KEY, comme décrit sous Clés API.

    Ajoutez ceci à ~/.grok/config.toml :

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

    Grok lit la clé à partir de la variable d'environnement TRITONIUM_API_KEY.

    Antigravity

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

    Ensuite, démarrez agy, ouvrez /mcp, choisissez tritonium et connectez-vous. Après votre approbation, votre navigateur affiche une page Antigravity avec un code : collez ce code dans agy. La connexion stockée fonctionne également avec agy --print.

    Utiliser une clé API à la place

    Créez d'abord une clé et stockez-la dans la variable d'environnement TRITONIUM_API_KEY, comme décrit sous Clés API.

    Ajoutez ceci à ~/.gemini/config/mcp_config.json et remplacez l'espace réservé par votre clé.

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

    Antigravity n'étend pas les variables d'environnement dans les en-têtes, donc la clé elle-même est stockée dans ce fichier. Gardez le fichier privé (chmod 600) et hors du contrôle de version.

    OpenClaw

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

    OpenClaw attend votre navigateur sur http://127.0.0.1:8989/oauth/callback. Si le navigateur ne peut pas le joindre, par exemple via SSH, terminez avec la commande openclaw mcp login tritonium --code <code> qu'OpenClaw affiche.

    Utiliser une clé API à la place

    Créez d'abord une clé et stockez-la dans la variable d'environnement TRITONIUM_API_KEY, comme décrit sous Clés API.

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

    Les guillemets simples gardent ${TRITONIUM_API_KEY} littéral dans la configuration enregistrée ; OpenClaw le remplit à partir de votre environnement quand il charge le serveur.

    Autres clients MCP

    Les clients qui supportent l'autorisation MCP n'ont besoin que de l'URL https://api.tritonium.com/mcp. Ils trouvent la connexion d'eux-mêmes à partir de la réponse 401 du serveur. Le support OAuth intégré du SDK Python MCP officiel fonctionne sans aucun paramètre spécifique à Tritonium.

    Les clients qui ne peuvent pas se connecter peuvent utiliser une clé API s'ils supportent les serveurs HTTP Streamable distants avec en-têtes personnalisés : envoyez l'en-tête Authorization: Bearer <key>.

  2. Se connecter et approuver

    La première fois que votre agent se connecte, il ouvre Tritonium dans votre navigateur. Connectez-vous, vérifiez quelle application demande et où elle envoie l'accès, choisissez ce que l'agent peut voir et faire, puis approuvez. L'agent travaille alors pour vous, dans les limites des permissions que vous avez choisies.

    Chaque membre de l'espace de travail peut approuver

    • Vos applications apps:read Voir vos applications et leurs détails.
    • Avis et réponses reviews:read Lire les avis, réponses et brouillons de réponse.
    • Analyses et statistiques analytics:read Lire les analyses, notes, prévisions et activité.
    • Alertes déclenchées alerts:read Lire les alertes que votre espace de travail a reçues.

    Les administrateurs et propriétaires peuvent aussi approuver

    • Brouillons de réponse reviews:write Rédiger des brouillons de réponse pour que votre équipe les examine. L'agent ne peut pas les publier.
    • Lancer analyses et prévisions apps:write Lancer une analyse IA ou une prévision de note ou de sentiment, ou annuler une analyse encore en attente.
    • Paramètres webhook webhooks:manage Lire les paramètres webhook et les journaux de livraison, sans les modifier.
  3. Posez une question à votre agent

    Essayez par exemple l'une de ces invites. Votre agent choisit les outils, et tout brouillon de réponse qu'il rédige attend une approbation dans Tritonium.

    • Laquelle de mes apps a reçu le plus d'avis à une étoile cette semaine, et de quoi les gens se plaignent-ils ?
    • Résumez la dernière analyse IA de mon app iOS et listez les principales demandes de fonctionnalités.
    • Notre note a baissé la semaine dernière. Comparez l'historique de la note avec les avis récents et dites-moi ce qui a changé.
    • Rédigez des réponses aux cinq avis négatifs les plus récents pour que je puisse les approuver dans Tritonium.

Clés API

Utiliser une clé API à la place

Les clés API fonctionnent toujours avec chaque client de cette page. Utilisez-en une quand votre client ne peut pas se connecter, pour les scripts et la CI ou avec Tritonium CLI.

Créer une clé API

Un administrateur ou propriétaire de l'espace de travail crée les clés dans le tableau de bord Tritonium, sous Paramètres → Clés API. Accordez à la clé uniquement les portées dont votre agent a besoin, puis définissez-la comme variable d'environnement là où votre client s'exécute :

Terminal
export TRITONIUM_API_KEY="trtn_live_…"

Ensuite, ouvrez Utiliser une clé API à la place dans la configuration de votre client ci-dessus.

Pour les scripts et la CI, la CLI Tritonium appelle les mêmes outils et renvoie du JSON. Consultez le Guide CLI.

Référence

Outils

Le serveur a 21 outils. Votre agent ne voit que les outils que ses permissions permettent, et une portée :write accorde aussi l'accès en lecture dans le même domaine.

Outils MCP Tritonium avec la portée requise pour chacun
Outil Ce qu'il fait Portée
get_workspace_context Votre espace de travail, les portées accordées, et quels outils l'agent peut utiliser. Toujours disponible
list_apps Apps avec nombre d'avis, statut de synchronisation et d'analyse, et si de nouveaux avis arrivent encore. apps:read
get_app Détails d'une app, avec le statut actuel de synchronisation et d'analyse, et si de nouveaux avis arrivent encore. apps:read
search_reviews Filtre les avis d'une app par texte, note, sentiment (d'après les étoiles, sauf si étiqueté), langue et date. reviews:read
get_review Un avis complet, avec sa traduction et l'éventuelle réponse du développeur. reviews:read
list_reply_drafts Brouillons de réponse IA en attente d'approbation. reviews:read
get_reply_draft Un brouillon de réponse par ID, avec son état actuel, son texte et les identifiants de l’avis. reviews:read
generate_reply_draft Rédige un brouillon de réponse IA pour approbation humaine. Il n'est jamais publié. Écriture reviews:write
start_app_analysis Met en file d'attente une nouvelle analyse IA des avis d'une app. Prend en charge une exécution à blanc. Écriture apps:read (dry_run) / apps:write (start)
get_analysis_run Une exécution d'analyse IA : son statut, son étape, sa progression et toute défaillance. apps:read
list_analysis_runs Les exécutions d'analyse IA d'une app, les plus récentes en premier, y compris celles lancées après une synchronisation des avis. apps:read
cancel_analysis_run Annule une exécution d'analyse IA qui attend encore de s'exécuter. Une exécution déjà en cours de traitement continue. Écriture apps:write
get_app_insights La dernière analyse IA : résumé, principaux problèmes et points forts, demandes de fonctionnalités, bugs et sujets. analytics:read
get_rating_history Tendance quotidienne ou hebdomadaire de la note en étoiles. analytics:read
get_cached_rating_forecast Consultez une prévision de note en cache sans lancer de nouvelle génération. analytics:read
get_rating_forecast Prévision IA de la note pour les 7 à 90 prochains jours. Écriture La première requête peut commencer à générer la prévision. analytics:read + apps:write
list_feature_requests Demandes de fonctionnalités extraites des avis. analytics:read
list_alerts Alertes déclenchées pour l'espace de travail. alerts:read
list_webhooks Points de terminaison webhook et nombre de livraisons. Les secrets ne sont jamais renvoyés. webhooks:manage
list_webhook_deliveries Tentatives de livraison récentes pour un webhook. webhooks:manage
list_activity Le flux d'activité de l'espace de travail. analytics:read

Aussi sur le serveur

  • Ressource tritonium://guides/agents : un guide pour les agents travaillant avec Tritonium.
  • Invites triage_negative_reviews et investigate_rating_change : points de départ pour trier les avis négatifs et analyser un changement de note.

Autorisations

Vous gardez le contrôle

Un agent fonctionne dans les limites des permissions que vous lui avez données, et les décisions qui atteignent vos clients restent avec votre équipe.

Accès à portées limitées et révocable

Un agent connecté ou une clé API agit toujours en tant que membre de l'espace de travail limité à ses permissions. Les administrateurs et propriétaires déconnectent les agents sous Paramètres → Clés API → Agents connectés et révoquent ou renouvellent les clés sous Paramètres → Clés API. Les membres déconnectent leurs propres agents sous Paramètres → Sécurité → Agents connectés.

Rien n'est publié automatiquement

Vérifiez et approuvez les brouillons dans le tableau de bord. La publication nécessite une connexion compatible et les identifiants de la boutique ; vous pouvez aussi copier la réponse dans la console de la boutique pour la publier manuellement.

Utilisation visible

L'onglet Clés API affiche quand chaque clé a été utilisée pour la dernière fois et combien de requêtes elle a effectuées. Agents connectés affiche qui a connecté chaque agent et quand il a été utilisé pour la dernière fois.

Ce que les agents ne peuvent pas faire

Ces actions restent avec les administrateurs et propriétaires connectés dans le tableau de bord Tritonium. Aucune clé API et aucune permission que vous approuvez ne permet à un agent de les prendre :

  • Publier, approuver ou rejeter des réponses dans les app stores
  • Connecter, supprimer ou resynchroniser des apps
  • Accuser réception des alertes ou modifier les règles d'alerte
  • Créer ou tester des webhooks
  • Exports, facturation, paramètres d'équipe et d'identifiants

Limites

Bon à savoir

  • Tritonium CLI accepte les clés API ou les jetons d’accès OAuth fournis ; il ne se connecte pas et ne renouvelle pas les jetons.
  • Les jetons de session du tableau de bord ne sont pas acceptés. Connectez l'agent ou utilisez une clé API.
  • Chaque clé API et chaque agent connecté dispose de son propre quota, partagé avec l'API REST : 600 requêtes par minute et 60 nouveaux brouillons, analyses ou prévisions IA toutes les 10 minutes. Les requêtes sont aussi limitées par adresse IP. Quand un outil renvoie RATE_LIMITED, vérifiez retry_after_seconds avant de réessayer.
  • L'analyse IA et les brouillons de réponse utilisent la capacité IA de votre plan. Les estimations utilisent les avis écrits, pas toutes les notes de la boutique. La précision face aux futures notes affichées en boutique n’est pas établie. Les plages du modèle ne sont pas des intervalles de confiance calibrés.
  • Les clients web ne peuvent se connecter que depuis les origines propres à Tritonium.
  • Grok Bot, l'agent hébergé de xAI, n'a pas été testé avec Tritonium.

Erreurs structurées

Les échecs sont renvoyés sous forme de résultats d'outil avec un error.code stable, un indicateur retryable et retry_after_seconds, pour qu'un agent sache s'il doit réessayer et quand.

Codes d'erreur

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

Testé avec

Les configurations de client sur cette page ont été testées le avec 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 et MCP Python SDK 2.2.0. Chacune d'elles s'est connectée au serveur de production.

Donnez à votre agent accès à vos avis d'applications

Connectez vos applications App Store et Google Play dans Tritonium, puis ajoutez le serveur à votre agent et connectez-vous.