Desenvolvedores

Ferramentas para desenvolvedores · MCP

Use o Tritonium no seu agente de IA

Tritonium executa um servidor remoto do Model Context Protocol (MCP). Entre com seu agente de IA usando sua conta do Tritonium, ou dê a ele uma chave com escopo, e ele pode ler seus apps, avaliações, insights e previsões de classificação, e preparar rascunhos de respostas que aguardam a aprovação da sua equipe.

Ponto de acesso

Detalhes da conexão

Cada cliente se conecta à mesma URL. Clientes que suportam entrada MCP não precisam de mais nada; os outros enviam uma chave de API do Tritonium.

Endpoint
https://api.tritonium.com/mcp
Transporte
Streamable HTTP com respostas JSON. Não há fluxo SSE nem sessão.
Versões do protocolo
MCP 2026-07-28 e as revisões anteriores baseadas em initialize, de 2025-03-26 a 2025-11-25, na mesma URL.
Login
OAuth 2.1 com PKCE, conforme a especificação de autorização MCP descreve. Uma solicitação sem credenciais recebe uma resposta 401 que aponta para https://api.tritonium.com/.well-known/oauth-protected-resource/mcp. Os metadados do servidor de autorização estão em https://api.tritonium.com/.well-known/oauth-authorization-server.
Chave de API
Uma chave de API do Tritonium, enviada como Authorization: Bearer <key> ou no header X-API-Key. Tokens de sessão do dashboard não são aceitos.
Verificação de status
https://api.tritonium.com/mcp/health

Início rápido

Configure em três etapas

