Διακομιστής MCP

Το Nordlet παρέχει το Model Context Protocol στη διεύθυνση https://api.nordlet.com/mcp. Ένας βοηθός τεχνητής νοημοσύνης συνδεδεμένος σε αυτό μπορεί να αναζητήσει στο API, να διαβάσει το σχήμα αιτήματος (request schema) οποιασδήποτε λειτουργίας και να την καλέσει, χρησιμοποιώντας το ίδιο κλειδί API, εταιρεία και δικαιώματα (scopes) όπως και σε μια απευθείας αίτηση. Κάθε κλήση εργαλείου αποτελεί μια συνηθισμένη αίτηση API: ελέγχεται η ταυτότητά της, υπόκειται σε περιορισμό ρυθμού (rate limiting) και χρεώνεται ανάλογα, ενώ μια τροποποιητική κλήση μεταβάλλει τα λογιστικά βιβλία της εταιρείας.

Σύνδεση

Το τελικό σημείο (endpoint) επικοινωνεί μέσω Streamable HTTP και η αυθεντικοποίησή του γίνεται με το κλειδί API Bearer από τον Οδηγό ξεκινήματος. Στο Claude Code:

claude mcp add --transport http nordlet https://api.nordlet.com/mcp --header "Authorization: Bearer nl_..."

Οποιοσδήποτε άλλος πελάτης MCP δέχεται την ίδια διεύθυνση URL και κεφαλίδα. Ένα κλειδί περιορισμένο στο *:read μπορεί να καλέσει μόνο τις λειτουργίες ανάγνωσης, ενώ τα εργαλεία αναφέρουν τυχόν έλλειψη δικαιωμάτων ως σφάλμα 403 του API.

Εργαλεία

Τρία εργαλεία καλύπτουν κάθε λειτουργία του API:

Εργαλείο	Τι κάνει
search_operations	Εντοπίζει λειτουργίες με βάση λέξεις στο όνομα, τη διαδρομή (path), την περίληψη ή την περιγραφή τους, προαιρετικά εντός συγκεκριμένης ενότητας (sales, bank, reports, κ.λπ.). Χωρίς ερώτημα αναζήτησης, παραθέτει τις ενότητες.
describe_operation	Επιστρέφει τη μέθοδο, τη διαδρομή, την περιγραφή και το σχήμα αιτήματος JSON μιας λειτουργίας. Η παράμετρος includeResponse: true προσθέτει το σχήμα της απόκρισης 200.
call_operation	Εκτελεί μία λειτουργία με σώμα (body) JSON. Το σώμα της απόκρισης επιστρέφεται ως JSON, ενώ μια απάντηση 4xx ή 5xx επιστρέφεται ως σφάλμα εργαλείου που περιέχει τον κωδικό κατάστασης και το φάκελο σφάλματος. Μια προαιρετική παράμετρος idempotencyKey αποστέλλεται ως κεφαλίδα Idempotency-Key, ώστε μια επαναλαμβανόμενη κλήση με το ίδιο κλειδί να αναπαράγει την πρώτη απάντηση αντί να επαναλάβει το αποτέλεσμα.

Οι πιο συχνά χρησιμοποιούμενες λειτουργίες διατίθενται επίσης ως απευθείας εργαλεία με τα δικά τους σχήματα αιτημάτων, ώστε ο βοηθός να βλέπει τα πεδία τους χωρίς να απαιτείται αναζήτηση: partners_list, partners_get, partners_create, partners_find_or_create, catalog_items_list, sales_invoices_list, sales_invoices_get, sales_invoices_create, sales_invoices_issue, sales_invoices_send, purchases_invoices_list, purchases_invoices_create, purchases_invoices_register, bank_transactions_list, bank_transactions_import, bank_transactions_match, ledger_journal_transactions_list, reports_trial_balance, reports_financial_statements, reports_vat_summary και reports_debt_aging. Κάθε εργαλείο φέρει τις σχετικές επισημάνσεις MCP (readOnlyHint, destructiveHint) που ενημερώνουν τον πελάτη για το αν πραγματοποιεί εγγραφές.

Το ευρετήριο λειτουργιών και τα σχήματα παράγονται από την ίδια περιγραφή OpenAPI που χρησιμοποιείται στην αναφορά API και στα SDK, συνεπώς μια λειτουργία που προστίθεται στο API εμφανίζεται στη συνάρτηση search_operations ταυτόχρονα με την έκδοση που τη συμπεριλαμβάνει. Οι οδηγίες του διακομιστή υπενθυμίζουν στον βοηθό τους κανόνες λειτουργίας: τα ποσά είναι δεκαδικές συμβολοσειρές (decimal strings), οι λίστες δέχονται page, pageSize, sort και filter, ενώ μια υποβολή που αφορά συγκεκριμένη χώρα επιστρέφει 422 για εταιρεία που βρίσκεται εκτός αυτής της χώρας.