Lucen Track

El MCP de Lucen Track te permite registrar entradas de tiempo y generar informes desde tu agente favorito.

Ver en timeneye.com

Documentación

Conecta tu herramienta de IA a Lucen Track usando el Protocolo de Contexto de Modelos (MCP). Una vez conectada, tu herramienta puede leer y escribir entradas de tiempo, gestionar temporizadores y generar informes según los permisos de tu cuenta.

Aprende cómo conectar tus herramientas de IA favoritas a Lucen Track para automatizar tu seguimiento de tiempo, cómo resolver los problemas de conexión más comunes y las preguntas frecuentes sobre esta integración y cómo funciona.

Si tienes otras preguntas, comentarios o sugerencias, no dudes en contactarnos!

Lo que encontrarás en este artículo:

Referencia rápida

URL del servidorhttps://track-api.lucensoftware.com/mcp
TransporteHTTP transmisible (recomendado)
AutenticaciónOAuth 2.0 — flujo de navegador de una sola vez, sin claves API
Herramientas disponibles11 herramientas que cubren proyectos, tareas pendientes, etiquetas, entradas de tiempo, temporizadores e informes

Conectar desde

Claude Code

Ejecuta este comando en tu terminal:

claude mcp add --transport http lucen-track https://track-api.lucensoftware.com/mcp

Luego autentícate ejecutando /mcp en Claude Code y siguiendo el flujo de OAuth.

Para una experiencia más completa, instala el plugin de Lucen Track para Claude Code. Incluye el servidor MCP con comandos de barra (/log-time, /track-timer, /fix-entry, /time-report) para flujos de trabajo comunes.

Uso de banderas --scope para diferentes ámbitos de instalación

  • --scope local (predeterminado): Disponible solo para ti en el proyecto actual
  • --scope project: Compartido con tu equipo a través de .mcp.json
  • --scope user: Disponible para ti en todos los proyectos

Usa /mcp para listar y gestionar servidores MCP, y /context para ver el uso de tokens por servidor.

Claude Desktop

  1. Abre Configuración → Conectores
  2. Haz clic en Agregar conector e ingresa la URL:
    https://track-api.lucensoftware.com/mcp
  3. Completa el flujo de OAuth para conectar tu espacio de trabajo de Lucen Track

Nota: Los servidores MCP remotos en Claude Desktop se configuran a través de Configuración → Conectores, no mediante el archivo claude_desktop_config.json. Disponible en los planes Pro, Max, Team y Enterprise.

Cursor

  1. Abre Configuración de Cursor → MCP → Agregar nuevo servidor MCP global
  2. Pega la siguiente configuración:

{   "mcpServers": {     "lucen-track": {       "url": "https://track-api.lucensoftware.com/mcp"     }   } }

  1. Guarda y reinicia Cursor. La primera vez que uses una herramienta de Lucen Track, completa el flujo de OAuth.

Configuración a nivel de proyecto

Para compartir la configuración MCP de Lucen Track con tu equipo, crea un archivo .cursor/mcp.json en la raíz de tu proyecto con la misma configuración de servidor mostrada arriba.

VS Code (GitHub Copilot)

  1. Crea un archivo .vscode/mcp.json en tu espacio de trabajo:

{
  "servers": {
    "lucen-track": {
      "type": "http",
      "url": "https://track-api.lucensoftware.com/mcp"
    }
  }
}

  1. Abre la Paleta de comandos (Cmd+Shift+P / Ctrl+Shift+P) y ejecuta MCP: Listar servidores
  2. Inicia el servidor de Lucen Track y completa el flujo de OAuth cuando se te solicite

Configuración a nivel de usuario

Para configurar Lucen Track MCP en todos los espacios de trabajo, ejecuta MCP: Abrir configuración de usuario desde la Paleta de comandos y agrega el servidor allí.

Windsurf

  1. Abre Configuración de Windsurf (Cmd+, en Mac) → busca MCP
  2. Haz clic en Ver configuración sin procesar para abrir mcp_config.json
  3. Agrega la configuración del servidor de Lucen Track:

{   "mcpServers": {     "lucen-track": {       "serverUrl": "https://track-api.lucensoftware.com/mcp"     }   } }

  1. Guarda y reinicia Windsurf. Completa el flujo de OAuth cuando se te solicite.

ChatGPT

  1. Ve a chatgpt.com/#settings/Connectors (requiere inicio de sesión)
  2. Haz clic en Agregar conector e ingresa la URL:

https://track-api.lucensoftware.com/mcp

  1. Completa el flujo de OAuth para conectar tu espacio de trabajo de Lucen Track

Los conectores MCP en ChatGPT requieren un plan Plus, Team o Enterprise.

Codex

Para más detalles, consulta la documentación de MCP de Codex.

  1. Agrega el servidor de Lucen Track a tu configuración de Codex en ~/.codex/config.toml:

[mcp_servers.lucen-track] url = "https://track-api.lucensoftware.com/mcp"

  1. Autentícate ejecutando:

