@re9ti/timesheet-mcp

MCP Server para integrar o Claude (Code, Desktop, Web) com o Timesheet Inteligente RE9TI.

Lance timesheets, consulte horas, gerencie timers — tudo via linguagem natural no Claude.

Setup rápido

npx @re9ti/timesheet-mcp setup

O wizard vai:

1. Pedir seu email e senha do Timesheet
2. Validar suas credenciais
3. Configurar o Claude Code e/ou Desktop automaticamente

Reinicie o Claude e pronto!

Uso

Depois de configurado, fale naturalmente com o Claude:

| Exemplo | O que faz | |---------|-----------| | "Lança 2h para cliente Silva, reunião de alinhamento" | Cria timesheet | | "Quantas horas trabalhei hoje?" | Resumo do dia | | "Lista meus lançamentos da semana" | Lista timesheets | | "Inicia timer para projeto X" | Inicia cronômetro | | "Para o timer" | Para e registra | | "Quais clientes tenho?" | Lista clientes |

Ferramentas disponíveis

| Ferramenta | Descrição | |------------|-----------| | login | Autenticar no sistema | | criar_timesheet | Criar lançamento | | listar_timesheets | Listar lançamentos | | consultar_horas | Resumo de horas + top apps | | listar_clientes | Clientes disponíveis | | listar_contratos | Contratos por cliente | | chat_timesheet | Linguagem natural | | timer_iniciar | Iniciar cronômetro | | timer_parar | Parar cronômetro | | timer_pausar | Pausar cronômetro | | timer_retomar | Retomar cronômetro | | timer_status | Status dos timers |

Segurança

• Sua senha é usada apenas uma vez durante o setup e nunca é armazenada
• O setup gera um device token (90 dias, revogável) que é salvo no config
• O admin pode revogar o token a qualquer momento no painel Dispositivos
• Quando o token expirar, re-execute npx @re9ti/timesheet-mcp setup

Configuração manual

Se preferir configurar manualmente, adicione ao settings.json do Claude Code (~/.claude/settings.json):

{
  "mcpServers": {
    "timesheet-re9ti": {
      "command": "npx",
      "args": ["-y", "@re9ti/timesheet-mcp"],
      "env": {
        "TIMESHEET_API_URL": "https://timesheet.re9ti.com.br",
        "TIMESHEET_DEVICE_TOKEN": "seu-token-aqui"
      }
    }
  }
}

Para obter um token manualmente, use POST /auth/login-device na API.

Variáveis de ambiente

| Variável | Default | Descrição | |----------|---------|-----------| | TIMESHEET_API_URL | https://timesheet.re9ti.com.br | URL da API | | TIMESHEET_DEVICE_TOKEN | — | Token de dispositivo (preferido) | | TIMESHEET_EMAIL | — | Email (fallback legacy) | | TIMESHEET_PASSWORD | — | Senha (fallback legacy) |

Requisitos

• Node.js >= 18
• Conta no Timesheet Inteligente RE9TI