Lucen Track

O MCP Lucen Track permite registrar entradas de tempo e gerar relatórios a partir do seu agente favorito.

Documentação

Conecte sua ferramenta de IA ao Lucen Track usando o Model Context Protocol (MCP). Uma vez conectada, sua ferramenta pode ler e escrever registros de tempo, gerenciar temporizadores e gerar relatórios com base nas permissões da sua conta.

Aprenda como conectar suas ferramentas de IA favoritas ao Lucen Track para automatizar seu controle de tempo, como resolver os problemas de conexão mais comuns e as perguntas frequentes sobre esta integração e como ela funciona.

Se você tiver outras dúvidas, comentários ou sugestões, sinta-se à vontade para entrar em contato conosco!

O que você encontrará neste artigo:

Referência rápida

URL do servidor	https://track-api.lucensoftware.com/mcp
Transporte	Streamable HTTP (recomendado)
Autenticação	OAuth 2.0 — fluxo de navegador único, sem chaves de API
Ferramentas disponíveis	11 ferramentas cobrindo projetos, tarefas, tags, registros de tempo, temporizadores e relatórios

Claude Code

Execute este comando no seu terminal:

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

Em seguida, autentique-se executando /mcp no Claude Code e seguindo o fluxo OAuth.

Para uma experiência mais completa, instale o plugin Lucen Track para Claude Code. Ele inclui o servidor MCP com comandos de barra (/log-time, /track-timer, /fix-entry, /time-report) para fluxos de trabalho comuns.

Usando flags --scope para diferentes escopos de instalação

--scope local (padrão): Disponível apenas para você no projeto atual
--scope project: Compartilhado com sua equipe via .mcp.json
--scope user: Disponível para você em todos os projetos

Use /mcp para listar e gerenciar servidores MCP, e /context para ver o uso de tokens por servidor.

Claude Desktop

Abra Configurações → Conectores
Clique em Adicionar conector e insira a URL:
https://track-api.lucensoftware.com/mcp
Complete o fluxo OAuth para conectar seu workspace do Lucen Track

Observação: Servidores MCP remotos no Claude Desktop são configurados por meio de Configurações → Conectores, não pelo arquivo claude_desktop_config.json. Disponível nos planos Pro, Max, Team e Enterprise.

Cursor

Abra Configurações do Cursor → MCP → Adicionar novo servidor MCP global
Cole a seguinte configuração:

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

Salve e reinicie o Cursor. Na primeira vez que você usar uma ferramenta do Lucen Track, complete o fluxo OAuth.

Configuração em nível de projeto

Para compartilhar a configuração MCP do Lucen Track com sua equipe, crie um arquivo .cursor/mcp.json na raiz do seu projeto com a mesma configuração de servidor mostrada acima.

VS Code (GitHub Copilot)

Crie um arquivo .vscode/mcp.json no seu workspace:

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

Abra a Paleta de Comandos (Cmd+Shift+P / Ctrl+Shift+P) e execute MCP: Listar Servidores
Inicie o servidor do Lucen Track e complete o fluxo OAuth quando solicitado

Configuração em nível de usuário

Para configurar o MCP do Lucen Track em todos os workspaces, execute MCP: Abrir Configuração do Usuário na Paleta de Comandos e adicione o servidor lá.

Windsurf

Abra Configurações do Windsurf (Cmd+, no Mac) → pesquise por MCP
Clique em Ver configuração bruta para abrir mcp_config.json
Adicione a configuração do servidor do Lucen Track:

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

Salve e reinicie o Windsurf. Complete o fluxo OAuth quando solicitado.

ChatGPT

Acesse chatgpt.com/#settings/Connectors (requer login)
Clique em Adicionar conector e insira a URL:

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

Complete o fluxo OAuth para conectar seu workspace do Lucen Track

Conectores MCP no ChatGPT requerem um plano Plus, Team ou Enterprise.

Codex

Para mais detalhes, consulte a documentação MCP do Codex.

Adicione o servidor do Lucen Track à sua configuração do Codex em ~/.codex/config.toml:

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

Autentique-se executando:

codex mcp login lucen-track

Complete o fluxo OAuth para conectar seu workspace do Lucen Track.

Configuração em nível de projeto

