Jaka jest różnica między zasobami a narzędziami w MCP?

Narzędzia wykonują akcje na API (tworzenie faktury, lista wydatków). Zasoby udostępniają statyczne dane referencyjne, które agent może konsultować bez wykonywania wywołań API. Stawki podatkowe, kalendarze podatkowe lub kategorie wydatków są zawsze dostępne jako kontekst.

Czym są prompty MCP i jak ich używać?

Prompty to prowadzone przepływy pracy, które łączą wiele narzędzi w logiczną sekwencję. Zamiast wykonywać pojedyncze operacje, prompt taki jak monthly-close prowadzi agenta krok po kroku: przeglądanie zaległych faktur, kategoryzowanie wydatków, weryfikowanie zobowiązań podatkowych.

Czy muszę coś zaktualizować, aby używać v1.2?

Jeśli używasz npx @frihet/mcp-server, automatycznie otrzymujesz najnowszą wersję. Jeśli masz stałą instalację, zaktualizuj ją za pomocą npm update @frihet/mcp-server. Nie ma zmian powodujących niezgodność z v1.1.0.

MCP Server v1.2: zasoby, prompty i ustrukturyzowany wynik

Wersja 1.2.1 serwera MCP firmy Frihet nie dodaje więcej narzędzi. Dodaje inteligencję. Zasoby, aby agenci mieli kontekst podatkowy bez pytania. Prompty, aby wykonywali kompletne przepływy pracy bez interwencji. Ustrukturyzowany wynik, aby każda odpowiedź była deterministycznie parsowalna.

Ta aktualizacja przekształca serwer MCP z mostu operacji CRUD w kompletny interfejs zarządzania biznesem dla agentów AI.

Zasoby: dane referencyjne zawsze dostępne

Zasoby MCP to dane statyczne, które agent może odczytać w dowolnym momencie bez wykonywania wywołań do API Frihet. Nie zużywają limitu, nie wymagają dodatkowej autentykacji i są dostępne od momentu połączenia serwera.

Wersja 1.2 wprowadza 5 zasobów:

`frihet://api/schema`

Podsumowanie wszystkich dostępnych endpointów, metod autentykacji i limitów szybkości. Kiedy agent musi wiedzieć, co może zrobić z Frihet, konsultuje ten zasób zamiast odkrywać to metodą prób i błędów.

`frihet://tax/rates`

Obowiązujące stawki podatkowe w Hiszpanii: ogólny IVA (21%), obniżony (10%) i superobniżony (4%); kanaryjski IGIC (7%, 3%, 0%); potrącenia IRPF. Agent ma ten kontekst przed utworzeniem faktury lub zarejestrowaniem wydatku. Nie musi pytać, jaki IVA zastosować, jeśli już wie, gdzie działa Twój biznes.

`frihet://tax/calendar`

Daty składania kwartalnych deklaracji: Modelo 303 (IVA), Modelo 130 (IRPF), Modelo 420 (IGIC). Kiedy agent przygotowuje zamknięcie kwartalne, dokładnie wie, kiedy upływa termin każdej z tych obowiązków.

`frihet://config/expense-categories`

8 kategorii wydatków wraz z zasadami odliczalności. Materiały biurowe, zaopatrzenie, transport, diety, szkolenia, ubezpieczenia, usługi profesjonalne, inne. Każda kategoria zawiera procent odliczalności i obowiązujące warunki.

`frihet://config/invoice-statuses`

Przepływ statusów faktury: projekt, wystawiona, wysłana, opłacona, przeterminowana, anulowana. Każdy status zawiera dozwolone przejścia i wyzwalacze, które mogą być aktywowane (webhooki, powiadomienia). Agent wie, jakie działania są prawidłowe w każdym momencie.

Prompty: prowadzone przepływy pracy

Narzędzie wykonuje operację. Prompt orkiestruje kilka operacji w spójny przepływ. Różnica polega na przejściu od “stwórz ten wydatek” do “przetwórz te 15 biletów wydatków, skategoryzuj je, zastosuj prawidłowe podatki i potwierdź przed utworzeniem”.

Wersja 1.2 zawiera 5 promptów:

`monthly-close`

Prowadzone zamknięcie miesiąca. Agent przegląda zaległe faktury do zapłaty, kategoryzuje nieprzypisane wydatki, weryfikuje, czy zobowiązania podatkowe za dany okres są pokryte i generuje podsumowanie. Przepływ, który zwykle zajmuje godzinę ręcznej weryfikacji, wykonany w rozmowie.

`onboard-client`

Rejestracja nowego klienta. Określa stawkę podatkową w zależności od lokalizacji klienta (IVA na półwyspie, kanaryjski IGIC, wewnątrzwspólnotowy), tworzy rekord z prawidłowymi danymi podatkowymi i generuje ofertę powitalną. Wszystko w jednej sekwencji.

`quarterly-tax-prep`

