O que precisa?
Três elementos: uma conta num sistema de registo de horas que suporte servidor MCP, um assistente de IA compatível com MCP e o endereço do servidor. Para o Half5, o endereço é https://app.half5.com/mcp.
Não é necessário instalar nada nem copiar chaves API. Ao ligar, o assistente abre uma página de autenticação no seu navegador. Autentica-se com a sua conta habitual e dá consentimento. O que é o MCP está explicado em O que é o MCP?.
- Assistentes de programação: Claude Code, Codex e Cursor. Funcionam dentro do seu projeto e podem transmitir o nome do repositório.
- Assistentes de chat: Claude.ai (incluindo Desktop e app móvel) e ChatGPT. Não conhecem o seu repositório, por isso perguntam mais vezes qual o cliente.
- Outros: VS Code e outros programas que suportam servidor MCP remoto com OAuth.
Como ligar o seu assistente?
Cada assistente guarda esta configuração num local diferente. A tabela segue as instruções apresentadas no Half5. Os nomes de menu nestas apps podem mudar; se não encontrar, procure por ‘MCP’, ‘conector’ ou ‘conector personalizado’.
| Assistente | Onde | O que fazer |
|---|---|---|
| Claude Code | Terminal | claude mcp add --transport http --scope user half5 https://app.half5.com/mcp, depois /mcp no Claude Code, escolha half5 e autentique-se |
| Codex | Terminal | codex mcp add half5 --url https://app.half5.com/mcp, depois codex mcp login half5; o Codex abre o navegador |
| Cursor | ~/.cursor/mcp.json | {"mcpServers":{"half5":{"url":"https://app.half5.com/mcp"}}}, depois Ligar em Definições → MCP |
| Claude.ai, Desktop, app | Definições → Conectores | Adicionar conector personalizado, colar o URL e autenticar-se |
| ChatGPT | Definições → Apps & Conectores → Avançado | Ativar modo de programador, escolher Criar, colar o URL e selecionar OAuth |
| VS Code e outros | Definições MCP | Adicionar servidor MCP remoto (HTTP) com o URL |
O modo de programador do ChatGPT não está disponível em todos os planos. Se não vir a opção, confirme as permissões do seu plano.
O que dizer ao assistente?
Linguagem simples basta. Não precisa de IDs, números de cliente ou códigos de projeto. Indique o cliente ou projeto se souber, e a duração se souber.
- ‘Registar uma hora e meia neste trabalho.’
- ‘Trabalhei na integração do fornecedor de pagamentos das 9:00 às 11:30. Registe para a Padaria Jansen.’
- ‘Registar esta sessão no projeto Webshop.’ (sem duração: o sistema propõe uma para confirmar)
- ‘O que registei ontem?’
- ‘Mover o lançamento desta manhã para o projeto Manutenção.’
- ‘Eliminar o lançamento duplicado de hoje.’
O que acontece depois de registar?
Um lançamento feito por um agente não é uma nota à parte. É um registo normal, sujeito às mesmas validações que os restantes.
- O assistente envia uma descrição breve, a data, a duração (se conhecida) e, no caso dos assistentes de programação, o nome e ramo do repositório.
- O sistema de registo identifica cliente, projeto e atividade. Se não tiver certeza, o assistente faz-lhe uma pergunta com algumas opções.
- Sem duração, o sistema propõe, para hoje, o tempo desde o último lançamento. Para outro dia, o assistente pede a duração. Nada é guardado sem confirmação.
- O lançamento fica como não aprovado. Se a sua organização usar aprovação, um aprovador revê como os restantes registos.
- O lançamento entra logo nos relatórios. Se a aprovação estiver ativa, só pode ser faturado após aprovação.
Que hábitos evitam erros?
Um assistente é rápido, mas não sabe quanto tempo trabalhou realmente. Estes hábitos mantêm os registos fiáveis, mesmo quando precisar de justificar as horas.
- Um lançamento por tarefa contínua. Três lançamentos de uma hora para três tarefas são melhores do que um de três horas com tudo junto.
- Nunca invente a duração. Se não souber, deixe em branco e confirme ou corrija a proposta.
- Verifique o que já está registado. Antes de lançar um dia inteiro, peça ao assistente para listar os lançamentos desse dia para evitar duplicados.
- Escreva para o cliente. A descrição pode aparecer na fatura. Uma linha clara, sem nomes de ficheiros ou código.
- Indique o cliente em caso de dúvida. Um cliente ou projeto explícito tem sempre prioridade sobre o que o assistente deduz.
O que não pode fazer?
O assistente regista o que pode justificar; não mede o seu tempo. Se pretende registar automaticamente o seu dia de trabalho, precisa de uma linha temporal, como descrito em Registo automático de horas.
Um agente ligado só vê as suas próprias horas. Não pode ver horas de colegas, aprovar registos ou criar faturas. Só pode editar ou eliminar os seus próprios lançamentos enquanto não estão aprovados.
Como a Half5 faz
No Half5, as instruções de configuração estão em Definições → ‘Agentes ligados’, em ‘Ligar agente’. O ecrã de consentimento mostra a organização que está a ligar e o que o agente pode fazer: ver e registar horas. Um cliente desconhecido aparece como ‘App não verificada’.
Os lançamentos de um agente chegam como ‘Por aprovar’ e seguem o mesmo circuito dos restantes. O Half5 identifica cliente e projeto com base no que o agente envia, nos seus lançamentos anteriores e nos repositórios já associados a cada cliente. Os detalhes estão em Como funciona o log_work; o tratamento dos seus dados está em Privacidade com agentes de IA.
Perguntas frequentes
Preciso de instalar algo para registar horas com o Claude ou ChatGPT?
Não. Basta adicionar o endereço do servidor no assistente e autenticar-se no navegador. Só no Claude Code e Codex é necessário colar um comando no terminal.
O assistente pode decidir quanto tempo trabalhei?
Não deve. Se não indicar duração, o Half5 propõe, para hoje, o tempo desde o último lançamento, e confirma ou corrige. Para outro dia, pede a duração.
Porque é que o ChatGPT pergunta mais vezes pelo cliente do que o Claude Code?
Um assistente de chat não conhece o seu repositório, por isso tem menos dados para identificar o cliente. O Half5 analisa então a descrição e os seus lançamentos dos últimos 90 dias. Se indicar o cliente, não precisa de perguntar.
Um agente pode ver ou aprovar as horas dos meus colegas?
Não. Um agente ligado só vê as suas próprias horas e os clientes, projetos e atividades a que tem acesso. A aprovação faz-se no próprio Half5.
E se o agente registar algo errado?
Peça ao assistente para alterar ou eliminar o lançamento, ou faça-o diretamente no Half5. Enquanto não estiver aprovado, o agente pode alterar; depois disso, só na aplicação.
