MCP Szerver v1.2: erőforrások, promptok és strukturált kimenet

A Frihet MCP szerver 1.2.1-es verziója nem további eszközöket ad hozzá. Intelligenciát ad hozzá. Erőforrásokat (Resources), hogy az ügynökök adóügyi kontextussal rendelkezzenek anélkül, hogy kérdeznének. Promptokat (Prompts), hogy teljes munkafolyamatokat hajtsanak végre beavatkozás nélkül. Strukturált kimenetet (Output), hogy minden válasz determinisztikusan feldolgozható legyen.

Ez a frissítés az MCP szervert a CRUD műveletek hídjából egy teljes értékű üzleti menedzsment interfésszé alakítja át az IA ügynökök számára.

Erőforrások (Resources): mindig elérhető referenciaadatok

Az MCP Erőforrások (Resources) statikus adatok, amelyeket az ügynök bármikor elolvashat anélkül, hogy API-hívásokat indítana a Frihet felé. Nem fogyasztanak kvótát, nem igényelnek további hitelesítést, és azonnal elérhetőek a szerver csatlakozásától kezdve.

Az v1.2 5 erőforrást (resources) vezet be:

frihet://api/schema

Összefoglalás az összes elérhető végpontról, hitelesítési módszerről és sebességkorlátról. Amikor egy ügynöknek tudnia kell, mit tehet a Frihet-tel, ezt az erőforrást (resource) kérdezi le, ahelyett, hogy próbálgatással fedezné fel.

frihet://tax/rates

Spanyolországban érvényes adókulcsok: általános ÁFA (21%), csökkentett (10%) és szupercsökkentett (4%); Kanári-szigeteki IGIC (7%, 3%, 0%); IRPF visszatartások. Az ügynök rendelkezik ezzel a kontextussal, mielőtt számlát hozna létre vagy kiadást rögzítene. Nem kell megkérdeznie tőled, milyen ÁFA-t kell alkalmazni, ha már tudja, hol működik a vállalkozásod.

frihet://tax/calendar

Negyedéves bevallások benyújtási dátumai: 303-as modell (ÁFA), 130-as modell (IRPF), 420-as modell (IGIC). Amikor az ügynök negyedéves zárást készít, pontosan tudja, mikor esedékes az egyes kötelezettségek.

frihet://config/expense-categories

A 8 kiadási kategória az elszámolhatósági szabályaival. Irodaszer, ellátmány, szállítás, napidíjak, képzés, biztosítások, szakmai szolgáltatások, egyéb. Minden kategória tartalmazza az elszámolhatóság százalékát és az alkalmazandó feltételeket.

frihet://config/invoice-statuses

Egy számla állapotainak folyamata: piszkozat, kiállított, elküldött, beszedett, lejárt, érvénytelenített. Minden állapot tartalmazza az engedélyezett átmeneteket és az aktiválható triggereket (webhooks, értesítések). Az ügynök tudja, mely műveletek érvényesek az adott pillanatban.

Promptok (Prompts): vezetett munkafolyamatok

Egy Eszköz (Tool) végrehajt egy műveletet. Egy Prompt több műveletet szervez koherens munkafolyamatba. A különbség az, hogy a „hozd létre ezt a kiadást” helyett „feldolgozza ezt a 15 kiadási jegyet, kategorizálja őket, alkalmazza a megfelelő adókat és erősítse meg létrehozás előtt”.

Az v1.2 5 promptot tartalmaz:

monthly-close

Vezetett havi zárás. Az ügynök áttekinti a függőben lévő számlákat, kategorizálja a hozzá nem rendelt kiadásokat, ellenőrzi, hogy a időszak adókötelezettségei fedezve vannak-e, és összefoglalót készít. Egy olyan munkafolyamat, amely általában egy órás kézi felülvizsgálatot igényel, beszélgetésben végrehajtva.

onboard-client

Új ügyfél regisztrációja. Meghatározza az adókulcsot az ügyfél helyzete szerint (kontinentális ÁFA, Kanári-szigeteki IGIC, közösségen belüli), létrehozza a nyilvántartást a helyes adóadatokkal és egy üdvözlő ajánlatot generál. Minden egy sorozatban.

quarterly-tax-prep

Negyedéves adóelőkészítés. Összegyűjti az időszak összes számláját, kiszámítja az ÁFA vagy IGIC adóalapjait, alkalmazza az IRPF levonásokat és generál egy előnézetet a 303-as vagy 130-as modellről. Az ügynök végzi a munkát; te vagy a könyvelőd érvényesíti az eredményt.

overdue-followup