Para compartilhar a configuração MCP do Lucen Track com sua equipe, crie um arquivo .codex/config.toml na raiz do seu projeto com a mesma configuração de servidor.

Outras ferramentas

Se sua ferramenta de IA não estiver listada acima, mas suportar MCP, você pode conectar usando uma das seguintes opções:

Transporte	URL	Observações
Streamable HTTP (recomendado)	https://track-api.lucensoftware.com/mcp	Transporte moderno, amplamente suportado

Formato de configuração JSON

A maioria dos clientes MCP aceita uma configuração JSON. Use o formato apropriado para sua ferramenta:

Streamable HTTP

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

STDIO via mcp-remote

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

Use a configuração STDIO se sua ferramenta não suportar conexões HTTP remotas diretamente. Requer Node.js instalado na máquina local.

Solução de problemas

1) Minha ferramenta não suporta servidores MCP remotos

Alguns clientes MCP só suportam servidores stdio locais. Você ainda pode conectar ao MCP do Lucen Track usando a ponte mcp-remote:

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

Requer Node.js instalado na máquina local.

2) Problemas de autenticação

Certifique-se de completar o fluxo OAuth quando solicitado
Tente desconectar e reconectar — procure por uma opção "Limpar autenticação" ou "Desconectar" nas configurações MCP da sua ferramenta
Se você usou mcp-remote, exclua o token em cache em ~/.mcp-auth/ e reinicie o cliente
Verifique se você tem as permissões corretas no workspace do Lucen Track ao qual está tentando acessar

3) A IA não consegue encontrar meu projeto ou tarefa

O servidor MCP só vê dados aos quais seu usuário autenticado tem visibilidade no Lucen Track. Se um projeto, tarefa ou tag não aparecer:

Confirme que você está conectado à conta correta do Lucen Track
Verifique se o projeto está ativo e se você é membro
Para tarefas: garanta que o ID de integração (referência Jira/Asana) esteja exatamente como aparece no sistema vinculado

4) Minha ferramenta não está listada aqui

Consulte a documentação da sua ferramenta sobre como adicionar um servidor MCP remoto. A maioria das ferramentas aceita uma URL diretamente ou uma configuração JSON. Se sua ferramenta ainda não suporta MCP, considere entrar em contato com os desenvolvedores para solicitar suporte MCP.

FAQ

Posso usar o MCP do Lucen Track sem um humano no processo?

O MCP do Lucen Track requer autenticação OAuth baseada em usuário e atualmente não suporta acesso por token de portador. Isso significa que um usuário deve completar o fluxo OAuth para autorizar o acesso, o que pode não ser adequado para fluxos de trabalho totalmente automatizados ou agentes baseados em nuvem que operam sem interação humana.

Se você precisar de acesso headless ou automatizado, pode chamar a API REST do Lucen Track diretamente com um token OAuth, embora o MCP seja o caminho recomendado para casos de uso com assistentes de IA.

Meus dados de controle de tempo são usados para treinar IA?

O Lucen Track nunca usa seus dados rastreados para treinar modelos de IA. Os dados enviados à ferramenta de IA que você conecta (Claude, ChatGPT, etc.) são regidos pelos termos dessa ferramenta — para Claude, os termos comerciais da Anthropic excluem dados passados pelo Diretório de Conectores do treinamento de modelos.

O que o servidor MCP pode realmente fazer?

O servidor expõe 11 ferramentas cobrindo leituras (projetos, tarefas, tags, registros, resumos, relatórios, estado do temporizador ativo) e gravações (criar / atualizar registros de tempo, iniciar / parar temporizadores). Ele não expõe operações administrativas como criar projetos, convidar usuários ou alterar configurações de cobrança.

Como desconectar?

Pelo painel MCP / Conectores da sua ferramenta de IA. Revogar o token OAuth interrompe imediatamente o fluxo de dados.

Se você está integrando o MCP do Lucen Track ao seu próprio aplicativo ou construindo uma ferramenta de IA personalizada, consulte a documentação do cliente MCP para instruções passo a passo sobre como implementar OAuth e conectar a um servidor MCP remoto. O endpoint do Lucen Track segue o fluxo padrão de descoberta OAuth do MCP.