Hoppa till innehåll
Priser

Språk

Kom igång gratis
← Tillbaka till Journal
Technologie
5 min läsning

MCP Server v1.2: resurser, prompts och strukturerad output

Frihet MCP Server v1.2: 5 statiska resurser, 5 guidade prompts, strukturerad output, säkerhetsanmärkningar. Allt om uppdateringen.

Av Equipo Frihet
Dela
MCP Server v1.2: resurser, prompts och strukturerad output

Viktiga punkter

  • 5 MCP Resources tillhandahåller skatte- och konfigurationsreferensdata utan att förbruka API-anrop
  • 5 MCP Prompts vägleder flerstegsflöden som månadsbokslut, kvartalsvis skatteförberedelse eller uppföljning av inkassering
  • Varje verktyg returnerar outputSchema + structuredContent för pålitlig parsning i vilken AI-agent som helst
Innehåll

Frihet MCP-server version 1.2.1 lägger inte till fler verktyg. Den lägger till intelligens. Resources så att agenter har skattekontext utan att fråga. Prompts så att de kan utföra kompletta flöden utan inblandning. Strukturerad output så att varje svar är deterministiskt parsebart.

Denna uppdatering förvandlar MCP-servern från en brygga för CRUD-operationer till ett komplett gränssnitt för företagsledning för IA-agenter.

Resurser: alltid tillgänglig referensdata

MCP Resources är statisk data som agenten kan läsa när som helst utan att göra anrop till Frihet API

. De förbrukar ingen kvot, kräver ingen ytterligare autentisering och är tillgängliga från det ögonblick servern ansluts.

v1.2 introducerar 5 resurser:

frihet://api/schema

Sammanfattning av alla tillgängliga slutpunkter, autentiseringsmetoder och hastighetsbegränsningar. När en agent behöver veta vad den kan göra med Frihet, konsulterar den denna resurs istället för att upptäcka det genom försök och misstag.

frihet://tax/rates

Gällande skattesatser i Spanien: allmän moms (IVA) (21%), reducerad (10%) och superreducerad (4%); kanariska IGIC (7%, 3%, 0%); IRPF-avdrag. Agenten har denna kontext innan den skapar en faktura eller registrerar en utgift. Den behöver inte fråga dig vilken IVA som ska tillämpas om den redan vet var ditt företag verkar.

frihet://tax/calendar

Inlämningsdatum för kvartalsvisa deklarationer: Blankett 303 (IVA), Blankett 130 (IRPF), Blankett 420 (IGIC). När agenten förbereder ett kvartalsbokslut, vet den exakt när varje skyldighet förfaller.

frihet://config/expense-categories

De 8 utgiftskategorierna med sina avdragsregler. Kontorsmaterial, förnödenheter, transport, traktamenten, utbildning, försäkringar, professionella tjänster, övrigt. Varje kategori inkluderar avdragsandelen och de tillämpliga villkoren.

frihet://config/invoice-statuses

Fakturans statusflöde: utkast, utfärdad, skickad, inkasserad, förfallen, annullerad. Varje status inkluderar tillåtna övergångar och triggers som kan aktiveras (webhooks, notifikationer). Agenten vet vilka åtgärder som är giltiga vid varje given tidpunkt.

Prompts: guidade arbetsflöden

Ett Tool utför en operation. En Prompt orkestrerar flera operationer i ett sammanhängande flöde. Skillnaden är att gå från “skapa denna utgift” till “bearbeta dessa 15 utgiftskvitton, kategorisera dem, tillämpa korrekta skatter och bekräfta innan du skapar”.

v1.2 inkluderar 5 prompts:

monthly-close

Guidat månadsbokslut. Agenten granskar obetalda fakturor, kategoriserar oallokerade utgifter, verifierar att periodens skatteplikter är uppfyllda och genererar en sammanfattning. Ett flöde som normalt tar en timmes manuell granskning, utfört i en konversation.

onboard-client

Registrering av ny kund. Bestämmer skattesatsen baserat på kundens plats (peninsulär IVA, kanarisk IGIC, intrakommunitär), skapar posten med korrekta skattedata och genererar en välkomstbudget. Allt i en sekvens.

quarterly-tax-prep

Kvartalsvis skatteförberedelse. Samlar in alla fakturor för perioden, beräknar skatteunderlagen för IVA eller IGIC, tillämpar IRPF-avdragen och genererar en förhandsgranskning av Blankett 303 eller 130. Agenten gör jobbet; du eller din revisor validerar resultatet.

overdue-followup

Uppföljning av förfallna fakturor. Identifierar alla förfallna fakturor, grupperar dem per kund, beräknar det totala utestående beloppet för var och en och utarbetar anpassade inkassomeddelanden. Från “jag måste granska vad de är skyldiga mig” till “här är utkast redo att skickas”.

