Claude Desktop-integratie

Claude kan je urenregistratie bedienen via het Model Context Protocol. Zodra de koppeling staat, vertel je wat je gedaan hebt en Claude legt het vast: geen formulieren, geen andere app.

Wat je kunt vragen

• "Start de timer voor het websiteproject"
• "Pauzeer mijn timer, ik ga lunchen"
• "Voeg € 45 aan onkosten toe voor de lunch met de klant"
• "Laat mijn urenregels van deze week zien"
• "Hoeveel uur heb ik vorige maand aan Acme gefactureerd?"

Voordat je begint

• Een Timesheet Pro-abonnement of hoger. Bekijk de abonnementen en prijzen.
• Claude Desktop geïnstalleerd, of een account op claude.ai.

Optie 1: de gehoste connector

De snelste route, en je hoeft niets te installeren. Voeg in Claude een eigen connector toe en wijs die naar:

https://mcp.timesheet.io

Claude stuurt je naar Timesheet om in te loggen en toegang te geven, waarna de tools in je gesprek verschijnen. De autorisatie loopt via OAuth, dus er komt geen API-sleutel in je configuratie te staan.

Optie 2: de server lokaal draaien

Houd je liever alles op je eigen machine? Maak een API-sleutel aan in de webapp onder Integraties > API-sleutels en pas daarna het configuratiebestand van Claude Desktop aan:

• 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"
      }
    }
  }
}

Hiervoor heb je Node.js 18 of hoger nodig, zodat de server via npx kan draaien. Start Claude Desktop opnieuw op en vraag "Wat is mijn timerstatus?" om te controleren of de verbinding staat.

Waar Claude bij kan

De server biedt 50 tools, verdeeld over:

• Timer: starten, stoppen, pauzeren, hervatten, status opvragen, bijwerken
• Taken: aanmaken, bijwerken, verwijderen, opsommen, plus notities, onkosten en pauzes op de lopende taak
• Projecten: aanmaken, bijwerken, verwijderen, opsommen en details opvragen
• Rapporten en exports: documenten, taak- en onkostenrapporten, pdf-uitvoer, exports naar Excel en CSV, en opgeslagen exportsjablonen
• Verlof: aanvragen, goedkeuren, afwijzen, annuleren en opsommen, plus de verlofsoorten
• Statistieken: samenvattingen over elke gewenste periode

Goed om te weten

• De server kan urenregels lezen en aanmaken, projecten beheren en notities, onkosten en pauzes toevoegen. Hij kan niet bij de privégegevens van andere gebruikers en verandert niets aan je facturatie.
• Bij de lokale optie geeft je API-sleutel volledige toegang tot je account. Deel hem nooit en zet hem niet in versiebeheer.
• Wil je de toegang intrekken, verwijder dan de API-sleutel onder Integraties > API-sleutels en haal de server uit je configuratie.