Cómo conectar Claude con TimeTrack (MCP)

TimeTrack expone un servidor MCP (Model Context Protocol) que permite a Claude Desktop, Claude Code y otros asistentes IA gestionar tu tiempo.

¿Qué puedes hacer con MCP?

Con Claude conectado a TimeTrack puedes:
- Crear entradas de tiempo desde lenguaje natural
- Iniciar/detener timers sin tocar la app
- Consultar proyectos activos y sus tareas
- Generar reportes de tiempo invertido
- Buscar en la documentación desde el chat

Setup paso a paso

1. Obtén tu API key

Ve a **Configuración** → **API Keys**
Click en **Crear nueva key**
Asigna un nombre (ej: "Claude Desktop")
Copia la key (empieza con `tt_live_...`)

2. Configura Claude Desktop

Edita el archivo de configuración:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "timetrack": {
      "command": "npx",
      "args": ["-y", "@timetrack/mcp-server"],
      "env": {
        "TIMETRACK_API_KEY": "tt_live_xxx",
        "TIMETRACK_API_URL": "https://api.timetracker.cargoffer.com"
      }
    }
  }
}

3. Reinicia Claude Desktop

Cierra y abre Claude Desktop. Verás las herramientas de TimeTrack disponibles en el menú de tools.

Ejemplos de uso

Iniciar timer desde Claude:
> "Inicia un timer para el proyecto Web Redesign en la tarea de diseño"

Registrar tiempo retroactivo:
> "Ayer trabajé 3 horas en el bugfix de pagos, regístralo en el proyecto Backend"

Generar reporte:
> "Dame el reporte de tiempo de esta semana, agrupado por proyecto"

Buscar en la documentación:
> "Busca cómo exportar reportes a PDF"