Frihet MCP Server v1.2.1: Resurse, Prompturi și Output Structurat

Frihet MCP Server v1.2.1 este disponibil pe npm. Aceasta este cea mai semnificativă actualizare de la lansare, adăugând trei capabilități fundamentale ale protocolului MCP care anterior nu erau implementate: resurse, prompturi și output structurat.

Ce era și ce adaugă v1.2.1

Versiunea anterioară (v1.1.x) expunea 31 de instrumente pentru operații CRUD: crea facturi, citea cheltuieli, actualiza clienți. Funcțional și util, dar limitat la operații discrete inițiate de utilizator.

v1.2.1 adaugă:

• Resurse — datele afacerii tale accesibile ca fluxuri de date live
• Prompturi — șabloane reutilizabile pentru operațiuni complexe
• Output structurat — răspunsuri JSON tipizate pentru integrări robuste

Resurse: datele afacerii ca fluxuri live

Resursele MCP sunt URI-uri pe care agenții AI le pot citi pentru a obține date în timp real fără a efectua apeluri active de instrumente.

Resursele disponibile în v1.2.1:

frihet://invoices/pending          — Facturi neîncasate (live)
frihet://invoices/overdue          — Facturi cu scadența depășită (live)
frihet://expenses/uncategorized    — Cheltuieli fără categorie (live)
frihet://clients/at-risk           — Clienți cu model de plată tardivă (live)
frihet://cashflow/forecast         — Previziune flux numerar 30/60/90 zile (live)
frihet://dashboard/kpis            — KPI-uri principale ale afacerii (live)

Cum diferă resursele de instrumente:

Instrumentele sunt acțiuni: „creează factura”, „actualizează clientul”. Resursele sunt stare: „ce facturi sunt în așteptare acum?”.

Un agent care monitorizează afacerea poate citi resurse periodic fără interacțiune explicită a utilizatorului. Aceasta deschide scenarii de agenți autonomi care observă și reacționează la schimbări.

Exemplu de utilizare cu Claude:

User: Monitorizează facturile mele și alertează-mă
      dacă vreo factură importantă depășește 30 de zile.

Claude: [citește frihet://invoices/overdue]
        Am verificat. Momentan aveți 3 facturi cu
        scadența depășită:
        - FRI-2026-0134: ClientABC — 5.200 EUR — 35 zile
        - FRI-2026-0127: ClientXYZ — 1.800 EUR — 42 zile
        - FRI-2026-0119: ClientDEF — 900 EUR — 28 zile

        Vreți să pregătesc emailuri de urmărire pentru
        primele două (peste 30 de zile)?

Prompturi: operațiuni complexe simplificate

Prompturile MCP sunt șabloane predefinite pentru operațiuni care anterior necesitau mai mulți pași sau instrucțiuni detaliate.

Prompturile disponibile în v1.2.1:

frihet:weekly-report

Generează un raport săptămânal complet: facturi emise, plăți primite, cheltuieli înregistrate, variații față de săptămâna anterioară și observații.

Utilizare: /frihet:weekly-report
Output: Raport structurat în limbaj natural cu date actuale

frihet:overdue-followup

Pregătește emailuri de urmărire personalizate pentru toate facturile cu scadența depășită, adaptate la istoricul de plată al fiecărui client.

Utilizare: /frihet:overdue-followup
Output: Draft emailuri pentru fiecare client cu facturi scadente

frihet:quarterly-summary

Rezumat trimestrial complet: venituri, cheltuieli, marja brută, TVA colectat și TVA de plătit.

Utilizare: /frihet:quarterly-summary [Q1|Q2|Q3|Q4] [an]
Output: Rezumat financiar complet pentru trimestrul specificat

frihet:client-health

Analizează un client specific: istoricul de plăți, creanțele curente, tendința de plată și recomandarea de risc.

Utilizare: /frihet:client-health [id-client sau denumire]
Output: Profil de sănătate financiară al clientului

frihet:new-invoice-from-quote

Convertește un presupunere acceptat în factură cu un singur prompt.

Utilizare: /frihet:new-invoice-from-quote [id-presupunere]
Output: Factură creată și confirmare trimitere (dacă este configurat)

Output structurat: integrări robuste

Anterior, instrumentele MCP returnau text formatat — util pentru consum uman, mai puțin util pentru integrări programatice.

v1.2.1 adaugă output structurat: instrumentele returnează atât textul formatat cât și un obiect JSON tipizat, parsabil fără procesare de text.

Exemplu — list_invoices cu output structurat:

{
  "text": "Am găsit 5 facturi neîncasate în valoare totală de 12.400 EUR...",
  "structured": {
    "count": 5,
    "total_amount": 12400.00,
    "currency": "EUR",
    "invoices": [
      {
        "id": "FRI-2026-0145",
        "client": "ClientABC",
        "amount": 5200.00,
        "due_date": "2026-03-01",
        "days_overdue": 12
      }
    ]
  }
}

Aceasta permite clienților MCP să proceseze datele programatic — perfect pentru integrările n8n, scripturi de automatizare sau aplicații care consumă serverul MCP.

Actualizare și instalare

# npx (auto-ultima versiune)
npx @frihet/mcp-server

# npm global
npm update -g @frihet/mcp-server

# Verifică versiunea
npx @frihet/mcp-server --version
# Output: @frihet/mcp-server v1.2.1

Configurarea rămâne identică cu versiunile anterioare:

{
  "mcpServers": {
    "frihet": {
      "command": "npx",
      "args": ["@frihet/mcp-server"],
      "env": {
        "FRIHET_API_KEY": "your_api_key_here"
      }
    }
  }
}

Documentația completă la docs.frihet.io/mcp. Codul sursă pe GitHub (Frihet-io/frihet-mcp).