MCP για ERP: ένας πρακτικός οδηγός

Ξεκινήστε από τη συναλλαγή, όχι από τον πίνακα.

Η πρώτη αντίδραση όταν εκθέτετε ένα ERP είναι να δημιουργήσετε ένα εργαλείο ανά πίνακα με δημιουργία, ανάγνωση, ενημέρωση και διαγραφή σε κάθε ένα. Παράγει μια μεγάλη, ομοιόμορφη λίστα που ένα μοντέλο διαχειρίζεται κακά, γιατί ο επιχειρηματικός κανόνας ότι ένα τιμολόγιο χρειάζεται έναν φορολογικό συντελεστή σε κάθε γραμμή, ή ότι το απόθεμα δεν μπορεί να αποσταλεί πριν κρατηθεί, δεν υπάρχει πουθενά που το μοντέλο μπορεί να δει. Εκθέστε τις ενέργειες αντί αυτού. Ένας χρήσιμος έλεγχος είναι αν ένα άτομο θα μπορούσε να περιγράψει το εργαλείο ως κάτι που έκανε σήμερα: ανύψωσε ένα τιμολόγιο, κατέγραψε μια πληρωμή, μετέφερε μια συμφωνία, αναβολή μιας καταδίωξης. Κάθε ένα από αυτά φέρει τους κανόνες του, επικυρώνει τις εισόδους του και επιστρέφει ένα αναγνώσιμο αποτέλεσμα.

Παράλληλα με τις ενέργειες, προσθέστε έναν μικρό αριθμό εργαλείων συνοψίσεως που απαντούν στις ερωτήσεις που θέτει ένα μοντέλο πριν ενεργήσει. Μια κλήση που επιστρέφει το προφίλ ενός λογαριασμού, την κατάσταση, τα ανοιχτά στοιχεία και την πρόσφατη ιστορία εξοικονομεί στο μοντέλο τέσσερις κλήσεις και αρκετές χιλιάδες tokens συμφραζομένων, και καθιστά την επόμενη ενέργεια καλύτερα ενημερωμένη. Το Sois τα ονομάζει εργαλεία εξεταστών; εξέταση επαφής and λάβετε την περίληψη λογιστικών στοιχείων είναι δύο. Διατηρήστε επίσης την συνολική επιφάνεια σε προοπτική: Ο Claude Code περιορίζει την έξοδο ενός διακομιστή ανά κλήση από προεπιλογή, και οι Claude και OpenAI προσφέρουν καθυστερημένη φόρτωση ή αναζήτηση εργαλείων για μεγάλες λίστες, έτσι ώστε ένας διακομιστής με αρκετές εκατοντάδες εργαλεία να πρέπει να τα επιστρέφει σε μια καθορισμένη σειρά (η προδιαγραφή το ζητάει ώστε οι πελάτες να μπορούν να τα αποθηκεύουν στην κρυφή μνήμη) και θα πρέπει να φιλτράρει κατά ρόλο πριν την καταχώριση.

Ονομασία εργαλείων ώστε ένα μοντέλο να επιλέγει το σωστό.

Η προδιαγραφή περιορίζει τα ονόματα ελαφρώς: ένα έως 128 χαρακτήρες, γράμματα, ψηφία, κάτω παύλα, παύλα και τελεία, ευαίσθητο σε πεζά-κεφαλαία, μοναδικό εντός του διακομιστή. Όλα τα υπόλοιπα είναι σύμβαση, και η σύμβαση που λειτουργεί είναι ένα ρήμα ακολουθούμενο από το επιχειρηματικό ουσιαστικό σε συνεπή περίπτωση, με τα ίδια ρήματα να σημαίνουν τα ίδια πράγματα παντού. Ένα μοντέλο που επιλέγει μεταξύ αναζήτησηΤιμολογίων, λάβετε τιμολόγιο and δημιουργίαΤιμολογίου επιλέγει μεταξύ μιας λίστας, μιας εγγραφής και μιας εγγραφής, και μαθαίνει αυτό το μοτίβο μία φορά για ολόκληρο τον διακομιστή.

