Mitä eroa on Resursseilla ja Työkaluilla MCP:ssä?

Työkalut suorittavat toimintoja API:a vastaan (luo lasku, listaa kulut). Resurssit esittävät staattisia viitetietoja, joita agentti voi kysyä ilman API-kutsuja. Verokannat, verokalenterit tai kululuokat ovat aina saatavilla kontekstina.

Mitä ovat MCP-kehotteet ja miten niitä käytetään?

Kehotteet ovat ohjattuja työnkulkuja, jotka ketjuttavat useita työkaluja loogiseen järjestykseen. Yksittäisten toimintojen suorittamisen sijaan kehotus, kuten monthly-close, opastaa agenttia askel askeleelta: tarkista maksamattomat laskut, luokittele kulut, varmista verovelvoitteet.

Pitääkö minun päivittää jotain käyttääkseni versiota v1.2?

Jos käytät npx @frihet/mcp-server, saat uusimman version automaattisesti. Jos sinulla on kiinteä asennus, päivitä npm update @frihet/mcp-server -komennolla. Versioon v1.1.0 verrattuna ei ole rikkovia muutoksia.

MCP Server v1.2: resurssit, kehotteet ja strukturoitu ulostulo

Frihetin MCP-palvelimen versio 1.2.1 ei lisää enempää työkaluja. Se lisää älykkyyttä. Resursseja, jotta agenteilla on verokontekstiä kysymättä. Kehotteita, jotta ne voivat suorittaa kokonaisia työnkulkuja ilman väliintuloa. Strukturoitu ulostulo, jotta jokainen vastaus on deterministisesti jäsennettävissä.

Tämä päivitys muuntaa MCP-palvelimen CRUD-operaatioiden sillasta täydelliseksi liiketoiminnan hallintarajapinnaksi tekoälyagenteille.

Resurssit: aina saatavilla olevat viitetiedot

MCP-resurssit ovat staattisia tietoja, joita agentti voi lukea milloin tahansa tekemättä kutsuja Frihetin API

. Ne eivät kuluta kiintiötä, eivät vaadi lisätodennusta ja ovat käytettävissä heti palvelimen yhdistämisen jälkeen.

V1.2 esittelee 5 resurssia:

`frihet://api/schema`

Yhteenveto kaikista saatavilla olevista päätepisteistä, todennusmenetelmistä ja nopeusrajoituksista. Kun agentin on tiedettävä, mitä se voi tehdä Frihetillä, se tarkistaa tämän resurssin sen sijaan, että selvittäisi sen kokeilemalla ja erehtymällä.

`frihet://tax/rates`

Voimassa olevat verokannat Espanjassa: yleinen IVA (21%), alennettu (10%) ja erittäin alennettu (4%); Kanarian IGIC (7%, 3%, 0%); IRPF-pidätykset. Agentilla on tämä konteksti ennen laskun luomista tai kulun kirjaamista. Sen ei tarvitse kysyä, mitä IVA

soveltaa, jos se jo tietää, missä yrityksesi toimii.

`frihet://tax/calendar`

Neljännesvuosittaisten veroilmoitusten jättöpäivät: Malli 303 (IVA), Malli 130 (IRPF), Malli 420 (IGIC). Kun agentti valmistelee neljännesvuosittaista tilinpäätöstä, se tietää tarkalleen, milloin kukin velvoite erääntyy.

`frihet://config/expense-categories`

Kahdeksan kululuokkaa ja niiden vähennyssäännöt. Toimistotarvikkeet, tarvikkeet, kuljetus, päivärahat, koulutus, vakuutukset, ammattipalvelut, muut. Jokainen luokka sisältää vähennysprosentin ja soveltuvat ehdot.

`frihet://config/invoice-statuses`

Laskun tilavirta: luonnos, lähetetty, toimitettu, maksettu, erääntynyt, mitätöity. Jokainen tila sisältää sallitut siirtymät ja laukaisimet, jotka voidaan aktivoida (webhooks, ilmoitukset). Agentti tietää, mitkä toiminnot ovat sallittuja milloin tahansa.

Kehotteet: ohjatut työnkulut

Työkalu suorittaa yhden operaation. Kehotus orkestroi useita operaatioita yhtenäiseksi työnkuluksi. Ero on siinä, että siirrytään “luo tämä kulu” -komennosta “käsittele nämä 15 kulutositeetta, luokittele ne, käytä oikeat verot ja vahvista ennen luomista”.

V1.2 sisältää 5 kehotetta:

`monthly-close`

Ohjattu kuukausittainen tilinpäätös. Agentti tarkistaa maksamattomat laskut, luokittelee määrittämättömät kulut, varmistaa, että kauden verovelvoitteet on täytetty ja luo yhteenvedon. Työnkulku, joka yleensä vie tunnin manuaalista tarkistusta, suoritettuna keskustelussa.

`onboard-client`

Uuden asiakkaan liittäminen. Määrittää verokannan asiakkaan sijainnin perusteella (mantereen IVA, Kanarian IGIC, yhteisön sisäinen), luo tiedot oikeilla verotiedoilla ja luo tervetuliaistarjouksen. Kaikki yhdessä sekvenssissä.

`quarterly-tax-prep`

Neljännesvuosittainen verovalmistelu. Kerää kaikki kauden laskut, laskee arvonlisäveron (IVA) tai IGIC

