Mi ez, és hogyan működik?
- Egy npm-csomag (
tacito-mcp), amely a te gépeden fut, és a TACITo nyilvános API-ját hívja a te API-kulcsoddal.
- Az asszisztens csak abban a cégben dolgozik, amelyhez a kulcs tartozik.
- A csomag ingyenes és nyílt forráskódú (MIT licenc). Az API-használat benne van a TACITo-előfizetésben, külön díja nincs.
- Alapbeállításban az asszisztens nem tud számlát kiállítani, csak piszkozatot készíteni.
Telepítés
- Hozz létre egy API-kulcsot a TACITo-ban: Beállítások → API kulcsok. Ha az asszisztens csak olvashat, elég egy „Olvasás” jogú kulcs. Piszkozathoz és kiállításhoz „Olvasás + írás” jogú kulcs kell; a csak „Írás” jogú nem elég.
- Add hozzá a szervert az MCP-kliensedhez: az egysoros telepítővel, vagy kézzel, az alábbi minták egyikével.
Egysoros telepítő (macOS, Linux)
Futtasd a terminálban. Megkérdezi az API-kulcsot és a módot, majd beállítja a szervert minden MCP-kliensben, amelyet a gépeden talál: Claude Code, Codex, Claude Desktop, Cursor.
curl -fsSL https://tacito.hu/mcp-szerver/install.sh | sh
A telepítő a tacito-mcp csomagot a saját mappádba teszi (~/.tacito-mcp), és a klienseknek ezt a példányt adja meg, teljes útvonallal. A kulcs egyetlen, csak általad olvasható fájlba kerül ugyanott; a kliensek beállításaiba és a parancssorba nem. A Claude Desktop és a Cursor beállításfájljáról előbb másolatot készít. Futtatás előtt elolvashatod; frissítéshez, más kulcshoz vagy más módhoz futtasd újra.
Kézi beállítás
Windowson, vagy ha magad állítanád be. A tacit_... helyére a saját kulcsodat írd.
Figyelem: az npx először abban a mappában keresi a csomagot, amelyben a kliens fut. Ha olyan projektmappát nyitsz meg, amelyben nem bízol, egy oda elhelyezett, tacito-mcp nevű csomag indulna el a kulcsoddal. Ilyenkor az egysoros telepítőt használd, vagy telepítsd a csomagot globálisan (npm install -g tacito-mcp), és a beállításban a parancs tacito-mcp legyen, npx nélkül.
Claude Desktop, Cursor
A kliens MCP-beállításfájljába (mcpServers):
{
"mcpServers": {
"tacito": {
"command": "npx",
"args": ["-y", "tacito-mcp"],
"env": { "TACITO_API_KEY": "tacit_...", "TACITO_MCP_MODE": "draft" }
}
}
}
Claude Code
claude mcp add tacito --env TACITO_API_KEY=tacit_... -- npx -y tacito-mcp
Codex
codex mcp add tacito --env TACITO_API_KEY=tacit_... -- npx -y tacito-mcp
Node.js 18 vagy újabb kell hozzá. A beállítások: TACITO_API_KEY (az API-kulcsod) és TACITO_MCP_MODE (a mód, lásd lent).
A három mód
A TACITO_MCP_MODE beállítás dönti el, mit tehet az asszisztens. Minden mód tartalmazza az előtte állókat.
read: csak olvas. Semmit nem hoz létre.
draft (alapbeállítás): olvas, és piszkozatot készít vagy töröl. A piszkozatnak nincs számlaszáma, nem megy a NAV-hoz, és törölhető. A számlát te állítod ki a TACITo felületén.
full: a piszkozatot ki is állíthatja. Ezt neked kell bekapcsolnod.
Eszközök
read módtól
get_readiness: kiállíthat-e most számlát a cég, és mely beállítások hiányoznak.
search_invoices: keresés a kimenő számlák és piszkozatok között (szöveg, állapot, fizetettség, NAV-állapot, dátum).
get_invoice: egy számla vagy piszkozat a tételeivel, a fizetettségével, a NAV-állapotával és a nyilvános linkjével.
lookup_company: magyar cég neve és címe adószám alapján.
get_exchange_rate: az MNB-árfolyam előnézete egy devizára és napra.
draft módtól
create_invoice_draft: számlapiszkozat készítése.
create_storno_draft: egy kiállított számla sztornójának elkészítése piszkozatként.
delete_invoice_draft: piszkozat törlése. Kiállított számla nem törölhető.
Csak full módban
issue_invoice: piszkozat kiállítása. Ez az egyetlen jogi hatású művelet. Az asszisztensnek meg kell adnia a jóváhagyott bruttó végösszeget; ha a piszkozat végösszege más, a szerver nem állít ki számlát. Ha a fiókodban be van kapcsolva az automatikus számlaküldés, a kiállított számlát a vevő e-mailben megkapja.
Biztonság
- A kiállított számla számlaszámot kap, a NAV-hoz kerül, és többé nem szerkeszthető és nem törölhető. Tesztmód nincs. Ezért az alapbeállítás nem enged kiállítást.
full módban a szerver arra utasítja az asszisztenst, hogy kiállítás előtt mutassa meg a piszkozatot, és kérje a jóváhagyásodat. Ez utasítás, nem garancia: állítsd be az MCP-kliensedet úgy, hogy a kiállítás előtt megerősítést kérjen.
- Ugyanarra a piszkozatra megismételt kiállítás nem hoz létre második számlát.
- Kiállított számlát sztornóval lehet érvényteleníteni: az asszisztens elkészíti a sztornó piszkozatát, és azt kell kiállítani.
- Az API-kulcsot a szerver csak a környezeti változóból olvassa, és minden válaszából és naplósorából eltávolítja.
- Az olvasó API-kulcs az erősebb korlát, mert azt a TACITo szervere tartatja be. A kulcs bármikor visszavonható.
- A kiállított számláért te felelsz, ugyanúgy, mint a kézzel kiállítottért.
Amit ez a változat nem tud
Módosító számla, díjbekérő, előlegszámla, fizetés rögzítése, e-mail küldése, PDF letöltése, bejövő számlák, partnerek, termékek és beállítások. Ezekhez a TACITo felületét vagy az API-t használd.
Kapcsolódó oldalak