Desarrolladores

Herramientas para desarrolladores · MCP

Usa Tritonium desde tu agente de IA

Tritonium ejecuta un servidor remoto del Protocolo de Contexto de Modelo (MCP). Inicia sesión en tu agente de IA con tu cuenta de Tritonium, o dale una clave API con alcances, y podrá leer tus apps, reseñas, insights y pronósticos de calificación, y preparar borradores de respuestas que esperan la aprobación de tu equipo.

Punto de conexión

Detalles de conexión

Cada cliente se conecta a la misma URL. Los clientes que admiten inicio de sesión MCP no necesitan nada más; los otros envían una clave API de Tritonium.

Endpoint
https://api.tritonium.com/mcp
Transporte
Streamable HTTP con respuestas JSON. No hay flujo SSE ni sesión.
Versiones del protocolo
MCP 2026-07-28 y las revisiones anteriores basadas en initialize, de 2025-03-26 a 2025-11-25, en la misma URL.
Inicio de sesión
OAuth 2.1 con PKCE, como describe la especificación de autorización de MCP. Una solicitud sin credenciales obtiene una respuesta 401 que apunta a https://api.tritonium.com/.well-known/oauth-protected-resource/mcp. Los metadatos del servidor de autorización están en https://api.tritonium.com/.well-known/oauth-authorization-server.
Clave API
Una clave API de Tritonium, enviada como Authorization: Bearer <key> o en un encabezado X-API-Key. Los tokens de sesión del dashboard no se aceptan.
Verificación de estado
https://api.tritonium.com/mcp/health

Inicio rápido

Configura en tres pasos