Lejárt számlák nyomon követése. Azonosítja az összes lejárt számlát, csoportosítja őket ügyfél szerint, kiszámítja az egyes ügyfelek teljes függőben lévő összegét és személyre szabott beszedési üzeneteket fogalmaz meg. A „meg kell néznem, ki mit tartozik nekem” helyett „itt vannak a küldésre kész piszkozatok”.

expense-batch

Tömeges kiadásfeldolgozás. Kap egy listát a kiadásokról, kategorizálja őket a beállított szabályok szerint, alkalmazza a megfelelő adókat, ellenőrzi mindegyik elszámolhatóságát és előzetes megerősítéssel létrehozza őket. Ideális egy hét vagy egy utazás felhalmozott jegyeinek feldolgozására.

Strukturált kimenet: feldolgozható válaszok

Eddig az MCP szerver válaszai formázott szövegek voltak. Hasznos emberi olvasáshoz, de az ügynököknek strukturált adatokra van szükségük a programozott döntések meghozatalához.

Az v1.2 hozzáadja az outputSchema-t és a structuredContent-et minden eszközhöz. Minden válasz tartalmaz egy JSON sémát, amely pontosan leírja a visszaadott adatok struktúráját. Az ügynök még a hívás előtt tudja, milyen mezőket fog kapni, milyen típusúak és melyek opcionálisak.

Ez teszi lehetővé, hogy egy prompt, mint a quarterly-tax-prep, megbízhatóan láncoljon össze 4 műveletet: minden lépés olyan adatokat eredményez ismert struktúrával, amelyet a következő lépés kétértelműség nélkül fogyaszthat.

Az MCP szerverre integrációkat építő fejlesztők számára ez kiküszöböli a szabad szöveg feldolgozásának szükségességét. A válasz mindig ugyanazt a formátumot követi.

Biztonsági annotációk

Az MCP szerver minden eszköze mostantól annotációkat tartalmaz, amelyek jelzik, hogy a művelet csak olvasható vagy destruktív. Egy list-invoices olvasási műveletként van jelölve. Egy delete-expense destruktívként van jelölve.

Ez lehetővé teszi az ügynökök számára, hogy megerősítési irányelveket vezessenek be. Egy ügynök kérdezés nélkül végrehajthat olvasási műveleteket, de explicit megerősítést kérhet adatok törlése vagy módosítása előtt. A biztonság nem az ügynöktől függ – a szerver határozza meg.

Univerzális telepítés

A szerver egyetlen paranccsal telepíthető bármely kompatibilis ügynökön:

npx @frihet/mcp-server

Működik Claude Code, Claude Desktop, Cursor, Windsurf, Cline, Codex és bármely MCP kliensben. Azoknak az ügynököknek, amelyek támogatják a telepítést a skill-eken keresztül:

npx skills add Frihet-io/frihet-mcp

Mindkét módszer hozzáférést biztosít a több mint 30 eszközhöz, az 5 erőforráshoz (resources), az 5 prompt-hoz és a strukturált kimenethez.

Repozitórium a Frihet-io alatt

Az MCP szerver átkerült a Frihet-io szervezetbe a GitHub-on. A repozitórium URL-je most github.com/Frihet-io/frihet-mcp. A korábbi linkek automatikusan átirányítanak.

Az npm csomag továbbra is @frihet/mcp-server. Nincsenek változások a telepítésben.

Kinek szól ez a frissítés

Szakemberek, akik már használják az MCP szervert automatikus adóügyi kontextusként Erőforrásokat (Resources) és Promptokat (Prompts) kapnak olyan munkafolyamatokhoz, amelyeket korábban manuálisan, lépésről lépésre hajtottak végre.

Fejlesztők, akik a Frihet-re építenek strukturált kimenetet kapnak a determinisztikus integrációkhoz és biztonsági annotációkat a megerősítési irányelvekhez.

Könyvelőirodák és adótanácsadók specifikus promptokat kapnak a munkafolyamataikhoz: havi zárás, negyedéves előkészítés, beszedések nyomon követése.

Bármely vállalkozás, amely IA ügynököket használ egy olyan MCP szervert kap, amely nem csak műveleteket hajt végre, hanem tudja, hogyan kell azokat valódi üzleti folyamatokba láncolni.

Hogyan kell frissíteni

Ha az npx @frihet/mcp-server parancsot használod, már a legújabb verzióval rendelkezel. Ha fix telepítésed van:

npm update @frihet/mcp-server

Nincsenek megszakító változások. Az összes létező eszköz megőrzi interfészét. Az Erőforrások (Resources), a Promptok (Prompts) és a strukturált kimenet tiszta kiegészítések.

A teljes dokumentáció a docs.frihet.io/desarrolladores címen található. A forráskód a GitHub-on (Frihet-io/frihet-mcp). A csomag az npm-en @frihet/mcp-server néven elérhető.