MCP Server v1.2: ressurser, prompts og strukturert utdata
Frihet MCP Server v1.2: Nye ressurser, veiledede prompts, strukturert utdata, sikkerhetsannoteringer. Alt om oppdateringen.
Viktige punkter
- 5 MCP-ressurser gir referansedata for skatt og konfigurasjon uten å bruke API-kall
- 5 MCP Prompts veileder flertrinnsprosesser som månedlig avslutning, kvartalsvis skatteforberedelse eller oppfølging av innkreving
- Hvert verktøy returnerer outputSchema + structuredContent for pålitelig parsing i enhver AI-agent
Innhold
Frihet MCP-server versjon 1.2.1 legger ikke til flere verktøy. Den legger til intelligens. Ressurser slik at agenter har skattekontekst uten å spørre. Prompts slik at de utfører komplette flyter uten inngripen. Strukturert utdata slik at hvert svar kan parses deterministisk.
Denne oppdateringen forvandler MCP-serveren fra en bro for CRUD-operasjoner til et komplett forretningsstyringsgrensesnitt for AI-agenter.
Ressurser: referansedata alltid tilgjengelig
MCP-ressurser er statiske data som agenten kan lese når som helst uten å foreta API-kall til Frihet. De bruker ikke kvote, krever ingen ytterligere autentisering og er tilgjengelige fra det øyeblikket serveren kobles til.
v1.2 introduserer 5 ressurser:
frihet://api/schema
Oversikt over alle tilgjengelige endepunkter, autentiseringsmetoder og ratebegrensninger. Når en agent trenger å vite hva den kan gjøre med Frihet, spør den denne ressursen i stedet for å finne det ut ved prøving og feiling.
frihet://tax/rates
Gjeldende skattesatser i Spania: generell MVA (21%), redusert (10%) og superredusert (4%); kanarisk IGIC (7%, 3%, 0%); IRPF-kilder. Agenten har denne konteksten før den oppretter en faktura eller registrerer en utgift. Den trenger ikke å spørre deg hvilken MVA som skal brukes hvis den allerede vet hvor bedriften din opererer.
frihet://tax/calendar
Innleveringsfrister for kvartalsvise erklæringer: Skjema 303 (MVA), Skjema 130 (IRPF), Skjema 420 (IGIC). Når agenten forbereder en kvartalsvis avslutning, vet den nøyaktig når hver forpliktelse forfaller.
frihet://config/expense-categories
De 8 utgiftskategoriene med deres fradragsregler. Kontormateriell, rekvisita, transport, diettgodtgjørelse, opplæring, forsikringer, profesjonelle tjenester, andre. Hver kategori inkluderer fradragsprosent og gjeldende betingelser.
frihet://config/invoice-statuses
Fakturaens statusflyt: utkast, utstedt, sendt, betalt, forfalt, annullert. Hver status inkluderer tillatte overganger og triggere som kan aktiveres (webhooks, varsler). Agenten vet hvilke handlinger som er gyldige til enhver tid.
Prompts: veiledede arbeidsflyter
Et verktøy utfører en operasjon. En Prompt orkestrerer flere operasjoner i en sammenhengende flyt. Forskjellen er å gå fra “opprett denne utgiften” til “behandle disse 15 utgiftskvitteringene, kategoriser dem, bruk korrekte avgifter og bekreft før opprettelse”.
v1.2 inkluderer 5 prompts:
monthly-close
Veiledet månedlig avslutning. Agenten gjennomgår ubetalte fakturaer, kategoriserer uallokerte utgifter, bekrefter at periodens skatteforpliktelser er dekket og genererer et sammendrag. En flyt som normalt tar en time med manuell gjennomgang, utføres i en samtale.
onboard-client
Registrering av ny kunde. Bestemmer skattesatsen basert på kundens beliggenhet (halvøy-MVA, kanarisk IGIC, internt i EU), oppretter registeret med korrekte skattedata og genererer et velkomsttilbud. Alt i én sekvens.
quarterly-tax-prep
Kvartalsvis skatteforberedelse. Samler inn alle fakturaene for perioden, beregner MVA- eller IGIC-avgiftsgrunnlag, anvender IRPF-kilder og genererer en forhåndsvisning av Skjema 303 eller 130. Agenten gjør jobben; du eller din regnskapsfører validerer resultatet.
overdue-followup
Oppfølging av forfalte fakturaer. Identifiserer alle fakturaer over forfallsdato, grupperer dem per kunde, beregner totalt utestående beløp for hver og utarbeider tilpassede inkassomeldinger. Fra “jeg må sjekke hva jeg skylder” til “her er utkastene klare til å sendes”.
expense-batch
Batchbehandling av utgifter. Mottar en liste over utgifter, kategoriserer dem i henhold til de konfigurerte reglene, anvender de korrekte avgiftene, bekrefter fradragsberettigelsen for hver og oppretter dem med forhåndsbekreftelse. Ideelt for å behandle akkumulerte kvitteringer fra en uke eller en reise.
Strukturert utdata: parsebare svar
Fram til nå har svarene fra MCP-serveren vært formatert tekst. Nyttig for mennesker å lese, men agenter trenger strukturerte data for å ta programmatiske beslutninger.
v1.2 legger til outputSchema og structuredContent til hvert verktøy. Hvert svar inkluderer et JSON-skjema som nøyaktig beskriver strukturen til de returnerte dataene. Agenten vet før den kaller hvilke felter den vil motta, hvilken type de er, og hvilke som er valgfrie.
Dette er det som gjør at en prompt som quarterly-tax-prep kan lenke sammen 4 operasjoner på en pålitelig måte: hvert trinn produserer data med en kjent struktur som neste trinn kan forbruke uten tvetydighet.
For utviklere som bygger integrasjoner på MCP-serveren, eliminerer dette behovet for å parse fri tekst. Svaret har alltid samme form.
Sikkerhetsannoteringer
Hvert verktøy på MCP-serveren inkluderer nå annoteringer som indikerer om operasjonen er kun lesing eller destruktiv. En list-invoices er merket som lesing. En delete-expense er merket som destruktiv.
Dette gjør at agenter kan implementere bekreftelsespolicyer. En agent kan utføre leseoperasjoner uten å spørre, men be om eksplisitt bekreftelse før den sletter eller endrer data. Sikkerheten avhenger ikke av agenten – den er definert av serveren.
Universell installasjon
Serveren installeres med en enkelt kommando i enhver kompatibel agent:
npx @frihet/mcp-serverDen fungerer i Claude Code, Claude Desktop, Cursor, Windsurf, Cline, Codex og enhver MCP-klient. For agenter som støtter installasjon via skills:
npx skills add Frihet-io/frihet-mcpBegge metodene gir tilgang til de 30+ verktøyene, de 5 ressursene, de 5 prompts og det strukturerte utdataet.
Repository under Frihet-io
MCP-serveren er overført til organisasjonen Frihet-io på GitHub. URL-en til repositoryet er nå github.com/Frihet-io/frihet-mcp. Tidligere lenker omdirigeres automatisk.
npm-pakken er fortsatt @frihet/mcp-server. Det er ingen endringer i installasjonen.
Hvem er denne oppdateringen for
Fagfolk som allerede bruker MCP-serveren får ressurser som automatisk skattekontekst og prompts som flyter de tidligere utførte trinn for trinn manuelt.
Utviklere som bygger på Frihet får strukturert utdata for deterministiske integrasjoner og sikkerhetsannoteringer for bekreftelsespolicyer.
Regnskapsbyråer og skatterådgivere får spesifikke prompts for deres arbeidsflyter: månedlig avslutning, kvartalsvis forberedelse, oppfølging av innkreving.
Enhver virksomhet som bruker AI-agenter får en MCP-server som ikke bare utfører operasjoner, men som vet hvordan man lenker dem sammen i reelle forretningsflyter.
Slik oppdaterer du
Hvis du bruker npx @frihet/mcp-server, har du allerede den nyeste versjonen. Hvis du har en fast installasjon:
npm update @frihet/mcp-serverDet er ingen brytende endringer. Alle eksisterende verktøy beholder sitt grensesnitt. Ressursene, Prompts og strukturert utdata er rene tillegg.
Fullstendig dokumentasjon er på docs.frihet.io/desarrolladores. Kildekoden på GitHub (Frihet-io/frihet-mcp). Pakken på npm som @frihet/mcp-server.
Var denne artikkelen nyttig?
Ofte stilte spørsmål
Hva er forskjellen mellom ressurser og verktøy i MCP?
Verktøy utfører handlinger mot API-en (opprette faktura, liste utgifter). Ressurser eksponerer statiske referansedata som agenten kan spørre uten å foreta API-kall. Skattesatser, skattefrister eller utgiftskategorier er alltid tilgjengelige som kontekst.
Hva er MCP Prompts og hvordan brukes de?
Prompts er veiledede arbeidsflyter som lenker sammen flere verktøy i en logisk sekvens. I stedet for å utføre enkeltstående operasjoner, veileder en prompt som monthly-close agenten trinn for trinn: gjennomgå ubetalte fakturaer, kategorisere utgifter, bekrefte skatteforpliktelser.
Må jeg oppdatere noe for å bruke v1.2?
Hvis du bruker npx @frihet/mcp-server, får du den nyeste versjonen automatisk. Hvis du har en fast installasjon, oppdater med npm update @frihet/mcp-server. Det er ingen brytende endringer fra v1.1.0.