¿Qué necesitas?
Tres cosas: una cuenta en un registro de horas que tenga un servidor MCP, un asistente de IA que soporte MCP y la dirección del servidor. Para Half5 esa dirección es https://app.half5.com/mcp.
No hay nada que instalar ni claves API que copiar. Al conectar, el asistente abre una página de inicio de sesión en tu navegador. Inicias sesión con tu cuenta habitual y das tu consentimiento. Qué es MCP exactamente se explica en ¿Qué es MCP?.
- Asistentes de código: Claude Code, Codex y Cursor. Funcionan dentro de tu proyecto y pueden enviar el nombre del repositorio.
- Asistentes de chat: Claude.ai (también Claude Desktop y la app móvil) y ChatGPT. No conocen tu repositorio, así que preguntan más a menudo por el cliente.
- Otros: VS Code y otros programas que soportan un servidor MCP remoto con OAuth.
¿Cómo conectas tu asistente?
Cada asistente guarda la configuración en un sitio distinto. La tabla sigue las instrucciones que verás dentro de Half5. Los nombres de menú en estas apps pueden cambiar; si no encuentras uno, busca ‘MCP’, ‘conector’ o ‘conector personalizado’.
| Asistente | Dónde | Qué hacer |
|---|---|---|
| Claude Code | Terminal | claude mcp add --transport http --scope user half5 https://app.half5.com/mcp, luego /mcp en Claude Code, elige half5 e inicia sesión |
| Codex | Terminal | codex mcp add half5 --url https://app.half5.com/mcp, luego codex mcp login half5; Codex abre tu navegador |
| Cursor | ~/.cursor/mcp.json | {"mcpServers":{"half5":{"url":"https://app.half5.com/mcp"}}}, después conecta en Ajustes → MCP |
| Claude.ai, Desktop, app | Ajustes → Conectores | Añade conector personalizado, pega la URL e inicia sesión |
| ChatGPT | Ajustes → Apps y Conectores → Avanzado | Activa el modo desarrollador, pulsa Crear, pega la URL y elige OAuth |
| VS Code y otros | Ajustes de MCP | Añade un servidor MCP remoto (HTTP) con la URL |
El modo desarrollador de ChatGPT no está disponible en todos los planes. Si no ves la opción, revisa qué permite tu plan.
¿Qué le dices al asistente?
El lenguaje natural basta. No necesitas IDs, números de cliente ni códigos de proyecto. Si sabes el cliente o el proyecto, dilo, y también la duración si la tienes clara.
- ‘Registra una hora y media para este trabajo.’
- ‘He trabajado en la integración del proveedor de pagos de 9:00 a 11:30. Regístralo para Jansen Bakery.’
- ‘Registra esta sesión en el proyecto Webshop.’ (sin duración: el registro de horas te propone una para que la confirmes)
- ‘¿Qué registré ayer?’
- ‘Mueve la entrada de esta mañana al proyecto Mantenimiento.’
- ‘Elimina la entrada duplicada de hoy.’
¿Qué ocurre tras registrar?
Una entrada de un asistente no es una nota aparte. Es un registro normal que pasa los mismos controles que tus otras horas.
- El asistente envía una breve descripción, la fecha, la duración (si la sabe) y, en asistentes de código, el nombre y rama del repositorio.
- El registro de horas asigna cliente, proyecto y actividad. Si no está seguro, el asistente te pregunta y te da varias opciones.
- Si no hay duración, el registro de horas propone, para hoy, el tiempo desde que terminó tu última entrada. Para otro día, el asistente te pide la duración. Nada se guarda hasta que lo confirmas.
- La entrada llega como no aprobada. Si tu organización usa aprobación, un responsable la revisa igual que el resto de tus horas.
- La entrada cuenta en los informes al momento. Si la aprobación está activada, solo puede ir a una factura cuando esté aprobada.
¿Qué hábitos evitan errores?
Un asistente es rápido, pero no sabe cuánto tiempo has trabajado realmente. Estos hábitos mantienen tus registros fiables, también si luego tienes que explicar en qué empleaste las horas.
- Una entrada por tarea continua. Tres entradas de una hora para tres tareas son mejores que una de tres horas con todo junto.
- Nunca inventes la duración. Si no la sabes, déjala en blanco y confirma o corrige la propuesta.
- Revisa lo que ya hay. Antes de registrar un día entero, pide al asistente que te liste las entradas de ese día para no duplicar nada.
- Escribe para el cliente. La descripción puede acabar en una factura. Una línea clara, sin nombres de archivos ni código.
- Nombra el cliente si tienes dudas. Un cliente o proyecto explícito siempre tiene prioridad sobre lo que deduzca el asistente.
¿Qué no puede hacer?
Un asistente registra lo que tú (o él) puedes justificar; no mide tu tiempo. Si quieres que tu jornada se registre automáticamente, necesitas una línea de tiempo, como se explica en Registro automático de horas.
Un agente conectado solo ve tus propias horas. No puede ver las horas de tus compañeros, aprobar horas ni crear facturas. Solo puede editar o borrar tus propias entradas mientras no estén aprobadas.
Así lo hace Half5
En Half5 las instrucciones de configuración están en Ajustes → ‘Agentes vinculados’, en ‘Vincular agente’. La pantalla de consentimiento muestra con qué organización conectas y qué puede hacer el agente: ver horas y registrar horas. Un cliente desconocido aparece como ‘App no verificada’.
Las entradas de un agente llegan como ‘Pendiente de aprobación’ y siguen el mismo flujo que el resto de tus horas. Half5 asigna cliente y proyecto según lo que envía el agente, tus entradas anteriores y en qué repositorio has registrado antes para cada cliente. Los detalles están en Cómo funciona log_work; qué ocurre con tus datos está en Privacidad con agentes de IA.
Preguntas frecuentes
¿Tengo que instalar algo para registrar horas con Claude o ChatGPT?
No. Solo tienes que añadir la dirección del servidor en tu asistente e iniciar sesión desde el navegador. Solo en Claude Code y Codex hay que pegar un comando en la terminal.
¿Puede el asistente decidir cuánto tiempo he trabajado?
No debería. Si no indicas duración, Half5 propone, para hoy, el tiempo desde que terminó tu última entrada, y tú lo confirmas o corriges. Para otro día te pide la duración.
¿Por qué ChatGPT pregunta más veces por el cliente que Claude Code?
Un asistente de chat no conoce tu repositorio, así que tiene menos pistas para reconocer el cliente. Half5 mira entonces tu descripción y tus propias entradas de los últimos 90 días. Si nombras el cliente, no necesita preguntar.
¿Puede un agente ver o aprobar las horas de mis compañeros?
No. Un agente conectado solo ve tus propias horas y los clientes, proyectos y actividades a los que tienes acceso. La aprobación se hace en Half5.
¿Qué hago si el agente registra algo mal?
Pide al asistente que cambie o elimine la entrada, o hazlo tú mismo en Half5. Mientras la entrada no esté aprobada, el agente puede modificarla; después lo haces tú en la app.