FleetQ може да даде на вашия AI асистент достъп до данните на кантората. Връзката минава през отворения протокол MCP (Model Context Protocol). След като се свържете, питате асистента на естествен език, например „покажи оборотната ведомост за октомври“, и той взима данните директно от FleetQ.
Достъпът е само за четене. Асистентът може да преглежда и анализира данни, но не може да създава, променя или изтрива нищо.
Какво е MCP
MCP е отворен стандарт, с който AI асистентите се свързват с външни системи. FleetQ работи като MCP сървър на адрес https://<домейн>/api/mcp. Асистентът вижда набор от инструменти (справки за фирми, фактури, банка, счетоводство и др.) и сам решава кой да извика според въпроса ви.
Стъпка 1: Създайте токен
- Отворете Настройки → Интеграции (
/app/settings/integrations). - В картата MCP API (AI управление) натиснете „Генерирай токен“.
- Копирайте токена веднага. Той се показва само веднъж и не може да бъде възстановен по-късно.
Какво трябва да знаете за токена:
- валиден е 90 дни, след това трябва да създадете нов;
- създаването на нов токен („Нов токен“) анулира стария, така че обновете и настройките на асистента;
- бутонът „Отмени всички токени“ анулира наведнъж всички ваши MCP токени за текущата кантора (ако работите с няколко кантори, повторете го във всяка от тях);
- токенът дава достъп само до данните на кантората, за която е създаден.
Стъпка 2: Адрес и заглавка за удостоверяване
Асистентът се нуждае от две неща:
- адрес (endpoint):
https://<домейн>/api/mcp, точният адрес е показан в картата MCP Endpoint в настройките; - заглавка (header):
Authorization: Bearer <ВАШИЯТ_ТОКЕН>.
Стъпка 3: Свържете клиента
Claude Desktop
В картата в настройките има готова конфигурация в раздела „Свържи своя AI за 3 стъпки“. Копирайте я и я поставете в конфигурационния файл на Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"fleetq": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://<домейн>/api/mcp",
"--header",
"Authorization: Bearer <ВАШИЯТ_ТОКЕН>"
]
}
}
}
Заменете <ВАШИЯТ_ТОКЕН> с токена от стъпка 1 (ако копирате конфигурацията веднага след генерирането, той вече е попълнен). След това рестартирайте Claude Desktop. FleetQ ще се появи като източник на инструменти. За командата npx е нужен инсталиран Node.js.
ChatGPT и други клиенти
Всеки клиент, който поддържа отдалечени (remote) MCP сървъри с Bearer заглавка, може да се свърже с FleetQ. Начинът на добавяне зависи от клиента и неговата версия, а менютата често се променят. Потърсете в настройките на клиента раздел за MCP сървъри, конектори или инструменти и въведете:
- адреса
https://<домейн>/api/mcp; - заглавката
Authorization: Bearer <ВАШИЯТ_ТОКЕН>.
Ако клиентът поддържа само локални MCP сървъри, използвайте mcp-remote както в примера за Claude Desktop.
Какво може асистентът
С токен само за четене асистентът използва режимите за преглед на инструменти като:
company_manage: фирмите на кантората;counterparty_manage: контрагенти и търсене по име или ЕИК;invoice_manage: издадени и получени фактури;document_manage: качени документи;banking_manage: банкови сметки, движения и обобщения;accounting_manage: журнал, салда по сметки, оборотна ведомост, сметкоплан;report_manage: оборотна ведомост, отчет за приходи и разходи, баланс, ДДС справка, вземания и задължения, паричен поток, падежи;compliance_manage: предстоящи срокове и обобщение по ДДС;payroll_manage: служители и ведомости за заплати;hr_manage: служители, отпуски, наличен отпуск и трудови договори.
Данните са ограничени до кантората, за която е издаден токенът. Повече за обработката на данни вижте в Данни и поверителност.
Какво не може асистентът
Токенът, създаден от настройките, е само за четене. Ако асистентът опита да създаде, промени или изтрие нещо (например да издаде фактура или да осчетоводи документ), сървърът отказва заявката с грешка 403 (read_only_token). Нищо в данните ви не се променя.
За автоматизирана работа вътре в системата използвайте вградените AI агенти.
Сигурност
- Пазете токена като парола. Не го споделяйте и не го публикувайте в чатове, имейли или хранилища с код.
- Ако токенът попадне в чужди ръце, веднага натиснете „Отмени всички токени“ в кантората, за която е създаден, и генерирайте нов.
- Токенът изтича автоматично след 90 дни.
Примерни въпроси
- „Покажи оборотната ведомост за миналия месец за фирма Х.“
- „Кои фактури са неплатени, групирани по контрагент?“
- „Колко е ДДС за внасяне за текущия период?“
- „Какви срокове предстоят през следващите две седмици?“
- „Обобщи банковите движения по сметката за последните 30 дни.“