Ce diferență există între Resurse și Instrumente în MCP?

Instrumentele execută acțiuni împotriva API-ului (crearea unei facturi, listarea cheltuielilor). Resursele expun date de referință statice pe care agentul le poate consulta fără a face apeluri la API. Cote de impozitare, calendare fiscale sau categorii de cheltuieli sunt întotdeauna disponibile ca și context.

Ce sunt Prompturile MCP și cum se utilizează?

Prompturile sunt fluxuri de lucru ghidate care înlănțuiesc mai multe instrumente într-o secvență logică. În loc să execute operațiuni individuale, un prompt precum monthly-close ghidează agentul pas cu pas: revizuirea facturilor restante, categorizarea cheltuielilor, verificarea obligațiilor fiscale.

Trebuie să actualizez ceva pentru a folosi v1.2?

Dacă folosiți npx @frihet/mcp-server, obțineți automat cea mai recentă versiune. Dacă aveți o instalare fixă, actualizați cu npm update @frihet/mcp-server. Nu există modificări disruptive față de v1.1.0.

MCP Server v1.2: resurse, prompturi și output structurat

mcp api ia dezvoltator actualizare

Distribuie

Versiunea 1.2.1 a serverului MCP de la Frihet nu adaugă mai multe instrumente. Adaugă inteligență. Resurse pentru ca agenții să aibă context fiscal fără a întreba. Prompturi pentru a executa fluxuri complete fără intervenție. Output structurat pentru ca fiecare răspuns să poată fi analizat determinist.

Această actualizare transformă serverul MCP dintr-o punte de operațiuni CRUD într-o interfață completă de management al afacerilor pentru agenți AI.

Resurse: date de referință întotdeauna disponibile

Resursele MCP sunt date statice pe care agentul le poate citi în orice moment fără a face apeluri la API-ul Frihet. Nu consumă cotă, nu necesită autentificare suplimentară și sunt disponibile din momentul în care serverul se conectează.

v1.2 introduce 5 resurse:

`frihet://api/schema`

Rezumatul tuturor endpoint-urilor disponibile, metodelor de autentificare și limitelor de rată. Atunci când un agent trebuie să știe ce poate face cu Frihet, consultă această resursă în loc să descopere prin încercare și eroare.

`frihet://tax/rates`

Cote de impozitare în vigoare în Spania: TVA general (21%), redus (10%) și super-redus (4%); IGIC canarian (7%, 3%, 0%); rețineri IRPF. Agentul are acest context înainte de a crea o factură sau de a înregistra o cheltuială. Nu trebuie să te întrebe ce TVA să aplice dacă știe deja unde operează afacerea ta.

`frihet://tax/calendar`

Datele de depunere a declarațiilor trimestriale: Modelul 303 (TVA), Modelul 130 (IRPF), Modelul 420 (IGIC). Când agentul pregătește o închidere trimestrială, știe exact când expiră fiecare obligație.

`frihet://config/expense-categories`

Cele 8 categorii de cheltuieli cu regulile lor de deductibilitate. Materiale de birou, consumabile, transport, diurne, formare, asigurări, servicii profesionale, altele. Fiecare categorie include procentul de deductibilitate și condițiile care se aplică.

`frihet://config/invoice-statuses`

Fluxul stărilor unei facturi: ciornă, emisă, trimisă, încasată, scadentă, anulată. Fiecare stare include tranzițiile permise și declanșatoarele care pot fi activate (webhook-uri, notificări). Agentul știe ce acțiuni sunt valide în orice moment.

Prompturi: fluxuri de lucru ghidate

Un Instrument execută o operațiune. Un Prompt orchestrează mai multe operațiuni într-un flux coerent. Diferența este de a trece de la “creează această cheltuială” la “procesează aceste 15 bonuri de cheltuieli, clasifică-le, aplică impozitele corecte și confirmă înainte de a crea”.

v1.2 include 5 prompturi:

`monthly-close`

Închidere lunară ghidată. Agentul revizuiește facturile restante de încasat, clasifică cheltuielile nealocate, verifică dacă obligațiile fiscale ale perioadei sunt acoperite și generează un rezumat. Un flux care, în mod normal, durează o oră de revizuire manuală, executat într-o conversație.

`onboard-client`

Înregistrare client nou. Determină tipul de impozitare în funcție de locația clientului (TVA peninsular, IGIC canarian, intracomunitar), creează înregistrarea cu datele fiscale corecte și generează o ofertă de bun venit. Totul într-o singură secvență.

