MCP · Model Context Protocol
Köss egy AI-asszisztenst a cégedhez
A facturifirma egy MCP-szervert biztosít streamelt HTTP-n keresztül. Bármelyik kompatibilis kliens (Claude, Claude Code, más ügynökök) számlákat állíthat ki, elküldheti azokat az SPV-be, kezelheti az ügyfeleket és riportokat generálhat közvetlenül a beszélgetésből.
Mi az MCP-kapcsolat
Az MCP (Model Context Protocol) egy nyílt szabvány, amellyel egy AI-asszisztens meghívhatja egy alkalmazás által kínált eszközöket (tools). A facturifirma-kapcsolat teljes olvasási/írási hozzáférést biztosít a cégeidhez, dokumentumaidhoz, ügyfeleidhez és riportjaidhoz, ugyanazokkal az üzleti szabályokkal, mint az alkalmazás és az API.
Végpont
Streamelt HTTP MCP-szerver, az alábbi címen érhető el.
https://app.facturifirma.ro/mcp Hitelesítés
1. lehetőség — OAuth (ajánlott claude.ai / ChatGPT esetén)
Azoknál a klienseknél, amelyek nem tudnak egyéni Authorization fejlécet küldeni (claude.ai webes konnektorok, ChatGPT), a hitelesítés a böngészőben történik, OAuth 2.1 használatával.
- 1. A claude.ai-ban: nyisd meg a Beállítások → Connectors menüt és kattints az „Add custom connector” gombra.
- 2. Adj neki nevet (pl. „facturifirma”), illeszd be a https://app.facturifirma.ro/mcp címet és kattints az „Add” gombra.
- 3. Kattints a „Connect” gombra az új konnektornál — átirányítunk a facturifirma bejelentkezéshez (ha még nem vagy bejelentkezve).
- 4. Kattints az „Engedélyezés” gombra a jóváhagyási képernyőn. Visszatérsz a claude.ai-ba, a konnektor „Connected” — nincs szükség client ID-ra vagy secretre.
https://app.facturifirma.ro/mcp 2. lehetőség — API-kulcs (Bearer)
Azoknál a klienseknél, amelyek egyéni fejléceket tudnak küldeni (Claude Code, Claude Desktop, más ügynökök), használj API-kulcsot Bearer fejlécként.
- 1. Hozz létre egy API-kulcsot az alkalmazásban: Beállítások → API-kulcsok.
- 2. Küldd el a kulcsot Authorization: Bearer <API_KULCS> fejlécként minden kéréssel.
- 3. Állítsd be az MCP-klienst (Claude Code, Claude Desktop stb.) az alábbi végponttal és fejléccel.
Claude Code (CLI)
claude mcp add --transport http facturifirma https://app.facturifirma.ro/mcp --header "Authorization: Bearer <API_KEY>" Általános konfiguráció (JSON)
{
"mcpServers": {
"facturifirma": {
"url": "https://app.facturifirma.ro/mcp",
"headers": {
"Authorization": "Bearer <API_KEY>"
}
}
}
} Elérhető eszközök
A szerver által kínált eszközök valós listája, terület szerint csoportosítva:
Számlázás és dokumentumok
Számlák, proformák és jóváíró számlák létrehozása, szerkesztése, kiállítása és beszedése.
list_documentscreate_invoiceupdate_invoiceissue_documentdelete_documentrecord_paymentreverse_invoiceconvert_proformalist_purchases ANAF e-Factura
Dokumentumok küldése az SPV-be, állapotuk követése és a beérkezett számlák importálása.
send_to_anafpoll_efacturasync_inboxlist_inboximport_inbox Cégek
A fiókodhoz tartozó cégek listázása és kezelése.
list_companiescreate_companyget_companyupdate_company Ügyfelek
Egy cég ügyfeleinek (partnereinek) létrehozása és kezelése.
list_clientscreate_clientget_clientupdate_clientdelete_client Beszállítók
Egy cég beszállítóinak (akiktől vásárolsz) létrehozása és kezelése.
list_suppliersget_suppliercreate_supplierupdate_supplierdelete_supplier Kiadások
Beszállítói kiadások rögzítése és kezelése.
list_expensescreate_expenseupdate_expensedelete_expense Ismétlődő számlák
Sablonok létrehozása, amelyek meghatározott ütemezés szerint automatikusan számlatervezeteket generálnak.
list_recurringcreate_recurringupdate_recurringdelete_recurring Bankszámlák
Egy cég, ügyfél vagy beszállító bankszámláinak listázása és cseréje.
list_bank_accountsreplace_bank_accounts Nyilvános ANAF-adatok
Román cég keresése CUI alapján (név, cím, áfa-/e-Factura státusz).
lookup_company Katalógus és műveletek
Termékek, raktárak és számozási sorozatok.
list_productscreate_productget_productupdate_productdelete_productlist_warehousescreate_warehouseupdate_warehousedelete_warehouselist_seriescreate_seriesupdate_seriesdelete_series Riportok
Értékesítési napló, áfa-riport és bankegyeztetés.
sales_journalvat_reportreconcile_bank Beállítások
A bérlő konfigurációjának olvasása és frissítése.
get_settings_schemaget_settingsupdate_settings Biztonság
Az API-kulcs a fiókodhoz (bérlőhöz) kötött, és bármikor visszavonható a Beállítások → API-kulcsok menüben. Minden MCP-hívás ugyanazokkal a jogosultságokkal fut, mint amilyenekkel a kulcsot létrehozó felhasználó rendelkezik — semmi több.
Készen állsz egy AI-asszisztens összekapcsolására?
Hozz létre egy API-kulcsot az alkalmazásban, és add hozzá a kedvenc MCP-klienshez.
Alkalmazás megnyitása