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

A Frihet MCP szerver v1.2.1 három főbb funkcióval bővül: MCP erőforrások, beépített promptok és strukturált JSON-kimenet. Ez a frissítés az MCP-szerveren alapuló automatizálásokat hatékonyabbá teszi, és megnyitja az utat a fejlettebb AI-ügynök integrációkhoz.

Mi az az MCP erőforrás?

Az MCP protokoll két fő csatornát definiál az AI-ügynök és a szoftver között:

Eszközök (Tools): Parancsok, amelyeket az ügynök végrehajt – “Hozz létre számlát”, “Listázd a kiadásokat”. A Frihet MCP 55 eszközt tartalmaz.

Erőforrások (Resources): Dokumentumok és kontextus, amelyeket az ügynök olvashat – strukturált leírások, amelyek segítik az ügynököt a döntéshozatalban. Ez az újdonság.

Az 5 új erőforrás

1. frihet://context/business-profile A vállalkozás általános profilja: név, adószám, tevékenység-típus, ÁFA-regime, alapértelmezett fizetési feltételek. Az ügynök ezt olvassa be, ha a vállalkozás kontextusát kell érteni.

2. frihet://context/tax-configuration Az aktív adókonfiguráció: ÁFA vagy IGIC, alapértelmezett kulcsok, különleges mentességek, EU OSS státusz. Az ügynök erre hivatkozik adókezelésnél.

3. frihet://context/invoice-series Az aktív számlasorozatok és az aktuális számozási állapot. Az ügynök ez alapján tudja, milyen prefixekkel és milyen folytatásos számmal kell számlákat létrehozni.

4. frihet://context/payment-methods Konfigurált fizetési módok és banki adatok. Számlakészítésnél az ügynök a helyes fizetési adatokat illeszti be.

5. frihet://context/customer-payment-behavior Összesített fizetési viselkedési adat ügyfelekre lebontva: átlagos fizetési késedelem, lejárt számlák aránya, legutóbbi fizetések. Az ügynök ezt emlékeztető-stratégiák személyre szabásához használja.

Az 5 beépített prompt

Az MCP promptok az ügynöknek nyújtott kész utasítás-sablonok – kontextussal előre töltve. Ahelyett, hogy az ügynöknek minden alkalommal összerakná a kérdést, a prompt struktúrált formátumban adja az elemzési keretet.

1. invoice-summary Havi vagy negyedéves számla-összefoglalót generál: kibocsátott számla darabszám, összérték, fizetett vs. kifizetetlen arány, átlagos fizetési idő.

Használat: “Készíts összefoglalót a március havi számlázásomról” → az ügynök a invoice-summary promptot aktiválja.

2. expense-report Kiadásjelentés kategóriánkénti bontásban, adókulcs-összesítéssel és az előző időszakhoz való összehasonlítással.

3. cashflow-analysis Cashflow-elemzés 30/60/90 napos horizontra: várható bevételek (kiadatlan számlák), tervezett kiadások (ismétlődők), nettó pénzügyi pozíció.

4. overdue-followup Lejárt számlák elemzése és emlékeztető-stratégia javaslata: melyik ügyfélnek kell sürgős vs. barátságos emlékező, az előzmény fizetési viselkedés alapján.

5. financial-health-check Átfogó pénzügyi egészségvizsga: margin, bevételi trend, kiadási arány, adókötelezettség becslés, kockázati jelzők.

Strukturált JSON-kimenet

Az eddigi MCP-válaszok szöveges formátumban érkeztek – jó a Claude-nak, de nehézkesebb az automatizálási eszközökben.

A v1.2.1 minden eszköznél opcionálisan kérhető strukturált JSON-válasz a structured_output: true paraméterrel:

// Kérés: list_invoices structured_output: true
{
  "invoices": [
    {
      "id": "inv_001",
      "number": "FRI-2026-001",
      "customer_name": "Acme Kft.",
      "amount": 500000,
      "currency": "HUF",
      "status": "overdue",
      "due_date": "2026-03-01",
      "days_overdue": 15
    }
  ],
  "summary": {
    "total_count": 1,
    "total_amount": 500000,
    "overdue_count": 1
  }
}

Ez a formátum közvetlen feldolgozást tesz lehetővé n8n-ben (JSON-csomópontokkal), Zapierben (mezőkivonással) és más automatizálási platformokon.

Teljesítményjavítások

A v1.2.1 több belső optimalizálást is tartalmaz:

• API-hívások batching-ja: Ha egyszerre kér az ügynök számlát és ügyfél-adatot ugyanarról a tranzakcióról, a szerver egy kérésbe vonja össze
• Kapcsolat-pooling: Az újraauthentikálás csökkentve, különösen intenzív használatnál
• Timeout kezelés: Javított logika nagy adatmennyiségnél (100+ számla listázásakor)

Frissítés

Az npx-alapú telepítés automatikusan a legújabb verziót futtatja:

npx @frihet/mcp-server

Globális telepítésnél:

npm update -g @frihet/mcp-server

A konfiguráció (API-kulcs, szerver-beállítások) változatlan marad a frissítés után.

Kompatibilitás

A v1.2.1 visszafelé kompatibilis. Meglévő integrációk (Claude Code, Cursor, Windsurf, n8n) változtatás nélkül működnek. Az új funkciók (erőforrások, promptok, strukturált kimenet) opcionálisan aktiválhatók.

A teljes változásnapló és a frissített API-dokumentáció a docs.frihet.io/developers/mcp oldalon érhető el.