f facturifirma

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. 1. A claude.ai-ban: nyisd meg a Beállítások → Connectors menüt és kattints az „Add custom connector” gombra.
  2. 2. Adj neki nevet (pl. „facturifirma”), illeszd be a https://app.facturifirma.ro/mcp címet és kattints az „Add” gombra.
  3. 3. Kattints a „Connect” gombra az új konnektornál — átirányítunk a facturifirma bejelentkezéshez (ha még nem vagy bejelentkezve).
  4. 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. 1. Hozz létre egy API-kulcsot az alkalmazásban: Beállítások → API-kulcsok.
  2. 2. Küldd el a kulcsot Authorization: Bearer <API_KULCS> fejlécként minden kéréssel.
  3. 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

← Vissza a főoldalra