veropohjat, soveltaa IRPF-pidätykset ja luo esikatselun mallista 303 tai 130. Agentti tekee työn; sinä tai kirjanpitäjäsi vahvistatte tuloksen.

`overdue-followup`

Erääntyneiden laskujen seuranta. Tunnistaa kaikki myöhästyneet laskut, ryhmittelee ne asiakkaan mukaan, laskee kunkin asiakkaan kokonaisvelan ja laatii henkilökohtaiset perintäviestit. Siitä, että “minun on tarkistettava, mitä he ovat minulle velkaa” siihen, että “tässä ovat luonnokset valmiina lähetettäväksi”.

`expense-batch`

Kulujen eräkäsittely. Vastaanottaa kululuettelon, luokittelee ne määritettyjen sääntöjen mukaisesti, soveltaa vastaavat verot, tarkistaa kunkin vähennyskelpoisuuden ja luo ne ennakkohyväksynnällä. Ihanteellinen viikon tai matkan aikana kertyneiden kuittien käsittelyyn.

Strukturoitu ulostulo: jäsennettävissä olevat vastaukset

Tähän asti MCP-palvelimen vastaukset ovat olleet muotoiltua tekstiä. Hyödyllistä ihmisille, mutta agentit tarvitsevat strukturoituja tietoja ohjelmallisten päätösten tekemiseen.

V1.2 lisää outputScheman ja structuredContentin jokaiseen työkaluun. Jokainen vastaus sisältää JSON-skeeman, joka kuvaa tarkasti palautettujen tietojen rakenteen. Agentti tietää ennen kutsua, mitä kenttiä se saa, mitä tyyppiä ne ovat ja mitkä ovat valinnaisia.

Tämä mahdollistaa sen, että kehotus, kuten quarterly-tax-prep, voi ketjuttaa 4 operaatiota luotettavasti: jokainen vaihe tuottaa tietoja tunnetulla rakenteella, jonka seuraava vaihe voi kuluttaa yksiselitteisesti.

Kehittäjille, jotka rakentavat integraatioita MCP-palvelimen päälle, tämä poistaa tarpeen jäsentää vapaamuotoista tekstiä. Vastaus on aina samassa muodossa.

Turvallisuusmerkinnät

Jokainen MCP-palvelimen työkalu sisältää nyt merkinnät, jotka osoittavat, onko toiminto vain luku -tila tai tuhoava. list-invoices on merkitty lukutoiminnoksi. delete-expense on merkitty tuhoavaksi.

Tämä antaa agenteille mahdollisuuden toteuttaa vahvistuskäytäntöjä. Agentti voi suorittaa lukutoimintoja kysymättä, mutta pyytää nimenomaista vahvistusta ennen tietojen poistamista tai muokkaamista. Turvallisuus ei riipu agentista – sen määrittelee palvelin.

Yleisasennus

Palvelin asennetaan yhdellä komennolla mihin tahansa yhteensopivaan agenttiin:

npx @frihet/mcp-server

Se toimii Claude Code

, Claude Desktop

, Cursor

, Windsurf

, Cline

, Codex

ja missä tahansa MCP-asiakasohjelmassa. Agenteille, jotka tukevat asennusta taitojen kautta:

npx skills add Frihet-io/frihet-mcp

Molemmat menetelmät antavat pääsyn yli 30 työkaluun, 5 resurssiin, 5 kehotteeseen ja strukturoituun ulostuloon.

Frihet-io
alainen repositorio

MCP-palvelin on siirretty Frihet-io-organisaatioon GitHubissa. Repositorion URL-osoite on nyt github.com/Frihet-io/frihet-mcp. Edelliset linkit ohjaavat automaattisesti.

npm-paketti on edelleen @frihet/mcp-server. Asennukseen ei ole tullut muutoksia.

Kenelle tämä päivitys on tarkoitettu

Ammattilaiset, jotka jo käyttävät MCP-palvelinta, saavat Resursseja automaattisena verokontekstinä ja Kehotteita työnkuluina, jotka he aiemmin suorittivat manuaalisesti askel askeleelta.

Kehittäjät, jotka rakentavat Frihetin päälle, saavat strukturoidun ulostulon deterministisiä integraatioita varten ja turvallisuusmerkinnät vahvistuskäytäntöjä varten.

Kirjanpitotoimistot ja veroneuvojat saavat työnkulkuihinsa räätälöityjä kehotteita: kuukausittainen tilinpäätös, neljännesvuosittainen valmistelu, saatavien seuranta.

Kaikki tekoälyagentteja käyttävät yritykset saavat MCP-palvelimen, joka ei ainoastaan suorita toimintoja, vaan myös osaa ketjuttaa ne todellisiksi liiketoimintaprosesseiksi.

Kuinka päivittää

Jos käytät npx @frihet/mcp-server, sinulla on jo uusin versio. Jos sinulla on kiinteä asennus:

npm update @frihet/mcp-server

Ei rikkovia muutoksia. Kaikki olemassa olevat työkalut säilyttävät käyttöliittymänsä. Resurssit, kehotteet ja strukturoitu ulostulo ovat puhtaita lisäyksiä.

Täydellinen dokumentaatio löytyy osoitteesta docs.frihet.io/desarrolladores. Lähdekoodi GitHubista (Frihet-io/frihet-mcp). Paketti npm

nimellä @frihet/mcp-server.