Añade Tritonium a tu agente, inicia sesión y aprueba qué puede hacer, luego haz una pregunta a tu agente.

  1. Añade Tritonium a tu agente

    Cada configuración a continuación añade el servidor por su URL. La primera vez que el agente se conecta, te pide que inicies sesión en Tritonium. Cada cliente también muestra cómo usar una clave API en su lugar.

    Claude Code

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

    Luego ejecuta /mcp en Claude Code, elige tritonium e inicia sesión. Desde una terminal, claude mcp login tritonium hace lo mismo. Por SSH, añade --no-browser: abre el enlace que imprime en tu propio ordenador, y después de que apruebes, pega la dirección en la que termina tu navegador de vuelta en la terminal.

    Usa una clave API en su lugar

    Primero crea una clave y guárdala en la variable de entorno TRITONIUM_API_KEY, como se describe en Claves API.

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

    Las comillas simples mantienen ${TRITONIUM_API_KEY} de forma literal en la configuración guardada; Claude Code lee la variable al conectarse. Comprueba la conexión con claude mcp list.

    Codex

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

    Codex nota que el servidor admite inicio de sesión y abre tu navegador. Pide cada permiso que ofrece el servidor, así que desmarca los que tu agente no necesita antes de que apruebes. Para iniciar sesión de nuevo más tarde, ejecuta codex mcp login tritonium.

    Usa una clave API en su lugar

    Primero crea una clave y guárdala en la variable de entorno TRITONIUM_API_KEY, como se describe en Claves API.

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

    Codex lee la clave de la variable de entorno TRITONIUM_API_KEY.

    Cursor

    Añade esto a .cursor/mcp.json en un proyecto, o a ~/.cursor/mcp.json para todos tus proyectos. Luego aprueba el servidor e inicia sesión con 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 espera tu navegador en http://localhost:8787/callback, así que el puerto 8787 debe estar libre en la computadora donde se ejecuta. Por SSH, reenvía ese puerto con ssh -L 8787:localhost:8787 <host>; Cursor CLI imprime la misma sugerencia.

    Usa una clave API en su lugar

    Primero crea una clave y guárdala en la variable de entorno TRITONIUM_API_KEY, como se describe en Claves API.

    Añade esto a .cursor/mcp.json en un proyecto, o a ~/.cursor/mcp.json para todos tus proyectos.

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

    Cursor rellena ${env:TRITONIUM_API_KEY} desde tu entorno. Si Cursor reporta un error de autenticación u ofrece iniciar sesión, no pudo usar la clave: comprueba que la variable está establecida y la clave sigue activa.

    GitHub Copilot CLI

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

    Luego inicia copilot y ejecuta /mcp auth tritonium. El inicio de sesión solo comienza en una sesión interactiva, no con copilot -p. Si Copilot aún dice que el servidor requiere autenticación después, reinicia copilot: entonces usa el inicio de sesión almacenado, también con copilot -p.

    Usa una clave API en su lugar

    Primero crea una clave y guárdala en la variable de entorno TRITONIUM_API_KEY, como se describe en Claves API.

    Añade esto 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 rellena ${TRITONIUM_API_KEY} desde tu entorno.

    Grok CLI

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

    Luego inicia grok, abre /mcps, selecciona tritonium y presiona i para iniciar sesión.

    Usa una clave API en su lugar

    Primero crea una clave y guárdala en la variable de entorno TRITONIUM_API_KEY, como se describe en Claves API.

    Añade esto a ~/.grok/config.toml:

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

    Grok lee la clave de la variable de entorno TRITONIUM_API_KEY.

    Antigravity

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

    Luego inicia agy, abre /mcp, elige tritonium e inicia sesión. Después de que apruebes, tu navegador muestra una página de Antigravity con un código: pega ese código en agy. El inicio de sesión almacenado también funciona con agy --print.

    Usa una clave API en su lugar

    Primero crea una clave y guárdala en la variable de entorno TRITONIUM_API_KEY, como se describe en Claves API.

    Añade esto a ~/.gemini/config/mcp_config.json y reemplaza el marcador de posición con tu clave.

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

    Antigravity no expande variables de entorno en encabezados, así que la clave misma se almacena en este archivo. Mantén el archivo privado (chmod 600) y fuera del control de versiones.

    OpenClaw

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

    OpenClaw espera tu navegador en http://127.0.0.1:8989/oauth/callback. Si el navegador no puede alcanzarlo, por ejemplo por SSH, termina con el comando openclaw mcp login tritonium --code <code> que OpenClaw imprime.

    Usa una clave API en su lugar

    Primero crea una clave y guárdala en la variable de entorno TRITONIUM_API_KEY, como se describe en Claves API.

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

    Las comillas simples mantienen ${TRITONIUM_API_KEY} literal en la configuración guardada; OpenClaw la rellena desde tu entorno cuando carga el servidor.

    Otros clientes MCP

    Los clientes que admiten autorización MCP solo necesitan la URL https://api.tritonium.com/mcp. Encuentran el inicio de sesión por su cuenta en la respuesta 401 del servidor. El soporte OAuth integrado del SDK oficial de MCP de Python funciona sin ninguna configuración específica de Tritonium.

    Los clientes que no pueden iniciar sesión pueden usar una clave API si admiten servidores HTTP Streamable remotos con encabezados personalizados: envía el encabezado Authorization: Bearer <key>.

  2. Inicia sesión y aprueba

    La primera vez que tu agente se conecta, abre Tritonium en tu navegador. Inicia sesión, comprueba qué app está pidiendo y dónde envía el acceso, elige qué puede ver y hacer el agente, luego aprueba. El agente entonces trabaja para ti, dentro de los permisos que elegiste.

    Cada miembro del workspace puede aprobar

    • Tus aplicaciones apps:read Ver tus aplicaciones y sus detalles.
    • Reseñas y respuestas reviews:read Leer reseñas, respuestas y borradores de respuesta.
    • Perspectivas y análisis analytics:read Leer perspectivas, calificaciones, pronósticos y actividad.
    • Alertas activadas alerts:read Leer las alertas que tu espacio de trabajo ha recibido.

    Los admins y propietarios también pueden aprobar

    • Borradores de respuesta reviews:write Escribir borradores de respuesta para que tu equipo revise. El agente no puede publicarlos.
    • Iniciar análisis y previsiones apps:write Inicia un análisis con IA o una previsión de calificación o de sentimiento, o cancela un análisis que aún está en espera.
    • Configuración de webhooks webhooks:manage Leer la configuración de webhooks y registros de entrega, sin cambiarlos.
  3. Pregunta a tu agente

    Prueba con un prompt como estos. Tu agente elige las herramientas, y cualquier respuesta que redacte espera aprobación en Tritonium.

    • ¿Cuál de mis apps recibió más reseñas de una estrella esta semana y de qué se queja la gente?
    • Resume el último análisis de IA para mi app de iOS y lista las principales solicitudes de funciones.
    • Mi calificación bajó la semana pasada. Compara el historial de calificación con las reseñas recientes y dime qué cambió.
    • Redacta respuestas a las cinco reseñas negativas más recientes para que pueda aprobarlas en Tritonium.

