InvoiceHub Вход

Конектор за Claude и ChatGPT

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

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

Свържете за 2 минутиИнструменти

Адрес на сървъраhttps://web.invoicehub.work/mcp

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

Търси документи

По период, доставчик, тип и диапазон на сумата, страница по страница.

Отваря документ

Всички разчетени полета: номер, дати, суми и ДДС, издател, получател, IBAN и описание на услугите.

Открива дубликати

Вероятно дублираните документи и доставчиците, записани под различни имена.

Показва историята

Кои документи са изтрити като дубликати и какво е променено по издателите.

Следи касовите отчети

Кои обекти са качили месечния отчет от касовия апарат и кои още липсват.

Следи продажбите

Издадените и качените фактури, известия, проформи и оферти, какво още дължи всеки клиент и кое плащане е просрочено.

Чете фирмените документи

Договори, анекси и пълномощни: търсене и в текста им, срокове за изтичане и предизвестие и какво липсва. Поверителните документи остават скрити.

Само четене чрез MCP. Конекторът не качва, не издава, не променя и не изтрива документи. За издаване на фактури от друга система има отделен REST API с изрично разрешени права.

API ръководство: издаване на фактура, PDF и изпращане по имейл

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

Всички клиенти използват един и същ адрес. В Администрация → API ключове администраторът създава именуван ключ за конектора с право legacy:access. Ключът се показва само веднъж — запазете го в мениджър на пароли. Правата за издаване на фактури през REST API не дават MCP достъп.

OAuth · препоръчано

Claude (claude.ai и Claude Desktop)

  1. Отворете Settings → Connectors и изберете Add custom connector.
  2. Въведете име InvoiceHub и адрес https://web.invoicehub.work/mcp. Полетата за OAuth Client ID и Secret оставете празни.
  3. Натиснете Connect и поставете API ключа на страницата за одобрение на InvoiceHub.
OAuth · режим за разработчици

ChatGPT

  1. Включете Developer mode в настройките на ChatGPT.
  2. Създайте нов конектор с адрес https://web.invoicehub.work/mcp и удостоверяване OAuth.
  3. Одобрете достъпа на страницата на InvoiceHub с API ключа.
API ключ в заглавка

Claude Code и инструменти за разработчици

Изпратете ключа като bearer токен:

claude mcp add --transport http invoicehub https://web.invoicehub.work/mcp \
  --header "Authorization: Bearer $INVOICEHUB_API_KEY"

Cursor, VS Code и MCP SDK-тата приемат същата настройка:

{
  "mcpServers": {
    "invoicehub": {
      "type": "http",
      "url": "https://web.invoicehub.work/mcp",
      "headers": { "Authorization": "Bearer sk-…" }
    }
  }
}

Имената на менютата в Claude и ChatGPT се променят, а наличността на конекторите зависи от плана и правилата на работното пространство.

Одобрявате веднъж, спирате по всяко време

MCP достъпът е за цялата фирма. Личните ограничения за видимост на фактури и продажби в браузъра не важат за legacy:access. Поверителните фирмени документи остават скрити. Разрешавайте това право само на хора с пълен достъп до счетоводството.

На практика

Питайте на естествен език

Асистентът сам избира инструмента и филтрите, а после обобщава, сравнява и смята върху намереното.

  • „За каква сума са фактурите от БИЛЛА през май?“
  • „Покажи фактурите над 1000 € за третото тримесечие.“
  • „Има ли дублирани фактури и коя да запазя?“
  • „Кои доставчици са записани под различни имена?“
  • „Какво е изтрито като дубликат този месец?“
  • „Кои обекти още не са качили касовия отчет за септември?“
  • „Кои клиенти ни дължат и колко от това е просрочено?“
  • „Колко сме фактурирали през септември?“
  • „Кой договор изтича скоро и до кога трябва да дадем предизвестие?“
Пример за разговор

За каква сума са фактурите от БИЛЛА през май?

Извиках search_invoices за БИЛЛА и периода 01.05 – 31.05. Намерих 6 фактури за общо 64,82 € с ДДС; най-голямата е от 26 май за 15,49 €. Това са суми по документи, не потвърдени плащания.

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

MCP клиенти Claude ChatGPT друг MCP клиент Bearer API ключ или OAuth 2.1 + PKCE InvoiceHub · /mcp проверка на токена search_invoices get_invoice duplicate_invoices issuer_names invoice_audit_log issuer_audit_log cash_register_reports search_sales_documents get_sales_document sales_report search_company_documents get_company_document get_company_document_text company_document_checks фирмата от токена само четене Данни на фирмата фактури издатели суми и ДДС касови отчети продажби фирмени документи
Клиентът изпраща заявка с bearer токен. InvoiceHub извлича фирмата от самия токен, изпълнява инструмента върху нейните документи и връща резултата. Идентификаторът на фирмата никога не идва от текста на разговора.

Инструменти

