Primeiros passos

Há dois caminhos para falar com o tracker, sempre em nome de uma pessoa e com as permissões dela:

• MCP, para agentes de IA (Claude, Claude Code, Codex, ChatGPT): a pessoa autoriza no navegador e o agente usa as tools.
• API REST, para scripts, CI e importação: um token pessoal no cabeçalho Authorization.

1. Crie um token pessoal

Em https://tracker.aquarela.app/account/tokens (Sua conta → Apps e API), escolha a validade (30, 90, 180, 365 dias) e se o token pode criar issues. Ele aparece uma vez só: guarde num segredo do CI ou num gerenciador de senhas. O token vale para a empresa em que foi criado.

2. Faça a primeira chamada

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

A resposta traz a pessoa, a empresa, os projetos com o perfil dela em cada um e a versão do tracker no ar. GET /projects traz os tipos de issue, os status e os campos de cada projeto, que valem para criar issues.

3. Crie uma 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": "Login falha no Android 15", "severity": "S2", "description": "Depois de atualizar o app, o login fica carregando."}'

O url da resposta é o link da issue. Antes de criar em lote, veja o guia "Já aconteceu antes?" para não duplicar.

4. Conecte um agente pelo MCP

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

Depois, /mcp no Claude Code abre o navegador para autorizar. Na tela de autorização a pessoa escolhe as empresas e se o agente pode escrever. Os outros clientes estão em "Como conectar".