expense-batch

Batchbearbetning av utgifter. Tar emot en lista över utgifter, kategoriserar dem enligt konfigurerade regler, tillämpar motsvarande skatter, verifierar avdragsrätten för varje och skapar dem med föregående bekräftelse. Idealisk för att bearbeta ackumulerade kvitton från en vecka eller en resa.

Strukturerad output: parsebara svar

Hittills var svaren från MCP-servern formaterad text. Användbart för mänsklig läsning, men agenter behöver strukturerad data för att fatta programmatiska beslut.

v1.2 lägger till outputSchema och structuredContent till varje verktyg. Varje svar inkluderar ett JSON-schema som exakt beskriver strukturen för den returnerade datan. Agenten vet innan anropet vilka fält den kommer att ta emot, vilken typ de är och vilka som är valfria.

Detta är vad som gör det möjligt för en prompt som quarterly-tax-prep att pålitligt länka samman 4 operationer: varje steg producerar data med en känd struktur som nästa steg kan konsumera utan tvetydighet.

För utvecklare som bygger integrationer ovanpå MCP-servern eliminerar detta behovet av att parsa fritext. Svaret har alltid samma form.

Säkerhetsanmärkningar

Varje verktyg på MCP-servern inkluderar nu anmärkningar som indikerar om operationen är skrivskyddad eller destruktiv. Ett list-invoices är markerat som läsoperation. Ett delete-expense är markerat som destruktivt.

Detta gör det möjligt för agenter att implementera bekräftelsepolicyer. En agent kan utföra läsoperationer utan att fråga, men begära explicit bekräftelse innan data raderas eller ändras. Säkerheten beror inte på agenten — den definieras av servern.

Universell installation

Servern installeras med ett enda kommando på vilken kompatibel agent som helst:

npx @frihet/mcp-server

Fungerar i Claude Code, Claude Desktop, Cursor, Windsurf, Cline, Codex och vilken MCP-klient som helst. För agenter som stöder installation via skills:

npx skills add Frihet-io/frihet-mcp

Båda metoderna ger tillgång till de 30+ verktygen, de 5 resurserna, de 5 prompts och den strukturerade outputen.

Förvar under Frihet-io

MCP-servern har överförts till organisationen Frihet-io på GitHub. Repositoryns URL är nu github.com/Frihet-io/frihet-mcp. Tidigare länkar omdirigerar automatiskt.

npm-paketet är fortfarande @frihet/mcp-server. Det finns inga ändringar i installationen.

Vem är denna uppdatering för?

Professionella som redan använder MCP-servern får Resources som automatisk skattekontext och Prompts som flöden de tidigare utförde steg för steg manuellt.

Utvecklare som bygger på Frihet får strukturerad output för deterministiska integrationer och säkerhetsanmärkningar för bekräftelsepolicyer.

Revisionsbyråer och skatterådgivare får specifika prompts för sina arbetsflöden: månadsbokslut, kvartalsvis förberedelse, uppföljning av inkassering.

Alla företag som använder IA-agenter får en MCP-server som inte bara utför operationer, utan också vet hur man länkar dem i verkliga affärsflöden.

Hur man uppdaterar

Om du använder npx @frihet/mcp-server har du redan den senaste versionen. Om du har en fast installation:

npm update @frihet/mcp-server

Det finns inga brytande ändringar. Alla befintliga verktyg behåller sitt gränssnitt. Resurserna, Prompts och strukturerad output är rena tillägg.

Fullständig dokumentation finns på docs.frihet.io/desarrolladores. Källkoden på GitHub (Frihet-io/frihet-mcp). Paketet på npm som @frihet/mcp-server.

Var den här artikeln till hjälp?

Vanliga frågor

Vad är skillnaden mellan Resources och Tools i MCP?

Tools utför åtgärder mot API:et (skapa faktura, lista utgifter). Resources exponerar statisk referensdata som agenten kan fråga utan att göra API-anrop. Skattesatser, skattekalendrar eller utgiftskategorier är alltid tillgängliga som kontext.

Vad är MCP Prompts och hur används de?

Prompts är guidade arbetsflöden som länkar samman flera verktyg i en logisk sekvens. Istället för att utföra enstaka operationer, vägleder en prompt som monthly-close agenten steg för steg: granska obetalda fakturor, kategorisera utgifter, verifiera skatteplikter.

Behöver jag uppdatera något för att använda v1.2?

Om du använder npx @frihet/mcp-server får du den senaste versionen automatiskt. Om du har en fast installation, uppdatera med npm update @frihet/mcp-server. Det finns inga brytande ändringar jämfört med v1.1.0.

Relaterade artiklar

Kommentarer

Frihet — Företagande utan drama

Börja Gratis