Οι περιγραφές διαβάζονται από ένα μοντέλο υπό πίεση να δράσει, οπότε γράψτε τις ως οδηγίες. Δηλώστε τι κάνει το εργαλείο στην πρώτη πρόταση, στη συνέχεια τις προϋποθέσεις. Αν ένα αδελφικό εργαλείο είναι η σωστή επιλογή για μια κοντινή αίτηση, πείτε το με το όνομά του. Αν ένα πεδίο πρέπει να ρυθμιστεί για να είναι το αποτέλεσμα σωστό, πείτε το με ΚΕΦΑΛΑΙΑ αν χρειαστεί; Το εργαλείο τιμολόγησης της Sois λέει στο μοντέλο ότι ο συντελεστής φόρου πρέπει να ρυθμιστεί σε κάθε γραμμή και ότι οι ακριβείς συντελεστές προέρχονται από listTaxTypes, γιατί ένα τιμολόγιο χωρίς ΦΠΑ είναι μια χειρότερη αποτυχία από μια απορριφθείσα κλήση. Συμπεριλάβετε ένα παράδειγμα κλήσης. Όλα όσα χρειάζεται το μοντέλο για να καλέσει το εργαλείο σωστά θα πρέπει να είναι στο εργαλείο, γιατί ποτέ δεν θα ανοίξει την τεκμηρίωσή σας.

Ορισμός ενός παραδείγματος εργαλείου.

Αυτό είναι ένα εργαλείο τιμολόγησης της Sois όπως το λαμβάνει ο πελάτης από εργαλεία/λίστα, κομμένο στα πεδία που έχουν σημασία, με σημειώσεις και ένα σχήμα εξόδου προστιθέμενο με τη μορφή που ορίζει η τρέχουσα προδιαγραφή. Δείχνει το μοτίβο: ένα ρήμα-ουσιαστικό όνομα, μια περιγραφική οδηγία, ένα σχήμα του οποίου οι περιγραφές ιδιοτήτων κάνουν την πρόληψη σφαλμάτων του μοντέλου, και υποδείξεις που μπορεί να χρησιμοποιήσει ένας πελάτης για να αποφασίσει αν θα επιβεβαιώσει.

{
  "name": "createInvoice",
  "title": "Create invoice",
  "description": "Create a new invoice of any type and return the draft with its auto-generated number. TAX: set tax_rate on each line (for example 20 for 20% VAT); call listTaxTypes for this workspace's exact rates. If the user says 'plus VAT' you MUST set tax_rate or the invoice goes out with no VAT. To email the result use sendInvoice. Example: createInvoice({ type: \"sales_invoice\", contact_id: \"uuid\", currency: \"GBP\", lines: [{ description: \"Consulting\", quantity: 10, unit_price: 150 }] })",
  "inputSchema": {
    "type": "object",
    "properties": {
      "type": { "type": "string", "description": "sales_invoice, purchase_invoice, sales_credit_note or purchase_credit_note" },
      "contact_id": { "type": "string", "description": "Contact UUID (bill-to for sales, bill-from for purchases)" },
      "currency": { "type": "string", "description": "ISO code, for example GBP. Uses the workspace default if omitted" },
      "invoice_date": { "type": "string", "description": "ISO date. Defaults to today" },
      "reference": { "type": "string" },
      "lines": {
        "type": "array",
        "description": "Line items. Every line MUST carry the numeric unit_price the user asked for",
        "items": {
          "type": "object",
          "properties": {
            "description": { "type": "string" },
            "quantity": { "type": "number", "description": "Defaults to 1" },
            "unit_price": { "type": "number", "description": "NUMBER only: no currency symbols, no thousands separators. Use the exact amount stated; never guess or round" },
            "tax_rate": { "type": "number" },
            "discount_percent": { "type": "number" }
          },
          "required": ["description", "unit_price"]
        }
      }
    },
    "required": ["type"]
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "invoice_id": { "type": "string" },
      "number": { "type": "string" },
      "status": { "type": "string" },
      "total": { "type": "number" }
    },
    "required": ["invoice_id", "number", "status"]
  },
  "annotations": {
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": false,
    "openWorldHint": false
  }
}

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

Τρεις επιλογές σε αυτήν την ορισμό είναι σκόπιμες. Το αποτέλεσμα επιστρέφει έναν αναγνωριστικό που το μοντέλο πρέπει να μεταφέρει σε sendInvoice and καταγραφήΠληρωμής, which is the specification's recommended way to relate calls now that servers hold no session state. The tool creates a draft, not a posted invoice, so the write is additive and a person or a separate approval tool finalises it. And the output schema means an integration can read the number and total as data while the model reads the same result as text.

Προσαρμογή εργαλείων στον χρήστη.

