Integração com o Cursor e o VS Code

O registro de horas falha quando exige trocar de janela. Adicionar o servidor MCP do Timesheet ao seu editor permite que o assistente que você já usa inicie o cronômetro, registre o que você terminou e puxe um relatório, tudo dentro do editor.

O que você pode pedir

• "Inicie o cronômetro do projeto deste repositório"
• "Pare o cronômetro e anote que terminei a migração"
• "Quanto tempo eu gastei neste projeto esta semana?"
• "Registre 90 minutos na refatoração para ontem à tarde"

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, para que o servidor rode pelo npx.

Cursor

Abra Cursor Settings > Features > MCP Servers e adicione:

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

VS Code com o Continue

Instale a extensão Continue e adicione o servidor à configuração dela:

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

Outros editores

Qualquer editor ou cliente compatível com o Model Context Protocol roda o mesmo servidor. O comando é npx @timesheet/mcp com TIMESHEET_API_TOKEN no ambiente. Para uma instalação global, rode npm install -g @timesheet/mcp e use timesheet-mcp como comando.

Solução de problemas

• Nada responde ou a autenticação falha. Verifique se o TIMESHEET_API_TOKEN não tem espaços ou aspas sobrando e se a chave ainda existe em Integrações > Chaves de API.
• Comando não encontrado. Confirme o Node.js 18 ou superior com node --version. Se o npx não encontrar o pacote, instale-o globalmente.
• O cronômetro não inicia. Confira se o nome do projeto corresponde a um projeto existente ao qual você tem acesso. Pergunte "qual é o status do meu cronômetro?" para testar a conexão isoladamente.

Vale saber

Sua chave de API dá acesso total à sua conta, então mantenha-a fora de tudo o que você versiona. Para revogar o acesso, exclua a chave em Integrações > Chaves de API e remova o servidor da configuração do seu editor.