Claves API

Usa una clave API en su lugar

Las claves API siguen funcionando con cada cliente de esta página. Usa una cuando tu cliente no pueda iniciar sesión, para scripts y CI o con Tritonium CLI.

Crea una clave API

Un administrador o propietario del workspace crea las claves en el dashboard de Tritonium, en Configuración → Claves API. Dale a la clave solo los alcances que tu agente necesita y luego defínela como variable de entorno donde se ejecuta tu cliente:

Terminal
export TRITONIUM_API_KEY="trtn_live_…"

Luego abre Usa una clave API en su lugar en la configuración de tu cliente arriba.

Para scripts y CI, Tritonium CLI llama a las mismas herramientas e imprime JSON. Consulta la guía de CLI.

Referencia

Herramientas

El servidor tiene 21 herramientas. Tu agente ve solo las herramientas que sus permisos permiten, y un alcance :write también otorga acceso de lectura en el mismo dominio.

Herramientas MCP de Tritonium con el alcance que cada una necesita
Herramienta Qué hace Alcance
get_workspace_context Tu workspace, los alcances otorgados, y qué herramientas puede usar el agente. Siempre disponible
list_apps Apps con conteos de reseñas, estado de sincronización y análisis, y si siguen llegando reseñas nuevas. apps:read
get_app Detalles de una app, estado actual de sincronización y análisis, y si siguen llegando reseñas nuevas. apps:read
search_reviews Filtra las reseñas de una app por texto, calificación, sentimiento (según las estrellas, salvo que tenga etiqueta), idioma y fecha. reviews:read
get_review Una reseña completa, con su traducción y la respuesta del desarrollador, si la hay. reviews:read
list_reply_drafts Borradores de respuesta de IA pendientes de aprobación. reviews:read
get_reply_draft Un borrador de respuesta por ID, con su estado actual, texto e identificadores de reseña. reviews:read
generate_reply_draft Redacta un borrador de respuesta de IA para aprobación humana. Nunca se publica. Escritura reviews:write
start_app_analysis Pone en cola un nuevo análisis de IA de las reseñas de una app. Soporta una ejecución de prueba. Escritura apps:read (dry_run) / apps:write (start)
get_analysis_run Una ejecución de análisis de IA: su estado, etapa, progreso y cualquier fallo. apps:read
list_analysis_runs Las ejecuciones de análisis de IA de una app, de la más reciente a la más antigua, incluidas las iniciadas tras una sincronización de reseñas. apps:read
cancel_analysis_run Cancela una ejecución de análisis de IA que aún está esperando ejecutarse. Una ejecución que ya se está procesando continúa. Escritura apps:write
get_app_insights El último análisis de IA: resumen, problemas clave y fortalezas, solicitudes de funciones, bugs y temas. analytics:read
get_rating_history Tendencia diaria o semanal de la calificación en estrellas. analytics:read
get_cached_rating_forecast Consulta una previsión de valoración en caché sin iniciar una nueva generación. analytics:read
get_rating_forecast Pronóstico de calificación de IA para los próximos 7 a 90 días. Escritura La primera solicitud puede comenzar a generar el pronóstico. analytics:read + apps:write
list_feature_requests Solicitudes de funciones extraídas de reseñas. analytics:read
list_alerts Alertas generadas para el workspace. alerts:read
list_webhooks Endpoints de webhook y conteos de entregas. Los secretos nunca se devuelven. webhooks:manage
list_webhook_deliveries Intentos de entrega recientes para un webhook. webhooks:manage
list_activity El feed de actividad del workspace. analytics:read