Инструментите, които MCP сървърът обявява. Всички са отбелязани като само за четене, затова Claude може да ги изпълнява без потвърждение при всяко извикване.
ИнструментПараметриРезултат
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 без параметри Указателят на контрагентите — доставчици и клиенти — с ролята на всеки (supplier, client или both), изписванията и броя документи (покупки и продажби), и групите доставчици под различни имена, предложени за обединяване — от страница „Доставчици“
invoice_audit_log limit (по подразбиране 50, максимум 200) Историята на изтритите дубликати: запазения документ, изтритите документи така, както са били записани, и премахнатите обекти от хранилището — таблицата „История“ от страница „Дублиращи се документи“
issuer_audit_log limit (по подразбиране 50, максимум 200) Историята на обединяванията, преименуванията, премахванията и връщанията: стандартът, променените документи със стойностите преди и след, добавените и премахнатите правила и дали записът още може да се върне — таблицата „История“ от страница „Издатели — стандартни имена“
cash_register_reports month (YYYY-MM, по подразбиране изтеклият месец) Всеки обект със статус качен или липсващ отчет. За всеки отчет: total_amount (общата сума с ДДС от отчета на касовия апарат), vat_amount (ДДС в нея по стандартната ставка, или „0.00“, ако фирмата не е с пълна регистрация по ДДС) и currency (EUR), файловете (име, тип, размер), кога и от кого е качен и доставката към Google Drive — месецът от страница „Касови отчети“. Сумите са null за отчети, качени преди да се записват. Самите снимки не се връщат.
search_sales_documents date_from, date_to (ISO дата на издаване), kind, status (draft, issued или cancelled), client (име, ЕИК или ДДС номер), number, page (по подразбиране 1), per_page (по подразбиране 20, максимум 100) Документите за продажба — фактури, известия, проформи, оферти, протоколи и разписки, издадени в приложението или качени — с неплатената сума на всеки, totals на издадените фактури и известия (кредитните известия се изваждат) и pagination — списъкът от страница „Продажби“
get_sales_document document_id Един документ за продажба с редовете, адреса на клиента, бележките, свързаните документи, известията към него и неплатената сума, или съобщение, че не е намерен
sales_report report (documents, offers или receipts, по подразбиране documents), date_from, date_to (по подразбиране от 1 януари до днес), client, unpaid_only (само за documents), page, per_page (по подразбиране 20, максимум 100) Справката от страница „Справки за продажбите“: издадените и анулираните документи за периода със сумите (кредитните известия с минус) и неплатеното, totals за целия период и owed — колко се дължи днес, колко е просрочено и петимата клиенти с най-голям дълг
search_company_documents query (до 200 знака, търси и в текста), doc_type, status (active по подразбиране, expired, terminated, archived или all), page (по подразбиране 1), per_page (по подразбиране 20, максимум 50) Фирмените документи с вид, заглавие, контрагент, дати, подновяване, предизвестие, стойност, версии и напомняния, откъсите от текста, които съвпадат с търсенето, и pagination — от страница „Фирмени документи“. Поверителните документи не се показват.
get_company_document document_id Един фирмен документ с версиите и напомнянията му, без правата за достъп, или съобщение, че не е намерен
get_company_document_text document_id, version (по подразбиране последната), page_from (по подразбиране 1), page_limit (по подразбиране 10, максимум 20) Текстът на поредица страници от версията и next_page_from за следващата поредица. Всяко прочитане се записва в историята на документа.
company_document_checks без параметри Проверките от страница „Фирмени документи“ и от началната страница: срокове за изтичане и за предизвестие до 30 дни, липсващ подписан екземпляр или контрагент, анекс без договор, фактури над стойността по договора и контрагенти без задължителен договор — с key, due и document_id

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

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

Често задавани въпроси

Може ли асистентът да променя или изтрива документи?

Не. MCP инструментите само четат. Прочитането на текста на фирмен документ се записва в историята му. Издаване на фактури от външна система е възможно чрез отделния REST API с ключ с необходимите права, а не през този конектор.

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

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

Имам няколко фирми. Как да ги свържа?

Всеки ключ и всяка връзка обслужват една фирма. За друга фирма се свържете с нейния API ключ.

Какво получава асистентът от моите данни?

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

Как да прекъсна връзката?

Премахнете конектора от настройките на асистента. В Администрация → API ключове отнемете или сменете използвания ключ. Отнемане, смяна или премахване на legacy:access анулира OAuth токените на фирмата, но не спира другите активни bearer ключове.

Технически подробности за OAuth

Клиентите откриват сървъра чрез /.well-known/oauth-protected-resource и /.well-known/oauth-authorization-server, регистрират се сами на /register, получават код на /authorize и токен на /token. Изисква се PKCE S256; кодовете за оторизация се пазят като хешове, важат пет минути и се използват еднократно. Токен се отнема на /oauth2/revoke.

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

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

Вход