Integração com o Claude Code

O Claude Code é o agente de programação da Anthropic para o terminal. Com o plugin do Timesheet instalado, ele inicia e para cronômetros, registra o trabalho que você acabou de concluir e responde perguntas sobre para onde foram suas horas, sem que você troque de janela.

O que você pode pedir

• "Inicie o cronômetro do projeto da API"
• "Pare o cronômetro e adicione a nota: corrigi o bug de login"
• "Em que eu trabalhei ontem?"
• "Registre 2 horas no projeto do app para segunda-feira"
• "Exporte o mês passado em Excel e envie para o meu contador"

Antes de começar

• Um plano Pro do Timesheet ou superior. Veja planos e preços.
• Uma chave de API do Timesheet, criada no app web em Integrações > Chaves de API.
• Node.js 18 ou superior.

Instale o plugin

Rode estes dois comandos dentro de uma sessão do Claude Code:

/plugin marketplace add timesheetIO/timesheet-plugin
/plugin install timesheet@timesheet

O plugin traz junto uma skill que documenta cada grupo de comandos do @timesheet/cli, então o Claude Code conhece as flags e os fluxos exatos em vez de adivinhar.

Depois instale a CLI que o plugin usa e faça login uma vez:

npm install -g @timesheet/cli
timesheet auth login

O timesheet auth login usa OAuth 2.1 com PKCE e abre o navegador. Para automações e CI, defina uma chave de API:

export TIMESHEET_API_KEY=ts_your.apikey
timesheet auth status --json

Ou conecte pelo MCP

Se você preferir que o Claude Code chame ferramentas tipadas em vez de rodar comandos no shell, adicione o servidor MCP do Timesheet ao ~/.claude/settings.json:

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

Os dois caminhos chegam à mesma conta. O plugin combina com fluxos de shell e saída para scripts; o servidor MCP combina com assistentes que preferem chamadas de ferramenta estruturadas.

Use a skill sem o plugin

A CLI traz o mesmo arquivo de skill, então qualquer agente compatível pode carregá-lo:

timesheet skill path      # veja onde ela seria gravada
timesheet skill install   # grave na pasta de skills do agente

Vale saber

• Todo comando de leitura aceita --json, então a saída continua legível por máquina. Ao redirecionar para outro comando, ela muda para TSV automaticamente.
• O código de saída 3 significa que a sessão precisa se autenticar de novo.
• Sua chave de API dá acesso total à sua conta. Nunca a inclua no controle de versão. Para revogar o acesso, exclua a chave em Integrações > Chaves de API.