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`	Един документ на фирмата или съобщение, че не е намерен

Всеки документ се връща с номер, тип, издател (име, ЕИК, ДДС номер), получател, сума без и с данък, валута, оригинална валута и суми, дата на издаване, начин на плащане, описание на услугите, 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-то.
Обхват на видимостта. Програмният достъп обхваща всички документи на фирмата — личните ограничения за видимост в браузъра не се прилагат за ключа, затова го давайте само на хора с пълен достъп до счетоводството.

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

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

Вход