Какво Ви е необходимо?
Три неща: акаунт в тракер за време, който поддържа MCP сървър, AI асистент с MCP поддръжка и адресът на сървъра. За Half5 този адрес е https://app.half5.com/mcp.
Не е нужно да инсталирате нищо и няма API ключ за копиране. Когато се свързвате, асистентът отваря страница за вход във Вашия браузър. Влизате с обичайния си акаунт и давате съгласие. Какво точно е MCP ще намерите в Какво е MCP?.
- Асистенти за програмиране: Claude Code, Codex и Cursor. Работят директно във Вашия проект и могат да предадат името на репозиторито.
- Чат асистенти: Claude.ai (включително Claude Desktop и мобилното приложение) и ChatGPT. Те не знаят Вашето репозитори, затова по-често питат за клиента.
- Други: VS Code и други програми, които поддържат отдалечен MCP сървър с OAuth.
Как се свързва асистентът?
Всеки асистент пази настройките си на различно място. Таблицата следва инструкциите, които ще видите в Half5. Менютата в тези приложения понякога се променят; ако не намирате дадена опция, потърсете „MCP“, „connector“ или „custom connector“.
| Асистент | Къде | Какво да направите |
|---|---|---|
| Claude Code | Терминал | claude mcp add --transport http --scope user half5 https://app.half5.com/mcp, после /mcp в Claude Code, избирате half5 и влизате |
| Codex | Терминал | codex mcp add half5 --url https://app.half5.com/mcp, после codex mcp login half5; Codex отваря браузъра Ви |
| Cursor | ~/.cursor/mcp.json | {"mcpServers":{"half5":{"url":"https://app.half5.com/mcp"}}}, след това Свържете от Настройки → MCP |
| Claude.ai, Desktop, app | Настройки → Свързани приложения | Добавете custom connector, поставете URL и влезте |
| ChatGPT | Настройки → Приложения и свързвания → Разширени | Включете Developer mode, изберете Създай, поставете URL и изберете OAuth |
| VS Code и други | MCP настройки | Добавете отдалечен (HTTP) MCP сървър с този URL |
Developer mode в ChatGPT не е наличен във всеки план. Ако не виждате опцията, проверете какво позволява Вашият абонамент.
Какво да кажете на асистента?
Обикновеният език е достатъчен. Не са нужни ID-та, клиентски номера или проектни кодове. Добре е да посочите клиента или проекта, ако ги знаете, както и времето.
- „Запиши час и половина за тази задача.“
- „Работих по интеграцията на платежния доставчик от 9:00 до 11:30. Запиши това за Jansen Bakery.“
- „Запиши тази сесия по проекта Webshop.“ (без продължителност: тракерът предлага време за потвърждение)
- „Какво записах вчера?“
- „Премести записа от тази сутрин към проекта Maintenance.“
- „Изтрий дублирания запис от днес.“
Какво се случва след записване?
Запис от асистент не е бележка – това е стандартен запис, който преминава през същите проверки като останалите Ви часове.
- Асистентът изпраща кратко описание, дата, продължителност (ако е известна) и при програмиращите асистенти – име на репозитори и клон.
- Тракерът избира клиент, проект и дейност. Ако не е сигурен, асистентът Ви задава въпрос с няколко опции.
- Без посочена продължителност, тракерът предлага за днес времето от края на последния запис. За друг ден асистентът Ви пита за продължителността. Нищо не се записва, докато не потвърдите.
- Записът пристига като неодобрен. Ако организацията Ви използва одобрение, отговорникът го преглежда както останалите часове.
- Записът веднага влиза в справките. Ако има одобрение, може да се фактурира едва след одобрение.
Кои навици предотвратяват грешки?
Асистентът е бърз, но не знае колко точно сте работили. Тези навици правят записите Ви надеждни, особено когато по-късно трябва да обясните часовете.
- Един запис за всяка отделна задача. Три записа по един час за три задачи са по-добри от един общ за три часа.
- Не измисляйте продължителност. Ако не знаете, пропуснете я и потвърдете или коригирайте предложението.
- Проверявайте какво вече е записано. Преди да впишете цял ден, помолете асистента да покаже записите за деня, за да избегнете дублиране.
- Пишете за клиента. Описанието може да се появи във фактура. Едно ясно изречение, без имена на файлове или код.
- Посочвайте клиента при съмнение. Ясно посочен клиент или проект винаги е по-добре от това, което асистентът предполага.
Какво не може да прави?
Асистентът записва това, което Вие или той можете да обосновете; не измерва времето Ви. Ако искате работният Ви ден да се отчита автоматично, използвайте таймлайн, описан в Автоматично отчитане на време.
Свързаният асистент вижда само Вашите собствени часове. Не може да вижда часовете на колеги, да одобрява часове или да създава фактури. Може да редактира или изтрива само Вашите записи, докато не са одобрени.
Как Half5 го прави
В Half5 инструкциите за настройка са под Настройки → „Свързани агенти“, в „Свържи агент“. Екранът за съгласие показва с коя организация се свързвате и какво може да прави агентът: да вижда и записва часове. Непознат клиент се отбелязва като „Непотвърдено приложение“.
Записите от агент пристигат като „Все още не е одобрен“ и следват същия процес като другите Ви часове. Half5 избира клиента и проекта според данните от агента, предишните Ви записи и по кое репозитори сте работили за кой клиент. Подробности има в Как работи log_work; какво се случва с Вашите данни – в Поверителност с AI агенти.
Често задавани въпроси
Трябва ли да инсталирам нещо, за да записвам часове с Claude или ChatGPT?
Не. Добавяте адреса на сървъра в асистента и влизате през браузъра си. Само за Claude Code и Codex се въвежда една команда в терминала.
Може ли асистентът да определи колко съм работил?
Не бива. Ако не посочите продължителност, Half5 предлага за днес времето от края на последния Ви запис, а Вие го потвърждавате или коригирате. За друг ден асистентът ще Ви попита за продължителността.
Защо ChatGPT по-често пита кой е клиентът, отколкото Claude Code?
Чат асистентът не знае Вашето репозитори и има по-малко информация за разпознаване на клиента. Half5 тогава гледа описанието и Вашите записи от последните 90 дни. Ако посочите клиента, няма нужда да пита.
Може ли агент да вижда или одобрява часовете на колегите ми?
Не. Свързаният агент вижда само Вашите собствени часове и клиентите, проектите и дейностите, до които имате достъп. Одобрението става в самия Half5.
Какво ако агентът запише нещо грешно?
Помолете асистента да промени или изтрие записа, или го направете сами в Half5. Докато записът не е одобрен, агентът може да го редактира; след това го правите в приложението.
