Справочник

Свързване на AI асистент

TimerOS поддържа хостван MCP (Model Context Protocol) сървър на адрес https://api.timeros.ai/mcp, така че AI асистент, който вече ползвате, може да чете работата ви и, ако му позволите, да прави ограничен набор от промени. Няма нищо за инсталиране. Асистентът действа като вас: всяка заявка минава през същите маршрути, проверки и права, които има и вашият собствен вход, така че той никога не може да види повече от вас. Наличен е във всеки план (Freelancer, Startup и Enterprise) без доплащане и е тестван с Claude: claude.ai в браузъра, настолното приложение Claude и Claude Code.

Как да се свържете

  1. 1В TimerOS отворете Настройки → Връзки (в настолното или в уеб приложението) и копирайте адреса на конектора, или използвайте направо https://api.timeros.ai/mcp.
  2. 2В Claude отворете Settings → Connectors → Add custom connector и поставете адреса.
  3. 3Отваря се страница за вход в TimerOS. Влезте с имейла и паролата си за TimerOS; ако двуфакторното удостоверяване е включено за акаунта ви, въведете и кода. Работно пространство, което изисква двуфакторно удостоверяване, отказва акаунти, които още не са го включили.
  4. 4На страницата за съгласие проверете името на асистента, името на работното си пространство и достъпа, който е поискал: само четене или четене и запис, а редом с него и фиксирания списък с нещата, които никога не може да прави. Натиснете Allow access, за да разрешите, или Cancel, за да откажете.
  5. 5Очаквайте имейл, който потвърждава новата връзка. В него са името на асистента и обхватът на достъпа, както и къде можете да прекъснете връзката.

Какво може да прави

С достъп само за четене асистентът може да обобщава проекти, да намира задачи и да преглежда екипи, хора, цели, клиенти, фактури, разходи и отчета за печалбата, като четенето никога не променя нищо. С четене и запис може също да добавя и обновява задачи и подзадачи, да сменя статуса на задача, да добавя бележки, да записва оперативни разходи, да създава проекти с фази и да разпределя вашите неразпределени отчетени часове към задачите ви.

Малките промени (статус, бележка, нова задача) се записват с едно извикване. По-големите (създаване на проект, добавяне на фаза, създаване на набор от подзадачи, разпределяне на часове) минават през две стъпки — първо план, после прилагане: асистентът получава план, който ви показва, и след това го прилага с отделно извикване, което връща дословно текста за потвърждение от плана. Планът изтича след 10 минути и се прилага точно веднъж. Разпределянето на часове е единственият запис, свързан с време: то отнася минути, които вече сте отчели, но още не сте разпределили, към вашите собствени задачи. То никога не създава време, не мести време между задачи и не редактира дневните общи стойности.

Какво никога не може да прави

Това не са права, които давате или отнемате: такива инструменти просто не съществуват.

  • Да сменя статуса на етап (което може да издаде фактура към клиент), да отчита или редактира време извън разпределянето по-горе, да назначава хора, да задава бюджети или ставки, да създава или изпраща фактури, да редактира клиенти или служители, да записва цели, да вписва транзакции или фактури от доставчици, нито да изтрива каквото и да е.
  • Да вижда заплати и възнаграждения, данъчни номера, дати на раждане, домашни адреси или контакти за спешни случаи: тези полета се премахват от всеки отговор.
  • Да чете написаното от клиенти: заявки за промяна в портала, чат и инциденти. Имената и описанията на клиентите и бележките по фактурите се третират като данни, никога като инструкции.
  • Да заобикаля вашите права или да стига до друго работно пространство.

Управление на връзките

Настройки → Връзки показва всеки асистент, свързан с вашия акаунт: име, обхват, кога е свързан, кога е използван за последно и колко промени е записал. Разгънете връзка, за да видите списъка Активност: всяка промяна, направена от асистента, заедно с извикването за отмяна. Прекъсни връзката е едно натискане, а достъпът спира още при следващата заявка на асистента.

  • Токените за достъп са валидни 15 минути; токените за подновяване са валидни 30 дни и се сменят при всяка употреба. Повторно използван токен за подновяване прекъсва тази конкретна връзка.
  • Трафикът от асистентите ви има собствен лимит от 100 заявки на 60 секунди: общ за всички асистенти, свързани с акаунта ви, и отделен от собствената ви работа в приложението.
  • Ако абонаментът на работното ви пространство е изтекъл, пак можете да прекъсвате връзки с асистенти; самите инструменти отказват, докато абонаментът не стане отново активен.

За собственици и администратори: превключвателят за работното пространство

Собственик или администратор на работното пространство може да изключи Разреши връзки с AI асистенти за цялото работно пространство от Настройки → Връзки (настолно приложение от версия 1.19.1, уеб приложение от 1.4.1). Изключването прекъсва незабавно всяка активна връзка в работното пространство, блокира новите влизания през конектора и изпраща имейл на засегнатите хора; членовете виждат известие, че функцията е изключена от администратор. Превключвателят е включен по подразбиране и важи за цялото работно пространство, а не за отделни хора.

Други MCP клиенти
Конекторът е тестван с Claude. Друг MCP клиент трябва да поддържа Streamable HTTP и OAuth 2.1 с PKCE и документи с метаданни за идентификатора на клиента (client ID metadata documents). TimerOS не поддържа динамична регистрация на клиенти, така че клиент, който познава само този по-стар метод, засега няма да се свърже.

Търсите API за разработчици, лични токени за достъп или уебхукове? Те са още в пътната карта: вижте Справочника за API за това докъде са стигнали нещата.