Adicione Tritonium ao seu agente, entre e aprove o que ele pode fazer, depois faça uma pergunta ao seu agente.

  1. Adicionar Tritonium ao seu agente

    Cada configuração abaixo adiciona o servidor pela sua URL. Na primeira vez que o agente se conecta, ele pede que você entre no Tritonium. Cada cliente também mostra como usar uma chave de API em vez disso.

    Claude Code

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

    Depois execute /mcp no Claude Code, escolha tritonium e entre. De um terminal, claude mcp login tritonium faz o mesmo. Via SSH, adicione --no-browser: abra o link que ele imprime em seu próprio computador, e depois que você aprovar, cole o endereço em que seu navegador termina de volta no terminal.

    Use uma chave de API em vez disso

    Primeiro crie uma chave e armazene-a na variável de ambiente TRITONIUM_API_KEY, conforme descrito em Chaves de API.

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

    As aspas simples mantêm ${TRITONIUM_API_KEY} literal na configuração salva; Claude Code lê a variável quando se conecta. Verifique a conexão com claude mcp list.

    Codex

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

    Codex percebe que o servidor suporta entrada e abre seu navegador. Ele pede todas as permissões que o servidor oferece, então desmarque as que seu agente não precisa antes de aprovar. Para entrar novamente depois, execute codex mcp login tritonium.

    Use uma chave de API em vez disso

    Primeiro crie uma chave e armazene-a na variável de ambiente TRITONIUM_API_KEY, conforme descrito em Chaves de API.

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

    Codex lê a chave da variável de ambiente TRITONIUM_API_KEY.

    Cursor

    Adicione isto a .cursor/mcp.json em um projeto, ou a ~/.cursor/mcp.json para todos os seus projetos. Depois aprove o servidor e entre com o Cursor CLI:

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

    O Cursor CLI aguarda seu navegador em http://localhost:8787/callback, então a porta 8787 deve estar livre no computador onde ele é executado. Via SSH, encaminhe essa porta com ssh -L 8787:localhost:8787 <host>; o Cursor CLI imprime a mesma dica.

    Use uma chave de API em vez disso

    Primeiro crie uma chave e armazene-a na variável de ambiente TRITONIUM_API_KEY, conforme descrito em Chaves de API.

    Adicione isto a .cursor/mcp.json em um projeto, ou a ~/.cursor/mcp.json para todos os seus projetos.

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

    Cursor preenche ${env:TRITONIUM_API_KEY} do seu ambiente. Se Cursor relatar um erro de autenticação ou oferecer para entrar, ele não conseguiu usar a chave: verifique se a variável está definida e a chave ainda está ativa.

    GitHub Copilot CLI

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

    Em seguida, inicie copilot e execute /mcp auth tritonium. A entrada só começa em uma sessão interativa, não com copilot -p. Se o Copilot ainda disser que o servidor requer autenticação depois, reinicie copilot: ele então usa a entrada armazenada, também com copilot -p.

    Use uma chave de API em vez disso

    Primeiro crie uma chave e armazene-a na variável de ambiente TRITONIUM_API_KEY, conforme descrito em Chaves de API.

    Adicione isto 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 preenche ${TRITONIUM_API_KEY} do seu ambiente.

    Grok CLI

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

    Em seguida, inicie grok, abra /mcps, selecione tritonium e pressione i para entrar.

    Use uma chave de API em vez disso

    Primeiro crie uma chave e armazene-a na variável de ambiente TRITONIUM_API_KEY, conforme descrito em Chaves de API.

    Adicione isto a ~/.grok/config.toml:

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

    Grok lê a chave da variável de ambiente TRITONIUM_API_KEY.

    Antigravity

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

    Em seguida, inicie agy, abra /mcp, escolha tritonium e entre. Depois que você aprovar, seu navegador mostra uma página do Antigravity com um código: cole esse código em agy. A entrada armazenada também funciona com agy --print.

    Use uma chave de API em vez disso

    Primeiro crie uma chave e armazene-a na variável de ambiente TRITONIUM_API_KEY, conforme descrito em Chaves de API.

    Adicione isto a ~/.gemini/config/mcp_config.json e substitua o placeholder pela sua chave.

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

    Antigravity não expande variáveis de ambiente em headers, então a chave em si é armazenada neste arquivo. Mantenha o arquivo privado (chmod 600) e fora do controle de versão.

    OpenClaw

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

    OpenClaw aguarda seu navegador em http://127.0.0.1:8989/oauth/callback. Se o navegador não conseguir alcançá-lo, por exemplo via SSH, termine com o comando openclaw mcp login tritonium --code <code> que OpenClaw imprime.

    Use uma chave de API em vez disso

    Primeiro crie uma chave e armazene-a na variável de ambiente TRITONIUM_API_KEY, conforme descrito em Chaves de API.

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

    As aspas simples mantêm ${TRITONIUM_API_KEY} literal na configuração salva; OpenClaw a preenche do seu ambiente quando carrega o servidor.

    Outros clientes MCP

    Clientes que suportam autorização MCP precisam apenas da URL https://api.tritonium.com/mcp. Eles encontram a entrada por conta própria na resposta 401 do servidor. O suporte OAuth integrado do SDK Python MCP oficial funciona sem nenhuma configuração específica do Tritonium.

    Clientes que não conseguem entrar podem usar uma chave de API se suportarem servidores HTTP Streamable remotos com headers personalizados: envie o header Authorization: Bearer <key>.

  2. Entre e aprove

    Na primeira vez que seu agente se conecta, ele abre Tritonium em seu navegador. Entre, verifique qual app está pedindo e para onde ele envia acesso, escolha o que o agente pode ver e fazer, depois aprove. O agente então trabalha para você, dentro das permissões que você escolheu.

    Todo membro do workspace pode aprovar

    • Seus apps apps:read Ver seus apps e seus detalhes.
    • Avaliações e respostas reviews:read Ler avaliações, respostas e rascunhos de resposta.
    • Insights e análises analytics:read Ler insights, classificações, previsões e atividade.
    • Alertas acionados alerts:read Ler os alertas que seu espaço de trabalho recebeu.

    Admins e proprietários também podem aprovar

    • Rascunhos de resposta reviews:write Redigir rascunhos de resposta para sua equipe revisar. O agente não pode publicá-los.
    • Iniciar análises e previsões apps:write Inicie uma análise por IA ou uma previsão de classificação ou de sentimento, ou cancele uma análise ainda em espera.
    • Configurações de webhook webhooks:manage Ler configurações de webhook e logs de entrega, sem alterá-los.
  3. Faça uma pergunta ao seu agente

    Experimente um prompt como estes. Seu agente escolhe as ferramentas, e qualquer resposta que ele rascunhar aguarda aprovação no Tritonium.

    • Qual dos meus apps recebeu mais avaliações de uma estrela esta semana, e do que as pessoas estão reclamando?
    • Resuma a análise de IA mais recente do meu app iOS e liste as principais solicitações de recursos.
    • Nossa nota caiu na semana passada. Compare o histórico da nota com as avaliações recentes e me diga o que mudou.
    • Rascunhe respostas para as cinco avaliações negativas mais recentes para que eu possa aprová-las no Tritonium.

