Mitä tarvitset?
Tarvitset kolme asiaa: tunnuksen tuntikirjanpitoon, jossa on MCP-palvelin, tekoälyassistentin joka tukee MCP:tä, ja palvelimen osoitteen. Half5:n osoite on https://app.half5.com/mcp.
Mitään ei tarvitse asentaa eikä API-avainta kopioida. Kun yhdistät, assistentti avaa selaimeesi kirjautumissivun. Kirjaudut omilla tunnuksillasi ja annat luvan. Mikä MCP tarkalleen on, selitetään kohdassa Mikä on MCP?.
- Koodausassistentit: Claude Code, Codex ja Cursor. Ne toimivat projektissasi ja osaavat välittää myös repositorion nimen.
- Chat-assistentit: Claude.ai (myös Claude Desktop ja mobiilisovellus) sekä ChatGPT. Nämä eivät tiedä repositoriotasi, joten ne kysyvät useammin asiakkaan.
- Muut: VS Code ja muut ohjelmat, jotka tukevat etä-MCP-palvelinta OAuthilla.
Miten assistentti liitetään?
Jokainen assistentti tallentaa asetuksen eri paikkaan. Taulukossa on ohjeet, jotka näkyvät myös Half5:ssä. Sovellusten valikkonimet voivat muuttua; jos et löydä oikeaa, etsi ‘MCP’, ‘liitäntä’ tai ‘oma liitäntä’.
| Assistentti | Missä | Mitä teet |
|---|---|---|
| Claude Code | Pääte | claude mcp add --transport http --scope user half5 https://app.half5.com/mcp, sitten /mcp Claude Codessa, valitse half5 ja kirjaudu sisään |
| Codex | Pääte | codex mcp add half5 --url https://app.half5.com/mcp, sitten codex mcp login half5; Codex avaa selaimesi |
| Cursor | ~/.cursor/mcp.json | {"mcpServers":{"half5":{"url":"https://app.half5.com/mcp"}}}, sitten yhdistä kohdassa Asetukset → MCP |
| Claude.ai, Desktop, sovellus | Asetukset → Liitännät | Lisää oma liitäntä, liitä osoite ja kirjaudu sisään |
| ChatGPT | Asetukset → Sovellukset & liitännät → Lisäasetukset | Ota kehittäjätila käyttöön, valitse Luo, liitä osoite ja valitse OAuth |
| VS Code ja muut | MCP-asetukset | Lisää etä (HTTP) MCP-palvelin osoitteella |
ChatGPT:n kehittäjätila ei ole saatavilla kaikissa tilauksissa. Jos et näe vaihtoehtoa, tarkista mitä oma tilauksesi sallii.
Miten puhut assistentille?
Tavallinen kieli riittää. Et tarvitse tunnisteita, asiakasnumeroita tai projektikoodeja. Nimeä asiakas tai projekti jos tiedät, ja aika jos tiedät.
- ‘Kirjaa puolitoista tuntia tälle työlle.’
- ‘Tein maksupalvelun integraatiota klo 9:00–11:30. Kirjaa se Jansen Bakerylle.’
- ‘Kirjaa tämä sessio Webshop-projektille.’ (ei kestoa: tuntikirjanpito ehdottaa aikaa, jonka vahvistat)
- ‘Mitä kirjasin eilen?’
- ‘Siirrä tämän aamun merkintä Maintenance-projektiin.’
- ‘Poista tämän päivän tuplamerkintä.’
Mitä tapahtuu kirjaamisen jälkeen?
Assistentin kirjaama merkintä ei ole sivuhuomio, vaan tavallinen tuntimerkintä joka käy läpi samat tarkistukset kuin muutkin tuntisi.
- Assistentti lähettää lyhyen kuvauksen, päivämäärän, keston (jos tiedossa) ja koodausassistentit myös repositorion ja haaran.
- Tuntikirjanpito valitsee asiakkaan, projektin ja aktiviteetin. Jos se ei ole varma, assistentti kysyy sinulta ja antaa vaihtoehtoja.
- Ilman kestoa tuntikirjanpito ehdottaa tälle päivälle aikaa edellisen merkinnän päättymisestä. Muihin päiviin assistentti kysyy keston. Mitään ei tallenneta ennen kuin vahvistat.
- Merkintä tulee tilaan ei hyväksytty. Jos organisaatiossasi käytetään hyväksyntää, hyväksyjä tarkistaa sen kuten muutkin tuntisi.
- Merkintä näkyy raporteissa heti. Jos hyväksyntä on käytössä, se voidaan laskuttaa vasta hyväksynnän jälkeen.
Millä tavoilla vältät virheet?
Assistentti on nopea, mutta ei tiedä kauanko oikeasti työskentelit. Näillä tavoilla pidät kirjanpidon luotettavana – myös silloin kun myöhemmin pitää selittää mihin aika meni.
- Yksi merkintä yhtäjaksoista tehtävää kohti. Kolme tunnin merkintää kolmesta työstä on parempi kuin yksi kolmen tunnin merkintä kaikesta.
- Älä keksi kestoa. Jos et tiedä, jätä pois ja vahvista tai korjaa ehdotus.
- Tarkista mitä on jo kirjattu. Ennen kuin kirjaat koko päivän, pyydä assistenttia listaamaan päivän merkinnät, ettei mitään tule kahteen kertaan.
- Kirjoita asiakkaalle. Kuvaus voi päätyä laskulle. Yksi selkeä lause, ei tiedostonimiä tai koodia.
- Nimeä asiakas jos olet epävarma. Selkeä asiakas tai projekti voittaa aina assistentin arvauksen.
Mitä se ei osaa?
Assistentti kirjaa sen minkä sinä tai se voitte perustella; se ei mittaa aikaasi. Jos haluat työpäiväsi tallentuvan automaattisesti, tarvitset aikajanan, kuten kohdassa Automaattinen tuntikirjaus.
Liitetty assistentti näkee vain omat tuntisi. Se ei näe kollegoiden tunteja, hyväksy tunteja eikä tee laskuja. Se voi muokata tai poistaa vain omia merkintöjäsi niin kauan kuin niitä ei ole hyväksytty.
Näin Half5 toimii
Half5:ssä ohjeet löytyvät kohdasta Asetukset → ‘Liitetyt agentit’, valikossa ‘Liitä agentti’. Luvanannossa näet minkä organisaation yhdistät ja mitä agentti saa tehdä: nähdä ja kirjata tunteja. Tuntematon asiakas näkyy nimellä ‘Vahvistamaton sovellus’.
Agentin kirjaamat merkinnät tulevat tilaan ‘Ei vielä hyväksytty’ ja etenevät kuten muutkin tuntisi. Half5 tunnistaa asiakkaan ja projektin agentin lähettämistä tiedoista, aiemmista merkinnöistäsi ja siitä, mille asiakkaalle olet aiemmin kirjannut kyseisestä repositoriosta. Tarkemmin kohdassa Näin log_work toimii; tietosuojasta kohdassa Tietosuoja AI-agenttien kanssa.
Usein kysytyt kysymykset
Pitääkö Clauden tai ChatGPT:n tuntikirjausta varten asentaa jotain?
Ei tarvitse. Lisäät palvelinosoitteen assistenttiin ja kirjaudut selaimessa. Vain Claude Codessa ja Codexissa liität yhden komennon päätteeseen.
Voiko assistentti päättää kauanko työskentelin?
Ei pitäisi. Jos et anna kestoa, Half5 ehdottaa tälle päivälle aikaa edellisen merkinnän päättymisestä, ja vahvistat tai korjaat sen. Muihin päiviin se kysyy keston.
Miksi ChatGPT kysyy asiakkaan useammin kuin Claude Code?
Chat-assistentti ei tiedä repositoriotasi, joten sillä on vähemmän mistä tunnistaa asiakas. Half5 katsoo silloin kuvauksen ja omat merkintäsi viimeiseltä 90 päivältä. Jos nimeät asiakkaan, sitä ei tarvitse kysyä.
Voiko agentti nähdä tai hyväksyä kollegoiden tunteja?
Ei. Liitetty agentti näkee vain omat tuntisi sekä ne asiakkaat, projektit ja aktiviteetit joihin sinulla on oikeus. Hyväksyntä tehdään Half5:ssä.
Mitä jos agentti kirjaa väärin?
Pyydä assistenttia muuttamaan tai poistamaan merkintä, tai tee se itse Half5:ssä. Niin kauan kuin merkintää ei ole hyväksytty, agentti voi muuttaa sitä; sen jälkeen muokkaus tehdään sovelluksessa.