Μέσω HTTP, ο καλών φτάνει με ένα OAuth access token δεσμευμένο στον διακομιστή σας, και αυτό το token προσδιορίζει ένα άτομο. Η προδιαγραφή επιτρέπει το αποτέλεσμα του εργαλεία/λίστα να ποικίλλει ανάλογα με τα διαπιστευτήρια στην αίτηση, οπότε η πρώτη απόφαση περιορισμού είναι να φιλτράρει τη λίστα με βάση τον ρόλο αυτού του ατόμου πριν την επιστροφή της: ένας χρήστης αποθήκης δεν λαμβάνει έγκριση τιμολογίουΗ λίστα δεν πρέπει να διαφέρει ανά σύνδεση ή ως παρενέργεια άλλων κλήσεων, μόνο με εξουσιοδότηση, που είναι αυτό που την καθιστά αποθηκεύσιμη.

Η δεύτερη απόφαση είναι να ελέγξετε ξανά κατά την εκτέλεση. Ένας πελάτης μπορεί να στείλει οποιαδήποτε κλήση θέλει, και ένα μοντέλο μπορεί να παραποιηθεί από κείμενο σε ένα αποτέλεσμα εργαλείου για να προσπαθήσει να το κάνει. Επίλυση του χρήστη από το token σε κάθε κλήση, έλεγχος της άδειας που απαιτεί το εργαλείο και απόρριψη με ένα σφάλμα εκτέλεσης εργαλείου που το μοντέλο μπορεί να διαβάσει. Διατηρήστε τους OAuth scopes χοντροκομμένους (η Sois εκδίδει scopes ανάγνωσης, εγγραφής και εκτός σύνδεσης) και αφήστε τους δικούς ρόλους του ERP να είναι το λεπτομερές όριο, επειδή αυτοί οι ρόλοι ήδη υπάρχουν, ήδη διατηρούνται και ήδη σημαίνουν κάτι για την επιχείρηση. Αποδώστε κάθε κλήση στο άτομο στο αρχείο με τα επιχειρήματα και το αποτέλεσμα, ώστε η εργασία ενός πράκτορα να είναι αναθεωρήσιμη ακριβώς όπως είναι και ενός ατόμου.

1. Το διακριτικό φτάνειΤο token φτάνει. Επικυρώστε την υπογραφή και ότι το κοινό είναι αυτός ο διακομιστής, όπως απαιτεί το RFC 8707; απορρίψτε οτιδήποτε άλλο με 401.
2. Επιλύστε το άτομοΕπιλύστε το άτομο. Χαρτογραφήστε το token σε έναν χρήστη στο χώρο εργασίας και φορτώστε τον ρόλο και τις εγκατεστημένες εφαρμογές τους.
3. Φιλτράρετε τη λίσταΕπιστρέψτε μόνο τα εργαλεία που μπορεί να χρησιμοποιήσει ο ρόλος, σε σταθερή σειρά, από τα εργαλεία/λίστα.
4. Ελέγξτε την κλήσηΣτα εργαλεία/κλήση, ελέγξτε ξανά την άδεια και αρνηθείτε με isError αν λείπει; τίποτα δεν εκτελείται.
5. Εκτελέστε και καταγράψτεΕκτελέστε τη συναλλαγή, μετρήστε την αν ο δικός σας πράκτορας έκανε τη λογική, και γράψτε την κλήση στο αρχείο ελέγχου κάτω από αυτό το άτομο.

Διαχείριση εγγραφών.

Ένα μοντέλο που λαμβάνει ένα ασαφές αποτέλεσμα θα καλέσει ξανά, και ένα που λαμβάνει ένα σφάλμα θα προσπαθήσει με μια διορθωμένη είσοδο. Σχεδιάστε γι' αυτό. Οι εγγραφές που δημιουργούν θα πρέπει να επιστρέφουν ένα handle και, όπου είναι δυνατόν, να δέχονται ένα κλειδί ιδεομορφίας ή ένα φυσικό κλειδί ώστε να ανιχνεύεται μια επανάληψη. Οι εγγραφές που αλλάζουν κατάσταση θα πρέπει να είναι σαφείς σχετικά με τη μετάβαση που εκτελούν και να απορρίπτουν αδύνατες με μια αναγνώσιμη αιτία: η καταγραφή μιας πληρωμής κατά ενός ανύπαρκτου τιμολογίου είναι μια είναιΣφάλμα αποτέλεσμα που το δηλώνει, όχι μια σιωπηλή μη-λειτουργία και όχι μια στοίβα παρακολούθησης. Ποτέ μην αφήνετε μια μερική εγγραφή; αν ένα εργαλείο πολλαπλών βημάτων δεν μπορεί να ολοκληρωθεί, αναστρέψτε και αναφέρετε.

