Справочник

Свързване на 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Ще получите имейл, който потвърждава новата връзка. В него са името на асистента, достъпът му и откъде можете да прекъснете връзката.

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

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

Съобщенията, които асистентът публикува в чата, излизат от ваше име с означение „Изпратено чрез“ и името на асистента, например „Изпратено чрез Claude“. Всички в нишката, включително AI служителите, виждат това означение. Съобщенията достигат до AI служителите и ги събуждат точно като съобщение, написано от вас. Асистентът публикува от ваше име най-много 30 съобщения на час общо за всички ваши връзки. Ако сте свързали асистента си преди включването на чата, свържете го отново веднъж, за да добавите чата: направете го от самия асистент и одобрете страницата за съгласие, на която вече са посочени личните ви чатове с AI служители.

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

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

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

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

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

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

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

Инциденти и заявки за промяна

Инцидентите и заявките за промяна съдържат текст, написан от клиентите ви: заглавия, описания и коментари от портала. Затова, за разлика от останалите данни в работното ви пространство, за тях има отделна отметка на страницата за съгласие, която не зависи от избора между „само четене“ и „четене и запис“. Отметката е поставена по подразбиране. Оставете я, за да може асистентът да работи по инциденти и заявки за промяна, или я махнете, за да се свържете без тях, като запазите останалия достъп. Махането ѝ само намалява достъпа; нищо не може да добави достъп, който асистентът не е поискал. За четене на инциденти и заявки за промяна е нужна тази отметка. За промяна са нужни тази отметка и достъп за четене и запис, така че връзка само за четене може да ги чете, но не и да ги променя. Връзките, създадени преди да въведем тази отметка, нямат този достъп: прекъснете връзката от Настройки → Връзки и се свържете отново, за да го получите.

Асистентът работи само по инциденти и заявки за промяна, възложени на вас. Ако случаят е възложен на друг човек, асистентът не може да добавя бележки, да започва работа, да решава инцидента или да приключва заявката. Вместо това ви пита дали да го възложи на вас и никога не го възлага без вашето съгласие.

  • Възлагане и насочване: асистентът може да възложи случая на вас или на колега, когото посочите. Можете и да попитате асистента кой да го поеме. Той взема предвид екипите, длъжностите, нивото, уменията, езиците и колко отворени случая има всеки, предлага един човек с кратка обосновка и възлага едва след като се съгласите. В плана Freelancer няма екипи, затова взема предвид само хората.
  • Кой научава: при възлагане на заявка за промяна известие получават новият изпълнител, предишният и всеки активен член на възложения екип, в приложението и по имейл. При възлагане на инцидент известие получава само новият отговорник. Клиентът вижда името му в портала.
  • Започване на работа: асистентът може да премести инцидент или вече одобрена заявка за промяна в статус „В процес“. При клиентски случай клиентът научава, че работата е започнала (при инцидент само първия път). Заявка, която още е чернова или чака одобрение, не може да бъде започната.
  • Бележките остават вътрешни: бележка, която асистентът добавя по случая, е вътрешна бележка. Клиентът никога не я вижда.

Решаването на инцидент и приключването на заявка за промяна минават само през план, който вие одобрявате. Планът показва какво ще се запише, какво ще види клиентът, какво ще се изпрати по имейл и дали може да се отмени. Асистентът го прилага в отделна стъпка, след като се съгласите. При решаване бележките ви за решението и първопричината се публикуват в портала на клиента и той получава имейл с вашето фирмено оформление с молба да потвърди решението или да отвори инцидента отново. Повторното отваряне отменя решението. При приключване на заявка за промяна се публикуват бележките ви за изпълнението и се изпраща имейл „приключено“. Асистентът не може да отмени напълно приключването на заявката.

Какво става с фактурирането
Нито едно от двете действия не създава фактура. Решаването на инцидент не фактурира нищо; планът само казва дали инцидентът влиза в списъка с нефактурирана поддръжка, за да бъде фактуриран по-късно. Приключването на заявка за промяна по клиентски случай записва часовете, по които по-късно може да се издаде фактура за поддръжка: часовете, които въведете, или времето от започването на заявката. Самото действие не фактурира нищо и не се изчислява никаква сума, защото асистентът не вижда ставките ви.

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

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

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

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