MCP Server v1.2: πόροι, προτροπές και δομημένη έξοδος

Η έκδοση 1.2.1 του διακομιστή MCP της Frihet δεν προσθέτει περισσότερα εργαλεία. Προσθέτει νοημοσύνη. Πόρους ώστε οι παράγοντες να έχουν φορολογικό πλαίσιο χωρίς να ρωτούν. Προτροπές ώστε να εκτελούν πλήρεις ροές χωρίς παρέμβαση. Δομημένη έξοδο ώστε κάθε απάντηση να είναι αναλύσιμη με καθοριστικό τρόπο.

Αυτή η ενημέρωση μετατρέπει τον διακομιστή MCP από μια γέφυρα λειτουργιών CRUD σε μια πλήρη διεπαφή διαχείρισης επιχειρήσεων για παράγοντες AI.

Πόροι: δεδομένα αναφοράς πάντα διαθέσιμα

Οι πόροι MCP είναι στατικά δεδομένα που ο παράγοντας μπορεί να διαβάσει ανά πάσα στιγμή χωρίς να κάνει κλήσεις στο API της Frihet. Δεν καταναλώνουν ποσόστωση, δεν απαιτούν πρόσθετη πιστοποίηση και είναι διαθέσιμα από τη στιγμή που ο διακομιστής συνδέεται.

Η v1.2 εισάγει 5 πόρους:

frihet://api/schema

Σύνοψη όλων των διαθέσιμων endpoints, μεθόδων πιστοποίησης και ορίων ρυθμού. Όταν ένας παράγοντας χρειάζεται να μάθει τι μπορεί να κάνει με τη Frihet, συμβουλεύεται αυτόν τον πόρο αντί να το ανακαλύπτει με δοκιμή και λάθος.

frihet://tax/rates

Ισχύοντες φορολογικοί συντελεστές στην Ισπανία: Γενικός IVA (21%), μειωμένος (10%) και υπερ-μειωμένος (4%)· IGIC Καναρίων Νήσων (7%, 3%, 0%)· παρακρατήσεις IRPF. Ο παράγοντας έχει αυτό το πλαίσιο πριν δημιουργήσει ένα τιμολόγιο ή καταγράψει ένα έξοδο. Δεν χρειάζεται να σας ρωτήσει ποιον IVA να εφαρμόσει εάν ήδη γνωρίζει πού δραστηριοποιείται η επιχείρησή σας.

frihet://tax/calendar

Ημερομηνίες υποβολής τριμηνιαίων δηλώσεων: Έντυπο 303 (IVA), Έντυπο 130 (IRPF), Έντυπο 420 (IGIC). Όταν ο παράγοντας προετοιμάζει ένα τριμηνιαίο κλείσιμο, γνωρίζει ακριβώς πότε λήγει κάθε υποχρέωση.

frihet://config/expense-categories

Οι 8 κατηγορίες εξόδων με τους κανόνες εκπιπτόμενων. Υλικά γραφείου, προμήθειες, μεταφορά, ημερήσια έξοδα, εκπαίδευση, ασφάλειες, επαγγελματικές υπηρεσίες, άλλα. Κάθε κατηγορία περιλαμβάνει το ποσοστό εκπιπτόμενων και τις ισχύουσες προϋποθέσεις.

frihet://config/invoice-statuses

Η ροή καταστάσεων ενός τιμολογίου: προσχέδιο, εκδόθηκε, απεστάλη, εισπράχθηκε, ληξιπρόθεσμο, ακυρώθηκε. Κάθε κατάσταση περιλαμβάνει τις επιτρεπόμενες μεταβάσεις και τα triggers που μπορούν να ενεργοποιηθούν (webhooks, ειδοποιήσεις). Ο παράγοντας γνωρίζει ποιες ενέργειες είναι έγκυρες ανά πάσα στιγμή.

Προτροπές: καθοδηγούμενες ροές εργασίας

Ένα εργαλείο εκτελεί μια λειτουργία. Μια προτροπή ενορχηστρώνει πολλές λειτουργίες σε μια συνεκτική ροή. Η διαφορά είναι να περάσουμε από το “δημιούργησε αυτό το έξοδο” στο “επεξεργάσου αυτά τα 15 δελτία εξόδων, κατηγοριοποίησέ τα, εφάρμοσε τους σωστούς φόρους και επιβεβαίωσε πριν τη δημιουργία”.

