Integração com o Claude Desktop

O Claude controla o seu registro de horas pelo Model Context Protocol. Depois de conectado, você descreve o que fez e o Claude registra: sem formulários, sem trocar de aplicativo.

O que você pode pedir

• "Inicie o cronômetro do projeto do site"
• "Pause meu cronômetro, vou almoçar"
• "Adicione uma despesa de R$ 45 do almoço com o cliente"
• "Mostre os registros de tempo desta semana"
• "Quantas horas eu faturei para a Acme no mês passado?"

Antes de começar

• Um plano Pro do Timesheet ou superior. Veja planos e preços.
• O Claude Desktop instalado ou uma conta no claude.ai.

Opção 1: o conector hospedado

O caminho mais rápido, e não há nada para instalar. Adicione um conector personalizado no Claude e aponte para:

https://mcp.timesheet.io

O Claude encaminha você ao Timesheet para fazer login e aprovar o acesso, e então as ferramentas aparecem na conversa. A autorização usa OAuth, então nenhuma chave de API fica guardada na configuração do seu cliente.

Opção 2: rodar o servidor localmente

Prefere manter tudo na sua própria máquina? Crie uma chave de API no app web em Integrações > Chaves de API e edite o arquivo de configuração do Claude Desktop:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

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

Isso exige Node.js 18 ou superior, para que o servidor rode pelo npx. Reinicie o Claude Desktop e pergunte "qual é o status do meu cronômetro?" para confirmar a conexão.

O que o Claude alcança

O servidor expõe 50 ferramentas, agrupadas assim:

• Cronômetro: iniciar, parar, pausar, retomar, status, atualizar
• Tarefas: criar, atualizar, excluir, listar, além de notas, despesas e pausas na tarefa em andamento
• Projetos: criar, atualizar, excluir, listar e detalhar
• Relatórios e exportações: documentos, relatórios de tarefas e despesas, saída em PDF, exportações em Excel e CSV e modelos de exportação salvos
• Ausências: solicitar, aprovar, recusar, cancelar e listar, além dos tipos de ausência
• Estatísticas: resumos de qualquer período

Vale saber

• O servidor lê e cria registros de tempo, gerencia projetos e adiciona notas, despesas e pausas. Ele não alcança dados privados de outras pessoas nem altera a sua cobrança.
• Na opção local, sua chave de API dá acesso total à sua conta. Nunca a compartilhe nem a inclua no controle de versão.
• Para revogar o acesso, exclua a chave de API em Integrações > Chaves de API e remova o servidor da configuração do seu cliente.