Συνδέετε τον Claude με λογισμικό επιχειρήσεων προσθέτοντας τον διακομιστή MCP του συστήματος ως προσαρμοσμένο συνδετήρα: ανοίξτε την επιλογή Προσαρμογή, στη συνέχεια Συνδετήρες, επιλέξτε Προσθήκη προσαρμοσμένου συνδετήρα, επικολλήστε το HTTPS URL του διακομιστή και συνδεθείτε όταν ο Claude ανοίξει τη σελίδα OAuth του συστήματος. Από εκεί και πέρα, ο Claude ανακτά τη λίστα εργαλείων που προσφέρει το σύστημα σε εσάς και τα καλεί ως εσείς όταν τα χρειάζεται. Στον Claude Code η ίδια σύνδεση είναι μία εντολή, claude mcp add --transport http, ακολουθούμενο από /mcp για να συνδεθείτε.
Η προϋπόθεση είναι ότι το λογισμικό διαθέτει έναν διακομιστή MCP. Πολλά συστήματα δεν το έχουν ακόμη, και μια REST API από μόνη της δεν είναι αρκετή για αυτήν την πορεία. Όπου υπάρχει διακομιστής, η σύνδεση γίνεται ως συγκεκριμένο άτομο, οπότε αυτό που μπορεί να κάνει ο Claude είναι ακριβώς αυτό που μπορεί να κάνει αυτό το άτομο, και το σύστημα, όχι ο Claude, είναι αυτό που το επιβάλλει.
Τι είναι πραγματικά η σύνδεση
Εμπλέκονται τρία μέρη, και η ονομασία τους αποφεύγει τις περισσότερες συγχύσεις αργότερα. Ο οικοδεσπότης είναι η εφαρμογή Claude. Μέσα σε αυτήν, δημιουργείται ένας πελάτης για κάθε διακομιστή που συνδέεστε, και αυτός ο πελάτης μιλάει με ακριβώς έναν διακομιστή. Ο διακομιστής είναι το σημείο MCP του επιχειρηματικού συστήματος, μια μοναδική διεύθυνση HTTPS που δέχεται μηνύματα JSON-RPC. Οι πελάτες του Claude εκτελούνται στο cloud της Anthropic, όχι στον υπολογιστή σας, γι' αυτό και ο διακομιστής πρέπει να είναι προσβάσιμος από το δημόσιο διαδίκτυο; ένα σύστημα σε ιδιωτικό δίκτυο χρειάζεται τις διευθύνσεις της Anthropic να είναι επιτρεπτές πριν από οποιαδήποτε από αυτά λειτουργήσει.
Η διεύθυνση URL είναι το μόνο πράγμα που χρειάζεται να γνωρίζετε εκ των προτέρων. Για έναν χώρο εργασίας Sois, είναι η διεύθυνση του χώρου εργασίας ακολουθούμενη από /api/mcpΆλλα προϊόντα δημοσιεύουν τα δικά τους στην τεκμηρίωσή τους; ένα που τελειώνει σε /sse Άλλα προϊόντα δημοσιεύουν τις δικές τους στην τεκμηρίωσή τους; μία που τελειώνει σε
Η διαδικασία, λεπτό προς λεπτό
- Επικολλήστε τη διεύθυνση URLΣτο Claude, ανοίξτε την προσαρμογή, στη συνέχεια τους συνδέσμους, επιλέξτε Προσθήκη προσαρμοσμένου συνδέσμου, δώστε του ένα όνομα και επικολλήστε τη διεύθυνση HTTPS του διακομιστή. Στο Claude Code, εκτελέστε την εντολή mcp add αντί αυτού.
- Ο Claude ερευνά τον διακομιστήΟ Claude στέλνει ένα αίτημα χωρίς διαπιστευτήρια. Ένας προστατευμένος διακομιστής απαντά με 401 με μια κεφαλίδα WWW-Authenticate που δείχνει στα μεταδεδομένα του προστατευμένου πόρου του. Ο Claude το διαβάζει και σημειώνει τις ρυθμίσεις επαλήθευσης ταυτότητας που ανίχνευσε.
- Ο Claude βρίσκει τον διακομιστή εξουσιοδότησηςΤα μεταδεδομένα ορίζουν τον διακομιστή εξουσιοδότησης. Ο Claude ανακτά τα δικά του μεταδεδομένα του διακομιστή για να μάθει τα σημεία πρόσβασης εξουσιοδότησης, token και εγγραφής, καθώς και τη μέθοδο PKCE που απαιτεί.
- Ο Claude αυτοπροσδιορίζεταιΟ Claude είτε παρουσιάζει το έγγραφο μεταδεδομένων πελάτη που φιλοξενείται από την Anthropic, είτε εγγράφεται δυναμικά, είτε χρησιμοποιεί ένα αναγνωριστικό πελάτη που εισάγατε. Δεν χρειάζεται να κάνετε τίποτα εκτός αν επιλέξατε την τελευταία επιλογή.
- Συνδέεστε και δίνετε τη συγκατάθεσή σαςΟ Claude ανοίγει τη σελίδα σύνδεσης του συστήματος στον περιηγητή σας. Αυτοεπιβεβαιώνεστε και εγκρίνετε τις επιτρεπόμενες ενέργειες που εμφανίζονται. Το σύστημα ανακατευθύνει πίσω με έναν κωδικό, ο Claude τον ανταλλάσσει με ένα διακριτικό που είναι δεσμευμένο σε αυτόν τον διακομιστή και κρατά το διακριτικό ανανέωσης.
- Ο Claude παραθέτει τα εργαλείαΜε το διακριτικό συνδεδεμένο, ο Claude καλεί το tools/list και λαμβάνει τα εργαλεία που προσφέρει αυτό το σύστημα σε εσάς. Εμφανίζονται κάτω από τον συνδετήρα, το καθένα με μια άδεια που μπορείτε να ρυθμίσετε.
- Πρώτη αίτησηΖητήστε κάτι. Ο Claude επιλέγει τα εργαλεία, ζητά έγκριση στην πρώτη κλήση για το καθένα εκτός αν επιλέξατε Πάντα να επιτρέπεται, και το σύστημα ελέγχει την κλήση σε σχέση με τις άδειές σας πριν κάνει οτιδήποτε.
Τα βήματα δύο έως πέντε είναι η ροή OAuth 2.1 που απαιτεί η προδιαγραφή εξουσιοδότησης MCP από τους διακομιστές HTTP, και ο λόγος που δεν υπάρχει διακριτικό για να επικολλήσετε. Η πρόκληση 401 φαίνεται έτσι στο δίκτυο, με τη διεύθυνση μεταδεδομένων και, προαιρετικά, τις επιτρεπόμενες ενέργειες που θέλει ο διακομιστής.
HTTP/1.1 401 Unauthorized
WWW-Authenticate: Bearer resource_metadata="https://acme.sois.ai/.well-known/oauth-protected-resource",
scope="mcp"Η πρόκληση που επιστρέφει ένα workspace Sois σε έναν μη αυθεντικοποιημένο πελάτη. Ο πελάτης ακολουθεί τη διεύθυνση resource_metadata για να ανακαλύψει τον διακομιστή εξουσιοδότησης; η τιμή του πεδίου είναι η ελάχιστη άδεια που θα πρέπει να ζητήσει πρώτα.
Δύο κανόνες πρωτοκόλλου σας προστατεύουν εδώ χωρίς τη συμμετοχή σας. Ο πελάτης πρέπει να ζητήσει ένα διακριτικό για αυτόν τον συγκεκριμένο διακομιστή, χρησιμοποιώντας την παράμετρο πόρου από το RFC 8707, και ο διακομιστής πρέπει να απορρίψει τα διακριτικά που εκδίδονται για οτιδήποτε άλλο, έτσι ώστε ένα διακριτικό για ένα σύστημα να μην μπορεί να επαναχρησιμοποιηθεί σε άλλο. Και ο διακομιστής δεν πρέπει ποτέ να μεταβιβάσει το διακριτικό σας σε μια τρίτη υπηρεσία. Η προδιαγραφή τα θεωρεί και τα δύο ως αυστηρές απαιτήσεις, όχι συστάσεις.
Επιλέγοντας τη μέθοδο σύνδεσης
Η διαλογική οθόνη Προσθήκη προσαρμοσμένου συνδετήρα του Claude προσφέρει ένα μικρό σύνολο επιλογών μόλις έχει ελέγξει τη διεύθυνση URL. Οι περισσότεροι άνθρωποι δεν αλλάζουν ποτέ αυτό που ανιχνεύει, αλλά είναι χρήσιμο να γνωρίζετε τι σημαίνει το καθένα, επειδή οι ρυθμίσεις αυθεντικοποίησης δεν μπορούν να επεξεργαστούν αργότερα; για να τις αλλάξετε, αφαιρείτε τον συνδετήρα και τον προσθέτετε ξανά.
| Ρύθμιση | Επιλογές | Πότε να χρησιμοποιήσετε |
|---|---|---|
| Επαλήθευση | Πάντα απαιτείται; Απαιτείται όταν το διακομιστή ζητά; Καμία | Πάντα απαιτείται για οτιδήποτε ενεργεί ως άτομο. Καμία μόνο για έναν εσωτερικό διακομιστή μόνο για ανάγνωση, με το API key τοποθετημένο στα headers αιτήσεων. |
| OAuth πελάτης | Μεταδεδομένα πελάτη φιλοξενούμενου από την Anthropic; αυτόματη εγγραφή; το δικό σας client ID | Το φιλοξενούμενο έγγραφο συνιστάται όταν ο διακομιστής το υποστηρίζει. Η αυτόματη εγγραφή λειτουργεί με τους περισσότερους διακομιστές αλλά συσσωρεύει εγγραφές. Το δικό σας ID όταν το σύστημα επιμένει σε προεγγραφή. |
| Headers αιτήσεων | Έως τέσσερις σταθερούς headers όπως x-api-key | Κοινές διαπιστεύσεις για έναν λογαριασμό υπηρεσίας, ή έναν header δρομολόγησης που χρειάζεται μια πύλη. Σε beta και δεν εμφανίζεται σε κάθε οργανισμό. |
| Μεταφορά | Ορισμός από το URL | Αφήστε το. Ένα URL που τελειώνει σε /sse επιλέγει τη παλαιότερη μεταφορά; αλλάξτε το μόνο αν η τεκμηρίωση του διακομιστή το λέει. |
Για ένα επιχειρηματικό σύστημα, η σωστή απάντηση είναι σχεδόν πάντα η προεπιλογή: OAuth, πάντα απαιτούμενο, μία είσοδος ανά άτομο. Οι κοινές κεφαλίδες κάνουν κάθε ενέργεια να φαίνεται σαν τον ίδιο χρήστη στο αρχείο καταγραφής.
Για τα σχέδια Team και Enterprise, το σχήμα είναι το ίδιο με ένα επιπλέον βήμα: ένας ιδιοκτήτης προσθέτει τον σύνδεσμο στις ρυθμίσεις Οργάνωσης, και κάθε μέλος στη συνέχεια συνδέεται και εισέρχεται ως τον εαυτό του στις Ρυθμίσεις. Ο ιδιοκτήτης αποφασίζει ποιοι διακομιστές υπάρχουν; οι ενέργειες του μέλους εξακολουθούν να φέρουν την εξουσία του μέλους.
Τι βλέπει ο Claude μετά τη σύνδεση
Η λίστα εργαλείων είναι ολόκληρη η διεπαφή. Κάθε καταχώρηση έχει ένα όνομα, μια περιγραφή και ένα σχήμα εισόδου, και το μοντέλο του Claude χρησιμοποιεί τις περιγραφές για να αποφασίσει ποιο εργαλείο χρειάζεται μια αίτηση και το σχήμα για να συμπληρώσει τα επιχειρήματα. Σε έναν χώρο εργασίας Sois, η λίστα φιλτράρεται με βάση τον ρόλο σας και τις εφαρμογές που είναι εγκατεστημένες πριν επιστραφεί, έτσι ώστε ένας χρήστης χρηματοοικονομικών να βλέπει εργαλεία όπως: αναζήτησηΤιμολογίων, δημιουργίαΤιμολογίου, καταγραφήΠληρωμής and αποστολήΥπενθυμίσεωνΤιμολογίων, μαζί με τις επαφές, το inbox, το ημερολόγιο και τα εργαλεία εργασιών που έχει ο καθένας, και δεν βλέπει καθόλου τα διοικητικά εργαλεία. Η προδιαγραφή επιτρέπει ακριβώς αυτό: ένας διακομιστής μπορεί να ποικίλει τη λίστα ανάλογα με τα διαπιστευτήρια στην αίτηση.
Ο Claude στη συνέχεια προσθέτει τους δικούς του ελέγχους από πάνω. Κάτω από τον σύνδεσμο μπορείτε να ορίσετε οποιοδήποτε εργαλείο σε αποκλεισμένο, έτσι ώστε το μοντέλο να μην το βλέπει ποτέ. Στη συνομιλία, κάθε κλήση εργαλείου ζητά έγκριση εκτός αν έχετε επιλέξει Πάντα επιτρέπεται για αυτό το εργαλείο, το οποίο η Anthropic προτείνει να διατηρείτε για διακομιστές που εμπιστεύεστε. Οι δυνατότητες έρευνας μπορούν να ενεργοποιήσουν εργαλεία σύνδεσης χωρίς να ρωτήσουν, έτσι ώστε η καθοδήγηση να είναι να απενεργοποιήσετε τα εργαλεία εγγραφής στον σύνδεσμο ενώ είναι σε εξέλιξη μια έρευνα.
Η ίδια σύνδεση από τον Claude Code και το API
Στον Claude Code, η εντολή είναι claude mcp add --transport http sois https://your-workspace.sois.ai/api/mcpΟ διακομιστής αποθηκεύεται σε τοπικό πεδίο από προεπιλογή; --πεδίο έργου το γράφει σε ένα .mcp.json μπορείς να κάνεις commit για την ομάδα, και --πεδίο χρήστη το καθιστά διαθέσιμο σε κάθε έργο. Εκτέλεσε /mcp για να συνδεθείς μέσω του προγράμματος περιήγησης, ή claude mcp login sois από το shell. Οι συνδετήρες που έχουν ήδη προστεθεί στο claude.ai εμφανίζονται αυτόματα στον Claude Code υπό τον ίδιο λογαριασμό, και οι διαχειριστές μπορούν να επισημάνουν μεμονωμένα εργαλεία ως ζητούμενα ή αποκλεισμένα.
Η API Μηνυμάτων είναι διαφορετική στην κατηγορία. Ο σύνδεσμος MCP της, σε beta πίσω από τον mcp-client-2025-11-20 κεφαλίδα, λαμβάνει το URL του διακομιστή σε ένα mcp_servers entry and an mcp_toolset Η API Μηνυμάτων είναι διαφορετική κατηγορία. Ο σύνδεσμος MCP της, σε beta πίσω από το token εξουσιοδότησης, ανανεώνοντάς το κατά περίπτωση. Αυτό ταιριάζει σε μια υπηρεσία που διαχειρίζεστε εκ μέρους χρηστών που έχετε ήδη επαληθεύσει την ταυτότητά τους. Είναι λάθος προσέγγιση να δώσετε σε έναν τελικό χρήστη μια σύνδεση, για αυτό υπάρχει ο προσαρμοσμένος συνδετήρας.
Τι επιτρέπεται να κάνει ο Claude
Μετά την περιήγηση, η χρήσιμη ερώτηση δεν είναι αν ο Claude είναι συνδεδεμένος, αλλά τι μπορεί να κάνει η σύνδεση, και η απάντηση καθορίζεται από τον διακομιστή. Στο Sois, η απάντηση είναι τα δικαιώματα ενός ατόμου, που επιβάλλονται δύο φορές: μία φορά όταν συντάσσεται η λίστα εργαλείων, μία φορά όταν εκτελείται κάθε κλήση. Το διακριτικό εκδόθηκε σε εσάς, οπότε κάθε ενέργεια αποδίδεται σε εσάς στο αρχείο καταγραφής του χώρου εργασίας με τις εισόδους και το αποτέλεσμα της, ακριβώς όπως θα γινόταν για ένα άτομο. Η δαπάνη περιορίζεται ανά ενσωμάτωση όπου ο δικός σας πράκτορας του χώρου εργασίας εκτελεί εργασία; όταν ο Claude κάνει τη λογική, όπως κάνει μέσω αυτής της σύνδεσης, ο χώρος εργασίας δεν εκτελεί καμία AI εκ μέρους σας και δεν χρεώνει τίποτα γι' αυτό.
Αυτό είναι που καθιστά λογικό να επιτρέπεται σε ένα μοντέλο να ενεργεί: οι άδειες είναι αυτές που διατηρεί ήδη η επιχείρηση για τους ανθρώπους, και η σύνδεση τις κληρονομεί.
Όταν κάτι πάει στραβά
- Η είσοδος επαναλαμβάνεται ή αποτυγχάνει. Σχεδόν πάντα η διεύθυνση URL: μια διαδρομή που δεν είναι το σημείο τερματισμού MCP ή ένας διακομιστής που δεν είναι προσβάσιμος από το δημόσιο διαδίκτυο. Ελέγξτε τη διεύθυνση σύμφωνα με την τεκμηρίωση του συστήματος και επιβεβαιώστε ότι απαντά με 401 και κεφαλίδα WWW-Authenticate.
- Λείπουν εργαλεία. Η λίστα φιλτράρεται με βάση τον ρόλο σας. Αν ένας συνάδελφος βλέπει ένα εργαλείο που εσείς δεν βλέπετε, η διαφορά είναι τα δικαιώματα στο επιχειρηματικό σύστημα, όχι ο σύνδεσμος.
- Η κλήση απορρίπτεται. Διαβάστε το σφάλμα που αναφέρει ο Claude. Μια άρνηση άδειας σημαίνει ότι το άτομο που συνδεθήκατε δεν μπορεί να το κάνει αυτό; ένα σφάλμα επικύρωσης σημαίνει ότι το μοντέλο μπορεί να διορθώσει την είσοδο και να προσπαθήσει ξανά.
Ερωτήσεις που κάνουν οι άνθρωποι
Πρέπει να επικολλήσω ένα API key ή token στον Claude;
Όχι για έναν διακομιστή που υποστηρίζει OAuth. Ο Claude ανακαλύπτει τον διακομιστή εξουσιοδότησης από την πρόκληση 401 και ανοίγει μια σελίδα σύνδεσης; το token εκδίδεται στον Claude και ανανεώνεται αυτόματα. Οι σταθερές κεφαλίδες ισχύουν μόνο για διακομιστές που δεν έχουν OAuth, και τα κοινά διαπιστευτήρια χάνουν την αναγνώριση ανά άτομο.
Μπορώ να συνδέσω λογισμικό που έχει μόνο REST API;
Όχι μέσω αυτού του μονοπατιού. Οι προσαρμοσμένοι συνδετήρες του Claude μιλούν MCP. Κάποιος πρέπει να τοποθετήσει έναν διακομιστή MCP μπροστά από το API, κάτι που κάνουν οι πλατφόρμες όπως η Sois για ολόκληρη την επιφάνεια εργαλείων τους.
Λειτουργεί η σύνδεση από τον Claude στο τηλέφωνό μου;
Η τεκμηρίωση της Anthropic αναφέρει τον Claude web, την επιτραπέζια εφαρμογή και το Cowork για προσαρμοσμένους συνδετήρες. Επειδή ο πελάτης εκτελείται στο cloud της Anthropic και όχι στη συσκευή, ένας συνδετήρας που προστίθεται στο web δεν είναι συνδεδεμένος με μια μηχανή.
Τι μπορεί να κάνει ο Claude μόλις συνδεθεί;
Οτιδήποτε μπορεί να κάνει το άτομο που συνδέθηκε σε αυτό το σύστημα, εφόσον ο διακομιστής επιβάλλει άδειες σε κάθε κλήση. Στην Sois αυτό σημαίνει τα εργαλεία του ρόλου σας σε επαφές, εισερχόμενα, λογιστικά, καθήκοντα και τα υπόλοιπα, ελέγχονται όταν προσφέρονται και ξανά όταν εκτελούνται.
- Τεκμηρίωση Claude: συνδετικά τρίτων με απομακρυσμένο MCP το παράθυρο διαλόγου Προσθήκη προσαρμοσμένου συνδετήρα πεδίο προς πεδίο, και οι έλεγχοι ανά εργαλείο
- Προδιαγραφή Πρωτοκόλλου Στοιχείου Μοντέλου: εξουσιοδότηση η ροή OAuth 2.1, μεταδεδομένα προστατευόμενου πόρου, δείκτες πόρου και οι κανόνες του token
- Τεκμηρίωση Claude Code: διακομιστές MCP η εντολή προσθήκης claude mcp, πεδία και είσοδος
- Τεκμηρίωση Sois: ο διακομιστής χώρου εργασίας MCP το endpoint, τα έγγραφα ανακάλυψης και η φιλτράρισμα ρόλων όπως έχει υλοποιηθεί
Αυτό το άρθρο αναθεωρείται όταν αλλάζουν τα προϊόντα που περιγράφει. Επόμενη προγραμματισμένη αναθεώρηση: 4 Δεκεμβρίου 2026.