Търси документи
По период, доставчик, тип и диапазон на сумата, страница по страница.
Конектор за Claude и ChatGPT
Свържете InvoiceHub веднъж и питайте на естествен език: колко е фактурирал доставчик, кой клиент още ви дължи, кой договор изтича, кои документи са дублирани, какво е изтрито. Асистентът вижда само документите на вашата фирма и не може да променя нищо.
Свържете за 2 минутиИнструменти
Адрес на сървъраhttps://web.invoicehub.work/mcp
По период, доставчик, тип и диапазон на сумата, страница по страница.
Всички разчетени полета: номер, дати, суми и ДДС, издател, получател, IBAN и описание на услугите.
Вероятно дублираните документи и доставчиците, записани под различни имена.
Кои документи са изтрити като дубликати и какво е променено по издателите.
Кои обекти са качили месечния отчет от касовия апарат и кои още липсват.
Издадените и качените фактури, известия, проформи и оферти, какво още дължи всеки клиент и кое плащане е просрочено.
Договори, анекси и пълномощни: търсене и в текста им, срокове за изтичане и предизвестие и какво липсва. Поверителните документи остават скрити.
Само четене чрез MCP. Конекторът не качва, не издава, не променя и не изтрива документи. За издаване на фактури от друга система има отделен REST API с изрично разрешени права.
API ръководство: издаване на фактура, PDF и изпращане по имейл
Всички клиенти използват един и същ адрес. В Администрация → API ключове администраторът създава именуван ключ за конектора с право legacy:access. Ключът се показва само веднъж — запазете го в мениджър на пароли. Правата за издаване на фактури през REST API не дават MCP достъп.
https://web.invoicehub.work/mcp. Полетата за OAuth Client ID и Secret оставете празни.https://web.invoicehub.work/mcp и удостоверяване OAuth.Изпратете ключа като 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 се променят, а наличността на конекторите зависи от плана и правилата на работното пространство.
legacy:access, се анулират и OAuth токените на фирмата. Другите активни API ключове остават валидни. Създаването на допълнителен ключ не спира съществуващите връзки.MCP достъпът е за цялата фирма. Личните ограничения за видимост на фактури и продажби в браузъра не важат за legacy:access. Поверителните фирмени документи остават скрити. Разрешавайте това право само на хора с пълен достъп до счетоводството.
На практика
Асистентът сам избира инструмента и филтрите, а после обобщава, сравнява и смята върху намереното.
За каква сума са фактурите от БИЛЛА през май?
Извиках search_invoices за БИЛЛА и периода 01.05 – 31.05. Намерих 6 фактури за общо 64,82 € с ДДС; най-голямата е от 26 май за 15,49 €. Това са суми по документи, не потвърдени плащания.
| Инструмент | Параметри | Резултат |
|---|---|---|
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 ключове.
Клиентите откриват сървъра чрез /.well-known/oauth-protected-resource и /.well-known/oauth-authorization-server, регистрират се сами на /register, получават код на /authorize и токен на /token. Изисква се PKCE S256; кодовете за оторизация се пазят като хешове, важат пет минути и се използват еднократно. Токен се отнема на /oauth2/revoke.
Влезте, генерирайте ключ от „Администрация“ и задайте първия си въпрос.
Вход