Empezar

Primeros pasos

Un token, la primera llamada a la API y un agente conectado por MCP, en pocos minutos.

Hay dos caminos para hablar con tracker, siempre en nombre de una persona y con sus permisos:

MCP, para agentes de IA (Claude, Claude Code, Codex, ChatGPT): la persona autoriza en el navegador y el agente usa las tools.
API REST, para scripts, CI e importación: un token personal en el encabezado Authorization.

1. Crea un token personal

En https://tracker.aquarela.app/account/tokens (Tu cuenta → Apps y API), elige la validez (30, 90, 180, 365 días) y si el token puede crear issues. Aparece una sola vez: guárdalo en un secreto del CI o en un gestor de contraseñas. El token vale para la empresa en la que se creó.

2. Haz la primera llamada

curl -sS https://tracker.aquarela.app/api/v1/me -H "Authorization: Bearer $TRACKER_TOKEN"

La respuesta trae a la persona, la empresa, los proyectos con su perfil en cada uno y la versión de tracker en producción. GET /projects trae los tipos de issue, los estados y los campos de cada proyecto, que sirven para crear issues.

3. Crea una issue

curl -sS -X POST https://tracker.aquarela.app/api/v1/issues \
  -H "Authorization: Bearer $TRACKER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"project": "MOB", "title": "El login falla en Android 15", "severity": "S2", "description": "Después de actualizar la app, el login se queda cargando."}'

El url de la respuesta es el enlace de la issue. Antes de crear en lote, mira la guía "¿Ya pasó antes?" para no duplicar.

4. Conecta un agente por MCP

claude mcp add --transport http tracker https://tracker.aquarela.app/mcp

Después, /mcp en Claude Code abre el navegador para autorizar. En la pantalla de autorización la persona elige las empresas y si el agente puede escribir. Los demás clientes están en "Cómo conectar".