Η v1.2 περιλαμβάνει 5 προτροπές:

monthly-close

Καθοδηγούμενο μηνιαίο κλείσιμο. Ο παράγοντας ελέγχει εκκρεμή τιμολόγια προς είσπραξη, κατηγοριοποιεί μη εκχωρημένα έξοδα, επαληθεύει ότι οι φορολογικές υποχρεώσεις της περιόδου καλύπτονται και δημιουργεί μια σύνοψη. Μια ροή που κανονικά απαιτεί μία ώρα χειροκίνητης αναθεώρησης, εκτελείται σε μια συνομιλία.

onboard-client

Εγγραφή νέου πελάτη. Καθορίζει τον φορολογικό συντελεστή ανάλογα με την τοποθεσία του πελάτη (IVA χερσαίας Ισπανίας, IGIC Καναρίων Νήσων, ενδοκοινοτικό), δημιουργεί την εγγραφή με τα σωστά φορολογικά στοιχεία και δημιουργεί μια προσφορά καλωσορίσματος. Όλα σε μια ακολουθία.

quarterly-tax-prep

Τριμηνιαία προετοιμασία φόρων. Συλλέγει όλα τα τιμολόγια της περιόδου, υπολογίζει τις φορολογικές βάσεις IVA ή IGIC, εφαρμόζει τις παρακρατήσεις IRPF και δημιουργεί μια προεπισκόπηση του Εντύπου 303 ή 130. Ο παράγοντας κάνει τη δουλειά· εσείς ή ο λογιστής σας επικυρώνετε το αποτέλεσμα.

overdue-followup

Παρακολούθηση ληξιπρόθεσμων τιμολογίων. Αναγνωρίζει όλα τα εκπρόθεσμα τιμολόγια, τα ομαδοποιεί ανά πελάτη, υπολογίζει το συνολικό οφειλόμενο ποσό για κάθε έναν και συντάσσει εξατομικευμένα μηνύματα είσπραξης. Από το “πρέπει να ελέγξω τι μου οφείλουν” στο “εδώ έχεις τα προσχέδια έτοιμα προς αποστολή”.

expense-batch

Επεξεργασία εξόδων κατά παρτίδες. Λαμβάνει μια λίστα εξόδων, τα κατηγοριοποιεί σύμφωνα με τους ρυθμισμένους κανόνες, εφαρμόζει τους αντίστοιχους φόρους, επαληθεύει την εκπιπτόμενων του καθενός και τα δημιουργεί με προηγούμενη επιβεβαίωση. Ιδανικό για την επεξεργασία συσσωρευμένων αποδείξεων μιας εβδομάδας ή ενός ταξιδιού.

Δομημένη έξοδος: αναλύσιμες απαντήσεις

Μέχρι τώρα, οι απαντήσεις του διακομιστή MCP ήταν μορφοποιημένο κείμενο. Χρήσιμο για ανθρώπινη ανάγνωση, αλλά οι παράγοντες χρειάζονται δομημένα δεδομένα για να λάβουν προγραμματικές αποφάσεις.

Η v1.2 προσθέτει outputSchema και structuredContent σε κάθε εργαλείο. Κάθε απάντηση περιλαμβάνει ένα σχήμα JSON που περιγράφει ακριβώς τη δομή των δεδομένων που επιστρέφονται. Ο παράγοντας γνωρίζει πριν καλέσει ποια πεδία θα λάβει, τι τύπου είναι και ποια είναι προαιρετικά.

Αυτό είναι που επιτρέπει σε μια προτροπή όπως το quarterly-tax-prep να συνδέει 4 λειτουργίες με αξιόπιστο τρόπο: κάθε βήμα παράγει δεδομένα με γνωστή δομή που το επόμενο βήμα μπορεί να καταναλώσει χωρίς αμφισημία.

Για τους προγραμματιστές που δημιουργούν ενσωματώσεις στον διακομιστή MCP, αυτό εξαλείφει την ανάγκη για ανάλυση ελεύθερου κειμένου. Η απάντηση έχει πάντα την ίδια μορφή.