• Προτιμήστε τα προσχέδια και τις εγκρίσεις. Κάντε τη δημιουργία προσθετική (ένα προσχέδιο) και δώστε στην ολοκλήρωση το δικό της εργαλείο με τη δική της άδεια, ώστε το καταστροφικό βήμα να είναι αυτό που επιβεβαιώνει ο πελάτης και ελέγχει ο ρόλος.
• Σημειώστε τα καταστροφικά εργαλεία. Ορίστε destructiveHint για κενά και διαγραφές και να το αναφέρετε στην περιγραφή; Ο Claude και ο ChatGPT χρησιμοποιούν τέτοιες ενδείξεις όταν αποφασίζουν να ρωτήσουν πριν καλέσουν.
• Ρωτήστε αντί να μαντέψετε. Όταν μια κλήση χρειάζεται μια απόφαση που το εργαλείο δεν μπορεί να πάρει, επιστρέψτε ένα αποτέλεσμα που απαιτεί είσοδο με ένα αίτημα για διευκρίνιση; ο πελάτης θέτει την ερώτηση στο άτομο και επαναλαμβάνει την κλήση με την απάντηση.
• Περιορίστε την ακτίνα έκρηξης. Περιορίστε τον ρυθμό ανά σύνδεση, θέστε ανώτατο όριο δαπανών ανά ενσωμάτωση όπου ο δικός σας πράκτορας κάνει λογική, και επικυρώστε κάθε είσοδο από τον διακομιστή ανεξάρτητα από το σχήμα, γιατί το σχήμα είναι συμβουλή στο μοντέλο, όχι επιβολή.

Δοκιμή της επιφάνειας με έναν πραγματικό πελάτη.

Ο επιθεωρητής MCP θα ασκήσει εργαλεία/λίστα and εργαλεία/κλήση και να ακολουθήσει τη ροή OAuth. Η πραγματική δοκιμή είναι ένα μοντέλο. Συνδέστε τον Claude ως προσαρμοσμένο συνδετήρα, ή τον ChatGPT σε λειτουργία προγραμματιστή, συνδεθείτε ως χρήστης με περιορισμένο ρόλο και ζητήστε ένα ρουτίνα αποτέλεσμα που χρειάζεται τρία ή τέσσερα εργαλεία. Παρακολουθήστε ποια εργαλεία επιλέγει και γιατί; μια λάθος επιλογή είναι σχεδόν πάντα πρόβλημα περιγραφής. Στη συνέχεια, συνδεθείτε ως χρήστης χωρίς μία από τις άδειες και επιβεβαιώστε ότι η εκτέλεση σταματά στην κατάλληλη κλήση με έναν λόγο που το μοντέλο επαναλαμβάνει.

Έτσι είναι χτισμένος και ελέγχεται ο διακομιστής χώρου εργασίας Sois: συναλλαγές ως εργαλεία, οδηγίες περιγραφές, μια λίστα φιλτραρισμένη κατά ρόλο, μια δεύτερη επιβεβαίωση σε κάθε κλήση, προσχέδια πριν από τις εγκρίσεις και ένα αρχείο που μπορεί να διαβάσει ένα άτομο. Οι προγραμματιστές που κατασκευάζουν εφαρμογές για την αγορά δημοσιεύουν εργαλεία στην ίδια λίστα υπό τους ίδιους κανόνες, έτσι ώστε μια εφαρμογή να είναι λειτουργική από οποιονδήποτε πράκτορα τη στιγμή που εγκαθίσταται. Το μοτίβο δεν είναι συγκεκριμένο για ένα προϊόν; οποιοδήποτε ERP που το υιοθετεί γίνεται κάτι που μπορεί να εκτελέσει ένας πράκτορας.

Ερωτήσεις που κάνουν οι άνθρωποι

Αυτό το άρθρο αναθεωρείται όταν αλλάζουν τα προϊόντα που περιγράφει. Επόμενη προγραμματισμένη αναθεώρηση: 4 Δεκεμβρίου 2026.