codex mcp login lucen-track

  1. Completa el flujo de OAuth para conectar tu espacio de trabajo de Lucen Track.

Configuración a nivel de proyecto

Para compartir la configuración MCP de Lucen Track con tu equipo, crea un archivo .codex/config.toml en la raíz de tu proyecto con la misma configuración de servidor.

Otras herramientas

Si tu herramienta de IA no aparece en la lista anterior pero admite MCP, puedes conectarte usando una de las siguientes opciones:

TransporteURLNotas
HTTP transmisible (recomendado)https://track-api.lucensoftware.com/mcpTransporte moderno, ampliamente compatible

Formato de configuración JSON

La mayoría de los clientes MCP aceptan una configuración JSON. Usa el formato apropiado para tu herramienta:

HTTP transmisible

{   "mcpServers": {     "lucen-track": {       "url": "https://track-api.lucensoftware.com/mcp"     }   } }

STDIO a través de mcp-remote

{   "mcpServers": {     "lucen-track": {       "command": "npx",       "args": ["-y", "mcp-remote", "https://track-api.lucensoftware.com/mcp"]     }   } }

Usa la configuración STDIO si tu herramienta no admite conexiones HTTP remotas directamente. Requiere Node.js instalado en la máquina local.

Solución de problemas

1) Mi herramienta no admite servidores MCP remotos

Algunos clientes MCP solo admiten servidores stdio locales. Aún puedes conectarte a Lucen Track MCP usando el puente mcp-remote:

{   "mcpServers": {     "lucen-track": {       "command": "npx",       "args": ["-y", "mcp-remote", "https://track-api.lucensoftware.com/mcp"]     }   } }

Requiere Node.js instalado en la máquina local.

2) Problemas de autenticación

  • Asegúrate de completar el flujo de OAuth cuando se te solicite
  • Intenta desconectar y reconectar — busca una opción de "Borrar autenticación" o "Desconectar" en la configuración MCP de tu herramienta
  • Si usaste mcp-remote, elimina el token en caché en ~/.mcp-auth/ y reinicia el cliente
  • Verifica que tengas los permisos correctos en el espacio de trabajo de Lucen Track al que intentas acceder

3) La IA no puede encontrar mi proyecto o tarea pendiente

El servidor MCP solo ve los datos a los que tu usuario autenticado tiene visibilidad en Lucen Track. Si un proyecto, tarea pendiente o etiqueta no aparece:

  • Confirma que has iniciado sesión con la cuenta correcta de Lucen Track
  • Verifica que el proyecto esté activo y que seas miembro
  • Para tareas pendientes: asegúrate de que el ID de integración (referencia de Jira/Asana) sea exactamente como aparece en el sistema vinculado

4) Mi herramienta no aparece en la lista

Consulta la documentación de tu herramienta sobre cómo agregar un servidor MCP remoto. La mayoría de las herramientas aceptan una URL directamente o una configuración JSON. Si tu herramienta aún no admite MCP, considera contactar a los desarrolladores para solicitar soporte MCP.

Preguntas frecuentes

¿Puedo usar Lucen Track MCP sin intervención humana?

Lucen Track MCP requiere autenticación OAuth basada en usuario y actualmente no admite acceso con token de portador. Esto significa que un usuario debe completar el flujo de OAuth para autorizar el acceso, lo que puede no ser adecuado para flujos de trabajo totalmente automatizados o agentes basados en la nube que funcionan sin interacción humana.

Si necesitas acceso sin interfaz o automatizado, puedes llamar directamente a la API REST de Lucen Track subyacente con un token OAuth, aunque MCP es la ruta recomendada para casos de uso de asistentes de IA.

¿Se usan mis datos de seguimiento de tiempo para entrenar IA?

Lucen Track nunca usa tus datos registrados para entrenar modelos de IA. Los datos enviados a la herramienta de IA que conectas (Claude, ChatGPT, etc.) se rigen por los términos de esa herramienta — para Claude, los términos comerciales de Anthropic excluyen los datos que pasan a través del Directorio de Conectores del entrenamiento de modelos.

¿Qué puede hacer realmente el servidor MCP?

El servidor expone 11 herramientas que cubren lecturas (proyectos, tareas pendientes, etiquetas, entradas, resúmenes, informes, estado del temporizador activo) y escrituras (crear / actualizar entradas de tiempo, iniciar / detener temporizadores). No expone operaciones administrativas como crear proyectos, invitar usuarios o cambiar configuraciones de facturación.

¿Cómo me desconecto?

Desde el panel MCP / Conectores de tu herramienta de IA. Revocar el token OAuth detiene inmediatamente el flujo de datos posterior.

Si estás integrando Lucen Track MCP en tu propia aplicación o construyendo una herramienta de IA personalizada, consulta la documentación del cliente MCP para obtener instrucciones paso a paso sobre cómo implementar OAuth y conectarte a un servidor MCP remoto. El endpoint de Lucen Track sigue el flujo estándar de descubrimiento OAuth de MCP.