Integración con Claude Desktop

Claude puede controlar tu control horario a través del Model Context Protocol. Una vez conectado, describes lo que has hecho y Claude lo registra: sin formularios y sin cambiar de aplicación.

Qué puedes pedirle

• «Inicia el temporizador del proyecto de la web»
• «Pausa el temporizador, me voy a comer»
• «Añade un gasto de 45 € por la comida con el cliente»
• «Enséñame los registros de tiempo de esta semana»
• «¿Cuántas horas facturé a Acme el mes pasado?»

Antes de empezar

• Un plan Timesheet Pro o superior. Consulta planes y precios.
• Claude Desktop instalado o una cuenta en claude.ai.

Opción 1: el conector alojado

La vía más rápida y sin nada que instalar. Añade un conector personalizado en Claude y apúntalo a:

https://mcp.timesheet.io

Claude te envía a Timesheet para que inicies sesión y apruebes el acceso, y después las herramientas aparecen en tu conversación. La autorización usa OAuth, así que no se guarda ninguna clave de API en la configuración de tu cliente.

Opción 2: ejecutar el servidor en local

¿Prefieres tenerlo todo en tu propio equipo? Crea una clave de API en la aplicación web en Integraciones > Claves de API y edita el archivo de configuración de Claude Desktop:

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

{
  "mcpServers": {
    "timesheet": {
      "command": "npx",
      "args": ["@timesheet/mcp"],
      "env": {
        "TIMESHEET_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Necesita Node.js 18 o superior para que el servidor pueda ejecutarse con npx. Reinicia Claude Desktop y pregunta «¿Cómo está mi temporizador?» para confirmar la conexión.

A qué puede acceder Claude

El servidor expone 50 herramientas, agrupadas así:

• Temporizador: iniciar, detener, pausar, reanudar, estado y actualizar
• Tareas: crear, actualizar, eliminar y listar, además de notas, gastos y descansos en la tarea en curso
• Proyectos: crear, actualizar, eliminar, listar y ver detalles
• Informes y exportaciones: documentos, informes de tareas y gastos, salida en PDF, exportaciones a Excel y CSV, y plantillas de exportación guardadas
• Ausencias: solicitar, aprobar, rechazar, cancelar y listar, junto con los tipos de ausencia
• Estadísticas: resúmenes de cualquier periodo

Conviene saber

• El servidor puede leer y crear registros de tiempo, gestionar proyectos y añadir notas, gastos y descansos. No puede acceder a los datos privados de otros usuarios ni modificar tu facturación.
• Con la opción local, tu clave de API da acceso completo a tu cuenta. No la compartas nunca ni la subas al control de versiones.
• Para revocar el acceso, elimina la clave de API en Integraciones > Claves de API y quita el servidor de la configuración de tu cliente.