Chaves de API

Use uma chave de API em vez disso

Chaves de API ainda funcionam com cada cliente nesta página. Use uma quando seu cliente não conseguir entrar, para scripts e CI ou com o Tritonium CLI.

Criar uma chave de API

Um admin ou proprietário do workspace cria as chaves no dashboard do Tritonium, em Configurações → Chaves de API. Dê à chave apenas os escopos de que seu agente precisa e depois defina-a como variável de ambiente onde seu cliente é executado:

Terminal
export TRITONIUM_API_KEY="trtn_live_…"

Depois abra Use uma chave de API em vez disso na configuração do seu cliente acima.

Para scripts e CI, a CLI do Tritonium chama as mesmas ferramentas e imprime JSON. Veja o guia da CLI.

Referência

Ferramentas

O servidor tem 21 ferramentas. Seu agente vê apenas as ferramentas que suas permissões permitem, e um escopo :write também concede acesso de leitura no mesmo domínio.

Ferramentas MCP do Tritonium com o escopo que cada uma exige
Ferramenta O que faz Escopo
get_workspace_context Seu workspace, os escopos concedidos e quais ferramentas o agente pode usar. Sempre disponível
list_apps Apps com contagens de avaliações, status de sincronização e análise e se novas avaliações ainda estão chegando. apps:read
get_app Detalhes de um app, status de sincronização e análise atual e se novas avaliações ainda estão chegando. apps:read
search_reviews Filtra as avaliações de um app por texto, nota, sentimento (pelas estrelas, salvo se rotulada), idioma e data. reviews:read
get_review Uma avaliação completa, com a tradução e a resposta do desenvolvedor, se houver. reviews:read
list_reply_drafts Rascunhos de respostas de IA aguardando aprovação. reviews:read
get_reply_draft Um rascunho de resposta por ID, com status atual, texto e identificadores da avaliação. reviews:read
generate_reply_draft Escreve um rascunho de resposta de IA para aprovação humana. Nunca é publicado. Escrita reviews:write
start_app_analysis Coloca na fila uma nova análise de IA das avaliações de um app. Suporta uma execução de teste. Escrita apps:read (dry_run) / apps:write (start)
get_analysis_run Uma execução de análise de IA: seu status, estágio, progresso e qualquer falha. apps:read
list_analysis_runs As execuções de análise de IA de um app, das mais recentes para as mais antigas, incluindo as iniciadas após uma sincronização de avaliações. apps:read
cancel_analysis_run Cancela uma execução de análise de IA que ainda está aguardando para ser executada. Uma execução que já está sendo processada continua. Escrita apps:write
get_app_insights A análise de IA mais recente: resumo, principais problemas e pontos fortes, solicitações de recursos, bugs e tópicos. analytics:read
get_rating_history Tendência diária ou semanal da nota em estrelas. analytics:read
get_cached_rating_forecast Consulte uma previsão de avaliação em cache sem iniciar uma nova geração. analytics:read
get_rating_forecast Previsão de nota por IA para os próximos 7 a 90 dias. Escrita A primeira solicitação pode iniciar a geração da previsão. analytics:read + apps:write
list_feature_requests Solicitações de recursos extraídas de avaliações. analytics:read
list_alerts Alertas gerados para o workspace. alerts:read
list_webhooks Endpoints de webhook e contagens de entrega. Segredos nunca são retornados. webhooks:manage
list_webhook_deliveries Tentativas de entrega recentes para um webhook. webhooks:manage
list_activity O feed de atividade do workspace. analytics:read