También en el servidor

  • Recurso tritonium://guides/agents: una guía para agentes que trabajan con Tritonium.
  • Prompts triage_negative_reviews y investigate_rating_change: puntos de partida para clasificar reseñas negativas e investigar un cambio de calificación.

Permisos

Tú tienes el control

Un agente trabaja dentro de los permisos que le diste, y las decisiones que llegan a tus clientes se quedan con tu equipo.

Acceso con alcances y revocable

Un agente con sesión iniciada o una clave API siempre actúa como un miembro del workspace limitado a sus permisos. Los administradores y propietarios desconectan agentes en Configuración → Claves API → Agentes conectados y revocan o rotan claves en Configuración → Claves API. Los miembros desconectan sus propios agentes en Configuración → Seguridad → Agentes conectados.

Nada se publica automáticamente

Revisa y aprueba borradores en el panel. Publicar en la tienda requiere una conexión compatible y credenciales de la tienda; también puedes copiar la respuesta en la consola de la tienda para publicarla manualmente.

Uso visible

La pestaña Claves API muestra cuándo se usó cada clave por última vez y cuántas solicitudes ha realizado. Agentes conectados muestra quién conectó cada agente y cuándo se usó por última vez.

Lo que los agentes no pueden hacer

Estas acciones se quedan con los admins y propietarios con sesión iniciada en el dashboard de Tritonium. Ninguna clave API y ningún permiso que apruebes permite que un agente las realice:

  • Publicar, aprobar o rechazar respuestas en las tiendas de apps
  • Conectar, eliminar o re-sincronizar apps
  • Reconocer alertas o editar reglas de alerta
  • Crear o probar webhooks
  • Exportaciones, facturación y configuración de equipo y credenciales

Límites

Conviene saber

  • Tritonium CLI acepta claves API o tokens de acceso OAuth proporcionados; no inicia sesión ni renueva tokens.
  • Los tokens de sesión del dashboard no se aceptan. Inicia sesión en el agente o usa una clave API.
  • Cada clave API y cada agente con sesión iniciada tiene su propio límite, compartido con la API REST: 600 solicitudes por minuto y 60 nuevos borradores, análisis o pronósticos de IA cada 10 minutos. Las solicitudes también están limitadas por dirección IP. Cuando una herramienta devuelve RATE_LIMITED, consulta retry_after_seconds antes de volver a intentarlo.
  • El análisis de IA y los borradores de respuesta usan la capacidad de IA de tu plan. Las estimaciones usan reseñas escritas, no todas las valoraciones de la tienda. No se ha establecido la precisión frente a futuras valoraciones mostradas en la tienda. Los rangos del modelo no son intervalos de confianza calibrados.
  • Los clientes basados en navegador solo pueden conectarse desde los orígenes propios de Tritonium.
  • Grok Bot, el agente alojado de xAI, no ha sido probado con Tritonium.

Errores estructurados

Los fallos se devuelven como resultados de herramienta con un error.code estable, un indicador retryable y retry_after_seconds, para que el agente sepa si debe reintentar y cuándo.

Códigos de error

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

Probado con

Las configuraciones de cliente en esta página se probaron el 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 y MCP Python SDK 2.2.0. Cada una inició sesión en el servidor de producción.

Lleva tus reseñas de apps a tu agente

Conecta tus apps de App Store y Google Play en Tritonium, luego añade el servidor a tu agente e inicia sesión.