Integración con Cursor y VS Code

El control horario falla cuando obliga a cambiar de ventana. Si añades el servidor MCP de Timesheet a tu editor, el asistente que ya usas puede iniciar el temporizador, registrar lo que has terminado y traerte un informe, todo dentro del editor.

Qué puedes pedirle

• «Inicia el temporizador del proyecto de este repositorio»
• «Detén el temporizador y anota que he terminado la migración»
• «¿Cuánto tiempo llevo en este proyecto esta semana?»
• «Registra 90 minutos de la refactorización de ayer por la tarde»

Antes de empezar

• Un plan Timesheet Pro o superior. Consulta planes y precios.
• Una clave de API de Timesheet creada en la aplicación web en Integraciones > Claves de API.
• Node.js 18 o superior, para que el servidor pueda ejecutarse con npx.

Cursor

Abre Cursor Settings > Features > MCP Servers y añade:

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

VS Code con Continue

Instala la extensión Continue y añade el servidor a su configuración:

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

Otros editores

Cualquier editor o cliente compatible con Model Context Protocol puede ejecutar el mismo servidor. El comando es npx @timesheet/mcp con TIMESHEET_API_TOKEN en el entorno. Para una instalación global, ejecuta npm install -g @timesheet/mcp y usa timesheet-mcp como comando.

Resolución de problemas

• No responde nada o falla la autenticación. Comprueba que TIMESHEET_API_TOKEN no lleva espacios ni comillas de más y que la clave sigue existiendo en Integraciones > Claves de API.
• Comando no encontrado. Confirma que tienes Node.js 18 o superior con node --version. Si npx no encuentra el paquete, instálalo de forma global.
• El temporizador no arranca. Asegúrate de que el nombre del proyecto coincide con uno existente al que tengas acceso. Pregunta «¿Cómo está mi temporizador?» para probar la conexión por separado.

Conviene saber

Tu clave de API da acceso completo a tu cuenta, así que mantenla fuera de todo lo que subas al repositorio. Para revocar el acceso, elimina la clave en Integraciones > Claves de API y quita el servidor de la configuración de tu editor.