Também no servidor

  • Recurso tritonium://guides/agents: um guia para agentes que trabalham com o Tritonium.
  • Prompts triage_negative_reviews e investigate_rating_change: pontos de partida para a triagem de avaliações negativas e a investigação de uma mudança de nota.

Permissões

Você mantém o controle

Um agente trabalha dentro das permissões que você deu a ele, e as decisões que chegam aos seus clientes ficam com sua equipe.

Acesso com escopo e revogável

Um agente conectado ou uma chave de API sempre atua como um membro do workspace limitado às suas permissões. Administradores e proprietários desconectam agentes em Configurações → Chaves de API → Agentes conectados e revogam ou rotacionam chaves em Configurações → Chaves de API. Membros desconectam seus próprios agentes em Configurações → Segurança → Agentes conectados.

Nada é publicado automaticamente

Revise e aprove rascunhos no painel. A publicação requer uma conexão compatível e credenciais da loja; você também pode copiar a resposta para o console da loja para publicá-la manualmente.

Uso visível

A aba Chaves de API mostra quando cada chave foi usada pela última vez e quantas solicitações ela fez. Agentes conectados mostra quem conectou cada agente e quando foi usado pela última vez.

O que os agentes não podem fazer

Essas ações ficam com admins e proprietários conectados no dashboard do Tritonium. Nenhuma chave de API e nenhuma permissão que você aprova permite que um agente as execute:

  • Publicar, aprovar ou rejeitar respostas nas lojas de apps
  • Conectar, excluir ou ressincronizar apps
  • Reconhecer alertas ou editar regras de alerta
  • Criar ou testar webhooks
  • Exportações, faturamento, equipe e configurações de credenciais

Limites

Bom saber

  • A CLI do Tritonium aceita chaves de API ou tokens de acesso OAuth fornecidos; ela não faz login nem renova tokens.
  • Tokens de sessão do dashboard não são aceitos. Entre com o agente ou use uma chave de API.
  • Cada chave de API e cada agente conectado tem seu próprio orçamento, compartilhado com a REST API: 600 requisições por minuto, e 60 novos rascunhos, análises ou previsões de IA a cada 10 minutos. Requisições também são limitadas por endereço IP. Quando uma ferramenta retorna RATE_LIMITED, verifique retry_after_seconds antes de tentar novamente.
  • Análise de IA e rascunhos de respostas usam a capacidade de IA do seu plano. As estimativas usam avaliações escritas, não todas as notas da loja. A precisão em relação às futuras notas exibidas na loja não foi estabelecida. As faixas do modelo não são intervalos de confiança calibrados.
  • Clientes baseados em navegador só podem se conectar a partir das origens do próprio Tritonium.
  • Grok Bot, o agente hospedado da xAI, não foi testado com Tritonium.

Erros estruturados

Falhas retornam como resultados de ferramentas com um error.code estável, um sinalizador retryable e retry_after_seconds, para que um agente saiba se e quando tentar novamente.

Códigos de erro

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

Testado com

As configurações de cliente nesta página foram testadas em com 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. Cada uma delas entrou no servidor de produção.

Leve suas avaliações de app para seu agente

Conecte seus apps do App Store e Google Play no Tritonium, depois adicione o servidor ao seu agente e entre.