X’għandek bżonn?
Tliet affarijiet: kont ma’ time tracker li jħaddem MCP server, assistent AI li jappoġġja MCP, u l-indirizz tas-server. Għal Half5 l-indirizz hu https://app.half5.com/mcp.
M’hemmx bżonn tinstalla xejn u lanqas tikkopja API key. Meta tikkonnettja, l-assistent jiftaħ paġna ta’ login fil-browser tiegħek. Tidħol bil-kont normali tiegħek u tagħti l-kunsens. X’inhu eżattament MCP tispjegah f’X’inhu MCP?.
- Coding assistants: Claude Code, Codex u Cursor. Jaħdmu direttament fil-proġett tiegħek u jistgħu jgħaddu l-isem tar-repository.
- Chat assistants: Claude.ai (inkluż Claude Desktop u l-app mobbli) u ChatGPT. Dawn ma jafux ir-repository tiegħek, allura jistaqsu aktar drabi min hu l-klijent.
- Oħrajn: VS Code u programmi oħra li jappoġġjaw MCP server remot b’OAuth.
Kif tikkonnettja l-assistent tiegħek?
Kull assistent iżomm is-setting f’post differenti. It-tabella ssegwi l-istruzzjonijiet li jidhru ġewwa Half5. L-ismijiet tal-menus jistgħu jinbidlu minn żmien għal żmien; jekk ma ssibx waħda, fittex għal ‘MCP’, ‘connector’ jew ‘custom connector’.
| Assistent | Fejn | X’tagħmel |
|---|---|---|
| Claude Code | Terminal | claude mcp add --transport http --scope user half5 https://app.half5.com/mcp, imbagħad /mcp f’Claude Code, agħżel half5 u idħol |
| Codex | Terminal | codex mcp add half5 --url https://app.half5.com/mcp, imbagħad codex mcp login half5; Codex jiftaħ il-browser tiegħek |
| Cursor | ~/.cursor/mcp.json | {"mcpServers":{"half5":{"url":"https://app.half5.com/mcp"}}}, imbagħad Connect taħt Settings → MCP |
| Claude.ai, Desktop, app | Settings → Connectors | Żid custom connector, ippejstja l-URL u idħol |
| ChatGPT | Settings → Apps & Connectors → Advanced | Ixgħel Developer mode, agħżel Create, ippejstja l-URL u agħżel OAuth |
| VS Code u oħrajn | MCP settings | Żid MCP server remot (HTTP) bl-URL |
Developer mode f’ChatGPT mhux disponibbli fuq kull pjan. Jekk ma tarax l-għażla, iċċekkja x’jippermetti l-pjan tiegħek.
X’tgħid lill-assistent?
Lingwa sempliċi biżżejjed. M’hemmx bżonn IDs, numri tal-klijent jew kodiċijiet tal-proġett. Semmi l-klijent jew il-proġett jekk tafhom, u l-ħin jekk tafu.
- ‘Irreġistra siegħa u nofs għal dan ix-xogħol.’
- ‘Ħdimt fuq l-integrazzjoni tal-payment provider mid-9:00 sal-11:30. Irreġistra dan għal Jansen Bakery.’
- ‘Irreġistra din is-sessjoni fuq il-proġett Webshop.’ (mingħajr tul: it-time tracker jipproponi wieħed biex tikkonferma)
- ‘X’reġistrajt ilbieraħ?’
- ‘Mexxi d-dħul ta’ dalgħodu għall-proġett Maintenance.’
- ‘Ħassar id-dħul duplikat ta’ llum.’
X’jiġri wara r-reġistrazzjoni?
Dħul minn agent mhux nota fil-ġenb. Huwa reġistrazzjoni normali li tgħaddi mill-istess verifiki bħas-sigħat l-oħra tiegħek.
- L-assistent jibgħat deskrizzjoni qasira, id-data, it-tul (jekk magħruf) u, għal coding assistants, l-isem tar-repository u l-branch.
- It-time tracker jagħżel il-klijent, il-proġett u l-attività. Jekk ma jkunx ċert, l-assistent jistaqsik b’xi għażliet.
- Jekk ma tispeċifikax tul, it-time tracker jipproponi, għal illum, il-ħin minn meta spiċċajt l-aħħar dħul tiegħek. Għal ġurnata oħra, l-assistent jistaqsik għat-tul. Xejn ma jinħażen sakemm tikkonferma.
- Id-dħul jidħol bħala mhux approvat. Jekk l-organizzazzjoni tiegħek tuża approvazzjoni, approver jirrevedih bħas-sigħat l-oħra.
- Id-dħul jidħol fir-rapporti minnufih. Jekk l-approvazzjoni tkun mixgħula, jista’ jiġi ffatturat biss wara l-approvazzjoni.
Liema drawwiet jgħinuk tevita żbalji?
Assistent hu malajr, imma ma jafx eżatt kemm ħdimt. Dawn id-drawwiet iżommu r-rekords tiegħek affidabbli, anke meta jkollok tispjega aktar tard fejn marru s-sigħat.
- Dħul wieħed għal kull kompitu bla waqfien. Tliet dħul ta’ siegħa għal tliet xogħlijiet huma aħjar minn dħul wieħed ta’ tliet sigħat b’kollox fih.
- Qatt tinveta tul. Jekk ma tafx, ħalli vojta u kkonferma jew ikkoreġi l-proposta.
- Iċċekkja x’diġà hemm. Qabel tirreġistra ġurnata sħiħa, staqsi lill-assistent juri d-dħul ta’ dik il-ġurnata biex ma tirreġistrax doppju.
- Ikteb għall-klijent. Id-deskrizzjoni tista’ tidher fuq fattura. Linja waħda li tinftiehem, mingħajr ismijiet ta’ fajls jew kodiċi.
- Semmi l-klijent jekk m’intix ċert. Klijent jew proġett ċar dejjem jipprevali fuq dak li jassumi l-assistent.
X’ma jistax jagħmel?
Assistent jirreġistra biss dak li inti jew hu tistgħu tiġġustifikaw; ma jkejjelx il-ħin tiegħek. Jekk trid li l-ġurnata tax-xogħol tiġi reġistrata awtomatikament, għandek bżonn timeline, kif spjegat f’Reġistrazzjoni awtomatika tas-sigħat.
Agent konness ukoll jara biss is-sigħat tiegħek. Ma jistax jara s-sigħat tal-kollegi, japprova sigħat jew joħloq fatturi. Jista’ jeditja jew iħassar biss id-dħul tiegħek stess sakemm għadu mhux approvat.
Kif jaħdem Half5
F’Half5 l-istruzzjonijiet tas-setup jinsabu taħt Settings → ‘Agents marbuta’, f’‘Rabtet agent’. L-iskrin tal-kunsens juri liema organizzazzjoni qed tikkonnettja u x’jista’ jagħmel l-agent: jara u jirreġistra sigħat. Klijent mhux magħruf jidher bħala ‘App mhux verifikata’.
Dħul minn agent jidħol bħala ‘Għadu mhux approvat’ u jimxi bl-istess proċess bħas-sigħat l-oħra. Half5 jagħżel il-klijent u l-proġett minn dak li jibgħat l-agent, id-dħul preċedenti tiegħek u liema repository irreġistrajt fuq liema klijent. Id-dettalji jinsabu f’Kif taħdem log_work; x’jiġri bid-data tiegħek tispjegah f’Privatezza ma’ agents AI.
Mistoqsijiet ta’ spiss
Għandi bżonn ninstalla xi ħaġa biex irreġistra s-sigħat ma’ Claude jew ChatGPT?
Le. Żżid l-indirizz tas-server fl-assistent tiegħek u tidħol mill-browser. Biss għal Claude Code u Codex għandek tikkopja command wieħed fit-terminal.
L-assistent jista’ jiddeċiedi kemm ħdimt?
M’għandux. Jekk ma tispeċifikax tul, Half5 jipproponi, għal illum, il-ħin minn meta spiċċajt l-aħħar dħul, u inti tikkonferma jew tikkoreġi. Għal ġurnata oħra jistaqsik għat-tul.
Għaliex ChatGPT jistaqsini aktar drabi min hu l-klijent meta mqabbel ma’ Claude Code?
Chat assistant ma jafx ir-repository tiegħek, allura għandu inqas informazzjoni biex jagħraf il-klijent. Half5 imbagħad iħares lejn id-deskrizzjoni tiegħek u d-dħul tiegħek tal-aħħar 90 jum. Jekk issemmi l-klijent, ma jkollux għalfejn jistaqsik.
Agent jista’ jara jew japprova s-sigħat tal-kollegi tiegħi?
Le. Agent konness jara biss is-sigħat tiegħek u l-klijenti, proġetti u attivitajiet li int intitolat tara. L-approvazzjoni ssir ġewwa Half5.
U jekk l-agent jirreġistra xi ħaġa ħażina?
Staqsi lill-assistent jibdel jew iħassar id-dħul, jew agħmel dan int stess ġewwa Half5. Sakemm id-dħul għadu mhux approvat l-agent jista’ jibdlu; wara, tagħmel dan fl-app.
