MCP връзка

Питайте ChatGPT или Claude за документите на фирмата

InvoiceHub публикува MCP сървър. Свързвате го веднъж в своя асистент и след това задавате въпроси на естествен език — асистентът вижда само документите на фирмата, която е издала достъпа.

Как се свързва Вход за API ключ

Как протича една заявка

Клиентът изпраща заявка с bearer токен. InvoiceHub извлича фирмата от самия токен, изпълнява инструмента върху нейните документи и връща резултата. Идентификаторът на фирмата никога не идва от текста на разговора.

Какво може и какво не може асистентът

Може

Търси документи по период, издател, тип и диапазон на сумите.
Отваря един документ с всички разчетени полета.
Показва вероятните дубликати, групите издатели с различни имена и зададените стандарти.
Чете историята на изтритите дубликати и на промените по издателите.
Обобщава, сравнява и изчислява върху намереното.
Работи паралелно с браузъра и REST API-то със същия ключ.

Не може

Да качва, променя, изтрива или записва документи — няма такива инструменти.
Да излиза извън фирмата на токена, дори ако бъде помолен.
Да чете документи на друга фирма през същия ключ.
Да заобиколи деактивиран ключ — достъпът спира веднага.

Свързване в три стъпки

Генерирайте API ключ
Администраторът на фирмата отваря Администрация → API ключ и генерира ключ. Показва се веднъж — съхранете го в мениджър на пароли. Всяка фирма има един активен ключ и може да го деактивира по всяко време.
Добавете сървъра в асистента
В ChatGPT или Claude добавете нов конектор/MCP сървър с адрес https://вашия-домейн/mcp. Клиентите, които поддържат OAuth, се регистрират сами и ще поискат потвърждение на достъпа с API ключа; останалите изпращат ключа като заглавка Authorization: Bearer sk-….
```
{
  "mcpServers": {
    "invoicehub": {
      "type": "http",
      "url": "https://вашия-домейн/mcp",
      "headers": { "Authorization": "Bearer sk-…" }
    }
  }
}
```
Питайте на естествен език
Асистентът сам избира инструмент и филтри. Примери: „Колко платихме на този доставчик през май?“, „Покажи фактурите над 1000 лв. за третото тримесечие“, „Дай ми пълните данни на фактура 1042“.

Инструменти

Шестте инструмента, които MCP сървърът обявява
Инструмент	Параметри	Резултат
`search_invoices`	`date_from`, `date_to` (ISO дата), `type`, `issuer`, `amount_min`, `amount_max`, `page` (по подразбиране 1), `per_page` (по подразбиране 20, максимум 100)	Списък документи и `pagination` с `page`, `per_page`, `total`, `total_pages`
`get_invoice`	`invoice_id`	Един документ на фирмата или съобщение, че не е намерен
`duplicate_invoices`	без параметри	Групи вероятни дубликати с редовете на всеки документ и препоръчания за запазване (`keep_id`) — предложенията от страница „Дублиращи се документи“
`issuer_names`	без параметри	Издатели, записани под различни имена, с брой документи и препоръчани име, ЕИК и ДДС номер, и зададените стандарти — предложенията и правилата от страница „Издатели — стандартни имена“
`invoice_audit_log`	`limit` (по подразбиране 50, максимум 200)	Историята на изтритите дубликати: запазения документ, изтритите документи така, както са били записани, и премахнатите обекти от хранилището — таблицата „История“ от страница „Дублиращи се документи“
`issuer_audit_log`	`limit` (по подразбиране 50, максимум 200)	Историята на обединяванията, преименуванията, премахванията и връщанията: стандартът, променените документи със стойностите преди и след, добавените и премахнатите правила и дали записът още може да се върне — таблицата „История“ от страница „Издатели — стандартни имена“

Всеки документ се връща с номер, тип, издател (име, ЕИК, ДДС номер), получател, сума без и с данък, валута, оригинална валута и суми, дата на издаване, начин на плащане, описание на услугите, IBAN и дата на постъпване в системата.

Сигурност и ограничения

Фирмата идва от токена. Всяка заявка се филтрира по customer_id, който се извлича от ключа или токена, а не от разговора.
OAuth 2.1 с PKCE S256. Кодовете за оторизация се пазят като хешове, важат пет минути и се използват еднократно.
Автоматично откриване. Клиентите четат /.well-known/oauth-protected-resource и /.well-known/oauth-authorization-server, откъдето получават адресите за регистрация (/register), оторизация (/authorize) и издаване на токен (/token).
Отнемане на достъпа. Деактивирането на ключа спира новите заявки, а издадените OAuth токени се обезсилват заедно с версията на токените на фирмата.
Лимит на заявките. 60 заявки на минута за всеки ключ, споделени с REST API-то.
Обхват на видимостта. Програмният достъп обхваща всички документи на фирмата — личните ограничения за видимост в браузъра не се прилагат за ключа, затова го давайте само на хора с пълен достъп до счетоводството.

Свържете асистента днес

Влезте, генерирайте ключ от „Администрация“ и задайте първия си въпрос.

Вход