Mida on vaja?
Kolm asja: konto ajaregistris, mis töötab MCP serverina, AI assistent, mis toetab MCP-d, ja serveri aadress. Half5 puhul on see aadress https://app.half5.com/mcp.
Midagi pole vaja installida ega API võtit kopeerida. Ühendamisel avab assistent teie brauseris sisselogimislehe. Logite sisse oma tavakontoga ja annate nõusoleku. Mis MCP täpsemalt on, loe Mis on MCP?.
- Koodi assistendid: Claude Code, Codex ja Cursor. Need töötavad teie projektis ja saavad edastada ka repositooriumi nime.
- Vestlusassitendid: Claude.ai (sh Claude Desktop ja mobiilirakendus) ning ChatGPT. Need ei tea teie repositooriumi, seega küsivad sagedamini, millise kliendiga on tegu.
- Muud: VS Code ja teised programmid, mis toetavad kaug-MCP serverit OAuthiga.
Kuidas assistenti ühendada?
Iga assistent hoiab seda seadistust eri kohas. Tabelis on toodud juhised, mida näete Half5 sees. Rakenduste menüünimed võivad muutuda; kui te ei leia õiget kohta, otsige ‘MCP’, ‘connector’ või ‘custom connector’.
| Assistent | Asukoht | Mida teha |
|---|---|---|
| Claude Code | Terminal | claude mcp add --transport http --scope user half5 https://app.half5.com/mcp, seejärel /mcp Claude Code’is, vali half5 ja logi sisse |
| Codex | Terminal | codex mcp add half5 --url https://app.half5.com/mcp, seejärel codex mcp login half5; Codex avab teie brauseri |
| Cursor | ~/.cursor/mcp.json | {"mcpServers":{"half5":{"url":"https://app.half5.com/mcp"}}}, seejärel Ühenda seadetes → MCP |
| Claude.ai, Desktop, rakendus | Seaded → Ühendused | Lisa kohandatud ühendus, kleebi URL ja logi sisse |
| ChatGPT | Seaded → Rakendused & Ühendused → Täpsemad | Lülita arendajarežiim sisse, vali Loo, kleebi URL ja vali OAuth |
| VS Code ja teised | MCP seaded | Lisa kaug- (HTTP) MCP server selle URL-iga |
Arendajarežiim ChatGPT-s pole igal paketil saadaval. Kui te seda valikut ei näe, kontrollige oma paketi võimalusi.
Mida assistendile öelda?
Tavaline keelest piisab. ID-sid, kliendinumbreid ega projektikoode pole vaja. Kui teate, nimetage klient või projekt ning aeg.
- ‘Logi sellele tööle poolteist tundi.’
- ‘Töötasin makselahenduse liidestuse kallal 9:00–11:30. Logi see Jansen Bakery jaoks.’
- ‘Logi see sessioon Webshopi projekti alla.’ (kestus puudub: ajaregister pakub ise, teie kinnitate)
- ‘Mida ma eile logisin?’
- ‘Tõsta tänahommikune kanne Hoolduse projekti alla.’
- ‘Kustuta tänane topeltkanne.’
Mis juhtub pärast logimist?
Assistentide kaudu tehtud kanne pole kõrvalmärkus, vaid tavaline tööaja kanne, mis läbib samad kontrollid nagu teisedki tunnid.
- Assistent saadab lühikirjelduse, kuupäeva, kestuse (kui teada) ning koodi assistentide puhul ka repositooriumi nime ja haru.
- Ajaregister valib kliendi, projekti ja tegevuse. Kui ta pole kindel, küsib assistent teilt täpsustuse koos valikutega.
- Kui kestust pole, pakub ajaregister tänase puhul aja eelmisest kande lõpust. Teise päeva puhul küsib assistent kestust. Midagi ei salvestata enne teie kinnitust.
- Kanne jõuab süsteemi kinnitamata kujul. Kui teie organisatsioon kasutab kinnitamist, vaatab kinnitaja selle üle nagu teisedki tunnid.
- Kanne läheb kohe aruannetesse. Kui kinnitamine on nõutud, saab see arvele alles pärast kinnitamist.
Millised harjumused aitavad vigu vältida?
Assistent on kiire, kuid ei tea, kui kaua te tegelikult töötasite. Need harjumused aitavad hoida arvestust usaldusväärsena, ka siis, kui hiljem on vaja selgitada, kuhu tunnid kulusid.
- Üks kanne iga järjestikuse töö kohta. Kolm ühe tunni kannet kolmele tööle on parem kui üks kolmetunnine kanne kõige kohta.
- Ärge kunagi mõelge kestust välja. Kui te ei tea, jätke kestus märkimata ja kinnitage või parandage pakutud aeg.
- Kontrollige, mis on juba olemas. Enne terve päeva logimist laske assistendil päeva kanded ette lugeda, et midagi topelt ei läheks.
- Kirjutage kliendi jaoks. Kirjeldus võib jõuda arvele. Üks loetav lause, ilma failinimede ja koodita.
- Nimetage klient, kui pole kindel. Selge klient või projekt on alati parem kui see, mida assistent oletab.
Mida assistent ei tee?
Assistent logib seda, mida teie või tema suudab põhjendada; ta ei mõõda teie aega. Kui soovite, et kogu tööpäev salvestuks automaatselt, vajate ajajoont, nagu kirjeldatud Automaatne tööaja registreerimine.
Ühendatud assistent näeb ainult teie enda tunde. Ta ei näe kolleegide tunde, ei saa neid kinnitada ega arveid koostada. Ta saab muuta või kustutada ainult teie enda kinnitamata kandeid.
Nii teeb Half5 seda
Half5-s on seadistusjuhised Seaded → ‘Seotud agendid’ all, valikus ‘Seo agent’. Nõusolekulehel näete, millise organisatsiooniga ühendate ja mida agent võib teha: vaadata ja logida tunde. Tundmatu kliendi puhul on märge ‘Kinnitamata rakendus’.
Agentide kaudu tehtud kanded jõuavad seisuga ‘Pole veel kinnitatud’ ja liiguvad edasi nagu teisedki tunnid. Half5 valib kliendi ja projekti selle põhjal, mida agent saadab, teie varasemate kannete ja selle järgi, millist repositooriumi olete millise kliendi alla varem loginud. Täpsemalt loe Kuidas log_work töötab; andmete käitlemisest loe Privaatsus AI agentidega.
Korduma kippuvad küsimused
Kas Claude’i või ChatGPT-ga tundide logimiseks on vaja midagi installida?
Ei. Lisate serveriaadressi assistenti ja logite sisse brauseris. Ainult Claude Code’i ja Codexi puhul tuleb üks käsk terminali kleepida.
Kas assistent saab ise otsustada, kui kaua ma töötasin?
Ei tohiks. Kui te kestust ei anna, pakub Half5 tänase puhul aja eelmisest kande lõpust ja teie kinnitate või parandate selle. Teise päeva puhul küsitakse kestust.
Miks küsib ChatGPT sagedamini, milline klient on, kui Claude Code?
Vestlusassistent ei tea teie repositooriumi, seega on tal vähem infot kliendi tuvastamiseks. Half5 vaatab siis teie kirjeldust ja viimase 90 päeva kandeid. Kui nimetate kliendi, pole vaja küsida.
Kas agent näeb või saab kinnitada kolleegide tunde?
Ei. Ühendatud agent näeb ainult teie enda tunde ning neid kliente, projekte ja tegevusi, millele teil on ligipääs. Kinnitamine toimub Half5-s.
Mis saab, kui agent logib midagi valesti?
Paluge assistendil kanne muuta või kustutada või tehke seda ise Half5-s. Kuni kanne pole kinnitatud, saab agent seda muuta; pärast kinnitamist saab seda teha ainult rakenduses.
