MCP

Como conectar

Claude, Claude Code, Codex, ChatGPT e agentes sem navegador.

  • Claude (web e desktop): Configurações > Conectores > Adicionar conector personalizado, com a URL https://tracker.aquarela.app/mcp.
  • Claude Code: claude mcp add --transport http tracker https://tracker.aquarela.app/mcp e depois /mcp para autorizar.
  • Codex: codex mcp add tracker --url https://tracker.aquarela.app/mcp e depois codex mcp login tracker.
  • ChatGPT: Configurações > Apps e conectores > Criar, com a URL https://tracker.aquarela.app/mcp e autenticação OAuth.

Na tela de autorização a pessoa escolhe as organizações (uma, várias, ou todas, inclusive as em que entrar depois) e se o aplicativo pode criar issues. Com mais de uma, toda tool aceita o argumento organization (slug ou nome da empresa, veja whoami); sem ele, a empresa sai da issue ou do projeto do pedido quando só uma delas tem esse código, whoami e list_projects mostram todas, e search_issues sem project busca em todas (cada issue com organization). As conexões ficam em https://tracker.aquarela.app/account/connections, onde podem ser desfeitas.

Sem navegador (CI, agente rodando num pipeline), o /mcp também aceita o token pessoal da API REST no cabeçalho Authorization: Bearer <token>, por exemplo claude mcp add --transport http tracker https://tracker.aquarela.app/mcp --header "Authorization: Bearer $TRACKER_TOKEN".