Kwartalne przygotowanie podatków. Zbiera wszystkie faktury z okresu, oblicza podstawy opodatkowania IVA lub IGIC, stosuje potrącenia IRPF i generuje podgląd Modelu 303 lub 130. Agent wykonuje pracę; Ty lub Twój księgowy walidujecie wynik.

`overdue-followup`

Śledzenie przeterminowanych faktur. Identyfikuje wszystkie przeterminowane faktury, grupuje je według klienta, oblicza całkowitą kwotę zaległą dla każdego i redaguje spersonalizowane wiadomości windykacyjne. Od “muszę sprawdzić, co mi są winni” do “oto szkice gotowe do wysłania”.

`expense-batch`

Przetwarzanie wydatków partiami. Otrzymuje listę wydatków, kategoryzuje je zgodnie ze skonfigurowanymi zasadami, stosuje odpowiednie podatki, weryfikuje odliczalność każdego z nich i tworzy je z wcześniejszym potwierdzeniem. Idealne do przetwarzania skumulowanych biletów z tygodnia lub podróży.

Ustrukturyzowany wynik: odpowiedzi parsowalne

Do tej pory odpowiedzi serwera MCP były formatowanym tekstem. Przydatne do odczytu przez człowieka, ale agenci potrzebują ustrukturyzowanych danych, aby podejmować programistyczne decyzje.

Wersja 1.2 dodaje outputSchema i structuredContent do każdego narzędzia. Każda odpowiedź zawiera schemat JSON, który dokładnie opisuje strukturę zwracanych danych. Agent wie, przed wywołaniem, jakie pola otrzyma, jakiego są typu i które są opcjonalne.

To właśnie pozwala promptowi takiemu jak quarterly-tax-prep niezawodnie łączyć 4 operacje: każdy krok generuje dane o znanej strukturze, które następny krok może jednoznacznie przetworzyć.

Dla deweloperów, którzy budują integracje na serwerze MCP, eliminuje to potrzebę parsowania wolnego tekstu. Odpowiedź zawsze ma tę samą formę.

Adnotacje bezpieczeństwa

Każde narzędzie serwera MCP zawiera teraz adnotacje wskazujące, czy operacja jest tylko do odczytu, czy destrukcyjna. list-invoices jest oznaczone jako odczyt. delete-expense jest oznaczone jako destrukcyjne.

Pozwala to agentom na implementowanie polityk potwierdzeń. Agent może wykonywać operacje odczytu bez pytania, ale żądać wyraźnego potwierdzenia przed usunięciem lub modyfikacją danych. Bezpieczeństwo nie zależy od agenta — jest definiowane przez serwer.

Uniwersalna instalacja

Serwer instaluje się jednym poleceniem w dowolnym kompatybilnym agencie:

npx @frihet/mcp-server

Działa w Claude Code, Claude Desktop, Cursor, Windsurf, Cline, Codex i dowolnym kliencie MCP. Dla agentów obsługujących instalację przez skills:

npx skills add Frihet-io/frihet-mcp

Obie metody dają dostęp do ponad 30 narzędzi, 5 zasobów, 5 promptów i ustrukturyzowanego wyniku.

Repozytorium pod Frihet-io

Serwer MCP został przeniesiony do organizacji Frihet-io na GitHubie. URL repozytorium to teraz github.com/Frihet-io/frihet-mcp. Poprzednie linki automatycznie przekierowują.

Pakiet npm nadal to @frihet/mcp-server. Nie ma zmian w instalacji.

Dla kogo jest ta aktualizacja

Profesjonaliści, którzy już używają serwera MCP zyskują zasoby jako automatyczny kontekst podatkowy i prompty jako przepływy, które wcześniej wykonywali krok po kroku ręcznie.

Deweloperzy, którzy budują na Frihet zyskują ustrukturyzowany wynik dla deterministycznych integracji i adnotacje bezpieczeństwa dla polityk potwierdzeń.

Biura rachunkowe i doradcy podatkowi zyskują specjalne prompty dla swoich przepływów pracy: zamknięcie miesiąca, kwartalne przygotowanie, śledzenie płatności.

Każda firma używająca agentów AI zyskuje serwer MCP, który nie tylko wykonuje operacje, ale także wie, jak łączyć je w rzeczywiste przepływy biznesowe.

Jak zaktualizować

Jeśli używasz npx @frihet/mcp-server, masz już najnowszą wersję. Jeśli masz stałą instalację:

npm update @frihet/mcp-server

Nie ma zmian powodujących niezgodność. Wszystkie istniejące narzędzia zachowują swój interfejs. Zasoby, prompty i ustrukturyzowany wynik to czyste dodatki.

Pełna dokumentacja znajduje się na docs.frihet.io/desarrolladores. Kod źródłowy na GitHubie (Frihet-io/frihet-mcp). Pakiet w npm jako @frihet/mcp-server.