Δοκιμή εξωτερικής σύνδεσης MCP

Σημείωμα

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

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

Τι κάνει

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

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

Δοκιμάστε προτροπές όπως

Δεν ισχύει. Αυτό το εργαλείο καλείται αυτόματα όταν δοκιμάζετε μια σύνδεση από το widget διαχείρισης. Δεν καλείται πληκτρολογώντας μια προτροπή.

Τι θα δείτε στη συνομιλία

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

Χρήσιμες συμβουλές

• Πάντα να δοκιμάζετε πριν αποθηκεύσετε. Το στιγμιότυπο εργαλείου από μια επιτυχημένη δοκιμή απαιτείται για νέες εγγραφές.
• Το τεστ έχει τάιμ άουτ 15 δευτερολέπτων. Εάν ο διακομιστής αργεί να ανταποκριθεί, ενδέχεται να αποτύχει ακόμα και αν ο διακομιστής είναι τεχνικά προσβάσιμος.
• Οι αποτυχίες ελέγχου ταυτότητας συνήθως σημαίνουν ότι το διαμορφωμένο εύρος ελέγχου ταυτότητας δεν ταιριάζει με την εγγραφή της εφαρμογής Entra του διακομιστή.
• Εάν μια δοκιμή είναι επιτυχής, σφραγίζει επίσης μια χρονική σήμανση "τελευταία δοκιμή" στην εγγραφή εγγραφής.

Τι συμβαίνει στη συνέχεια

Μετά από μια επιτυχημένη δοκιμή, μπορείτε:

• Αποθηκεύστε αυτήν την εγγραφή.
• Εξετάστε τα εργαλεία που παρέχει αυτός ο διακομιστής.

Αλλάζει αυτό τα δεδομένα;

Ναι, αυτό μπορεί να αλλάξει δεδομένα.

Μια επιτυχημένη δοκιμή σφραγίζει μια χρονική σήμανση "τελευταία δοκιμή" στο αρχείο εγγραφής. Δεν τροποποιεί τη διαμόρφωση της εγγραφής.

Προϋποθέσεις

Αυτό το εργαλείο είναι διαθέσιμο στον διακομιστή Dynamics 365 Customer Service MCP. Δείτε τη σημείωση διαθεσιμότητας στο επάνω μέρος αυτής της σελίδας για λεπτομέρειες. Δεν απαιτείται πρόσθετη διαμόρφωση.

Σύνοψη εργαλείου

Ιδιοκτησία	Τιμή
Όνομα χρήστη	Δοκιμή εξωτερικής σύνδεσης MCP
Όνομα εσωτερικού εργαλείου	test_mcp_registration_connection
Σκοπός	Ελέγχει τη συνδεσιμότητα με ένα εξωτερικό τελικό σημείο διακομιστή MCP πριν από την αποθήκευση μιας καταχώρισης

Συμπεριφορά εργαλείου

Ελέγχει τη συνδεσιμότητα με ένα εξωτερικό τελικό σημείο διακομιστή MCP πριν από την αποθήκευση μιας εγγραφής. Επικυρώνει τη διεύθυνση URL τελικού σημείου έναντι περιορισμών SSRF, αποκτά ένα διακριτικό OBO χρησιμοποιώντας το καθορισμένο εύρος ελέγχου ταυτότητας και εκδίδει ένα tools/list αίτημα για επαλήθευση της απόκρισης του διακομιστή. Αυτό είναι ένα εργαλείο υποστήριξης widget που καλείται αυτόματα από το widget διαχείρισης εγγραφών.

Σχολιασμούς

Σχόλια	Τιμή	Έννοια
readOnlyHint	false	Μπορεί να σφραγίσει lastTestedAt την εγγραφή όταν registrationId παρέχεται.
destructiveHint	false	Η δοκιμή δεν καταργεί ούτε καταστρέφει δεδομένα.
idempotentHint	false	Μια επιτυχημένη δοκιμή μπορεί να γράψει μια νέα lastTestedAt χρονική σήμανση.
openWorldHint	Δεν έχει οριστεί	Χρησιμοποιεί προεπιλογή.

Έννοιες εισόδου

Τελικό σημείο

Δεδομένα εισόδου	Περιγραφή	Απαιτείται
endpoint	endpoint (HTTPS URL, απαιτείται). Η διεύθυνση URL του διακομιστή MCP για δοκιμή.	Ναι

Πεδίο ελέγχου ταυτότητας

Δεδομένα εισόδου	Περιγραφή	Απαιτείται
authScope	authScope (συμβολοσειρά, απαιτείται). Το πεδίο εφαρμογής στόχου του Entra OBO για την απόκτηση διακριτικών (για παράδειγμα, api://contoso-app/.default).	Ναι

Αναγνωριστικό εγγραφής

Δεδομένα εισόδου	Περιγραφή	Απαιτείται
registrationId	registrationId (UUID, προαιρετικό). Όταν παρέχεται, σφραγίζεται lastTestedAt στο αρχείο εγγραφής μετά την επιτυχή δοκιμή.	Όχι

Διεύθυνση URL οργανισμού

Δεδομένα εισόδου	Περιγραφή	Απαιτείται
orgUrl	orgUrl (προαιρετικός). Παρακάμπτει την τρέχουσα επιλεγμένη διεύθυνση URL περιβάλλοντος.	Όχι

Απόκριση και συμπεριφορά περιβάλλοντος εργασίας χρήστη

Αυτό το εργαλείο MCP υποστηρίζεται από μια εφαρμογή MCP.

Τύπος απόκρισης

Ενημέρωση widget με αποτελέσματα δοκιμών

Επιστρέφει τον αριθμό εργαλείων που εντοπίστηκε και το στιγμιότυπο εργαλείου μετά την επιτυχία. Οι αποτυχίες επικύρωσης επιστρέφουν RegistrationValidationFailed, οι αποτυχίες μετά την επικύρωση επιστρέφουν ConnectionTestFailed. Το widget αντιστοιχίζει αυτούς τους σταθερούς κωδικούς σε τοπικό αντίγραφο σφάλματος.

Σημειώσεις δρομολόγησης

Αυτό το εργαλείο καλείται αποκλειστικά από το manage_mcp_registration widget. Μην το επικαλείστε απευθείας.

Σχετικά εργαλεία

Εργαλείο	Σχέση
manage_mcp_registration	Το εργαλείο εκκίνησης που ανοίγει το γραφικό στοιχείο εγγραφής
save_mcp_registration	Αποθηκεύει την καταχώριση μετά από επιτυχή δοκιμή
delete_registration	Καταργεί μια καταχώριση MCP όταν type το είναι "mcp"

Ταξινόμηση μεταλλάξεων δεδομένων

Κυρίως μόνο για ανάγνωση με προαιρετική παρενέργεια. Η ίδια η δοκιμή συνδεσιμότητας είναι μόνο για ανάγνωση. Όταν registrationId παρέχεται και το τεστ πετύχει, σφραγίζεται lastTestedAt στο αρχείο εγγραφής.