`quarterly-tax-prep`

Pregătirea trimestrială a impozitelor. Colectează toate facturile din perioadă, calculează bazele impozabile de TVA sau IGIC, aplică reținerile de IRPF și generează o previzualizare a Modelului 303 sau 130. Agentul face munca; tu sau contabilul tău validați rezultatul.

`overdue-followup`

Urmărirea facturilor restante. Identifică toate facturile restante, le grupează pe client, calculează suma totală restantă pentru fiecare și redactează mesaje personalizate de încasare. De la “trebuie să verific ce mi se datorează” la “aici ai ciornele gata de trimis”.

`expense-batch`

Procesarea cheltuielilor în loturi. Primește o listă de cheltuieli, le clasifică conform regulilor configurate, aplică impozitele corespunzătoare, verifică deductibilitatea fiecăreia și le creează cu confirmare prealabilă. Ideal pentru procesarea bonurilor acumulate dintr-o săptămână sau o călătorie.

Output structurat: răspunsuri analizabile

Până acum, răspunsurile serverului MCP erau text formatat. Util pentru citirea umană, dar agenții au nevoie de date structurate pentru a lua decizii programatice.

v1.2 adaugă outputSchema și structuredContent fiecărui instrument. Fiecare răspuns include o schemă JSON care descrie exact structura datelor returnate. Agentul știe înainte de a apela ce câmpuri va primi, de ce tip sunt și care sunt opționale.

Acesta este ceea ce permite ca un prompt precum quarterly-tax-prep să înlănțuiască 4 operațiuni într-un mod fiabil: fiecare pas produce date cu o structură cunoscută pe care următorul pas le poate consuma fără ambiguitate.

Pentru dezvoltatorii care construiesc integrări peste serverul MCP, aceasta elimină necesitatea de a analiza text liber. Răspunsul are întotdeauna aceeași formă.

Adnotări de securitate

Fiecare instrument al serverului MCP include acum adnotări care indică dacă operațiunea este doar de citire sau distructivă. Un list-invoices este marcat ca citire. Un delete-expense este marcat ca distructiv.

Acest lucru permite agenților să implementeze politici de confirmare. Un agent poate executa operațiuni de citire fără a întreba, dar poate solicita confirmare explicită înainte de a șterge sau modifica date. Securitatea nu depinde de agent — este definită de server.

Instalare universală

Serverul se instalează cu o singură comandă în orice agent compatibil:

npx @frihet/mcp-server

Funcționează în Claude Code, Claude Desktop, Cursor, Windsurf, Cline, Codex și orice client MCP. Pentru agenții care suportă instalarea prin skill-uri:

npx skills add Frihet-io/frihet-mcp

Ambele metode oferă acces la cele peste 30 de instrumente, cele 5 resurse, cele 5 prompturi și output-ul structurat.

Repozitoriu sub Frihet-io

Serverul MCP a fost transferat organizației Frihet-io pe GitHub. URL-ul depozitului este acum github.com/Frihet-io/frihet-mcp. Linkurile anterioare redirecționează automat.

Pachetul npm rămâne @frihet/mcp-server. Nu există modificări în instalare.

Cui se adresează această actualizare

Profesioniștii care utilizează deja serverul MCP câștigă Resurse ca și context fiscal automat și Prompturi ca și fluxuri pe care le executau anterior manual, pas cu pas.

Dezvoltatorii care construiesc pe Frihet câștigă output structurat pentru integrări deterministe și adnotări de securitate pentru politici de confirmare.

Firmele de contabilitate și consultanții fiscali câștigă prompturi specifice pentru fluxurile lor de lucru: închidere lunară, pregătire trimestrială, urmărire încasări.

Orice afacere care utilizează agenți AI câștigă un server MCP care nu doar execută operațiuni, ci știe și cum să le înlănțuie în fluxuri de afaceri reale.

Cum se actualizează

Dacă folosești npx @frihet/mcp-server, ai deja cea mai recentă versiune. Dacă ai o instalare fixă:

npm update @frihet/mcp-server

Nu există modificări disruptive. Toate instrumentele existente își păstrează interfața. Resursele, Prompturile și output-ul structurat sunt adăugiri pure.

Documentația completă se găsește pe docs.frihet.io/desarrolladores. Codul sursă pe GitHub (Frihet-io/frihet-mcp). Pachetul pe npm ca @frihet/mcp-server.