Σημειώσεις ασφαλείας

Κάθε εργαλείο του διακομιστή MCP περιλαμβάνει πλέον σημειώσεις που υποδεικνύουν εάν η λειτουργία είναι μόνο για ανάγνωση ή καταστροφική. Ένα list-invoices επισημαίνεται ως ανάγνωσης. Ένα delete-expense επισημαίνεται ως καταστροφικό.

Αυτό επιτρέπει στους παράγοντες να εφαρμόζουν πολιτικές επιβεβαίωσης. Ένας παράγοντας μπορεί να εκτελέσει λειτουργίες ανάγνωσης χωρίς να ρωτήσει, αλλά να ζητήσει ρητή επιβεβαίωση πριν διαγράψει ή τροποποιήσει δεδομένα. Η ασφάλεια δεν εξαρτάται από τον παράγοντα — καθορίζεται από τον διακομιστή.

Καθολική εγκατάσταση

Ο διακομιστής εγκαθίσταται με μία μόνο εντολή σε οποιονδήποτε συμβατό παράγοντα:

npx @frihet/mcp-server

Λειτουργεί σε Claude Code, Claude Desktop, Cursor, Windsurf, Cline, Codex και οποιονδήποτε πελάτη MCP. Για παράγοντες που υποστηρίζουν εγκατάσταση μέσω δεξιοτήτων:

npx skills add Frihet-io/frihet-mcp

Και οι δύο μέθοδοι παρέχουν πρόσβαση στα 30+ εργαλεία, τους 5 πόρους, τις 5 προτροπές και τη δομημένη έξοδο.

Αποθετήριο υπό Frihet-io

Ο διακομιστής MCP έχει μεταφερθεί στην οργάνωση Frihet-io στο GitHub. Η διεύθυνση URL του αποθετηρίου είναι τώρα github.com/Frihet-io/frihet-mcp. Οι προηγούμενες συνδέσεις ανακατευθύνουν αυτόματα.

Το πακέτο npm παραμένει @frihet/mcp-server. Δεν υπάρχουν αλλαγές στην εγκατάσταση.

Για ποιους είναι αυτή η ενημέρωση

Επαγγελματίες που χρησιμοποιούν ήδη τον διακομιστή MCP κερδίζουν Πόρους ως αυτόματο φορολογικό πλαίσιο και Προτροπές ως ροές που εκτελούσαν προηγουμένως βήμα προς βήμα χειροκίνητα.

Προγραμματιστές που δημιουργούν εφαρμογές με τη Frihet κερδίζουν δομημένη έξοδο για ντετερμινιστικές ενσωματώσεις και σημειώσεις ασφαλείας για πολιτικές επιβεβαίωσης.

Λογιστικά γραφεία και φορολογικοί σύμβουλοι κερδίζουν συγκεκριμένες προτροπές για τις ροές εργασίας τους: μηνιαίο κλείσιμο, τριμηνιαία προετοιμασία, παρακολούθηση εισπράξεων.

Κάθε επιχείρηση που χρησιμοποιεί παράγοντες AI κερδίζει έναν διακομιστή MCP που όχι μόνο εκτελεί λειτουργίες, αλλά γνωρίζει και πώς να τις συνδέσει σε πραγματικές επιχειρηματικές ροές.

Πώς να ενημερώσετε

Εάν χρησιμοποιείτε npx @frihet/mcp-server, έχετε ήδη την τελευταία έκδοση. Εάν έχετε μια σταθερή εγκατάσταση:

npm update @frihet/mcp-server

Δεν υπάρχουν αλλαγές που να διακόπτουν τη συμβατότητα. Όλα τα υπάρχοντα εργαλεία διατηρούν τη διεπαφή τους. Οι πόροι, οι προτροπές και η δομημένη έξοδος είναι καθαρές προσθήκες.

Η πλήρης τεκμηρίωση βρίσκεται στο docs.frihet.io/desarrolladores. Ο πηγαίος κώδικας στο GitHub (Frihet-io/frihet-mcp). Το πακέτο στο npm ως @frihet/mcp-server.