Αναφορά εντολών CLI develop-mcp παράγοντα 365

Διαχειριστείτε διακομιστές MCP σε περιβάλλοντα dataverse. Η develop-mcp εντολή παρέχει επιλογές για δημοσίευση, κατάργηση δημοσίευσης, έγκριση, αποκλεισμό, συσκευασία και καταχώρηση διακομιστών MCP για χρήση σε περιβάλλοντα Dataverse.

Ελάχιστος απαιτούμενος ρόλος: Ποικίλλει κατά δευτερεύουσα δέσμευση

Syntax

a365 develop-mcp [command] [options]

Options

Option Description
-v, --verbose Ενεργοποίηση λεπτομερούς καταγραφής
-?, -h, --help Εμφάνιση πληροφοριών βοήθειας και χρήσης

develop-mcp list-environments

Λίστα όλων των περιβαλλόντων Dataverse που είναι διαθέσιμα για διαχείριση διακομιστή MCP.

a365 develop-mcp list-environments [options]

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

list-environments επιλογές

Option Description
--dry-run Εμφάνιση του τι θα γινόταν χωρίς εκτέλεση
-v, --verbose Ενεργοποίηση λεπτομερούς καταγραφής
-?, -h, --help Εμφάνιση πληροφοριών βοήθειας και χρήσης

develop-mcp list-servers

Παράθεση διακομιστών MCP σε ένα συγκεκριμένο περιβάλλον Dataverse.

a365 develop-mcp list-servers [options]

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

list-servers επιλογές

Option Description
-e, --environment-id <environment-id> Αναγνωριστικό περιβάλλοντος Dataverse
--dry-run Εμφάνιση του τι θα γινόταν χωρίς εκτέλεση
-v, --verbose Ενεργοποίηση λεπτομερούς καταγραφής
-?, -h, --help Εμφάνιση πληροφοριών βοήθειας και χρήσης

develop-mcp publish

Δημοσιεύστε έναν διακομιστή MCP σε ένα περιβάλλον Dataverse.

a365 develop-mcp publish [options]

Χρησιμοποιήστε αυτήν την εντολή για να δημοσιεύσετε έναν διακομιστή MCP στο καθορισμένο περιβάλλον Dataverse.

publish επιλογές

Option Description
-e, --environment-id <environment-id> Αναγνωριστικό περιβάλλοντος Dataverse
-s, --server-name <server-name> Όνομα διακομιστή MCP για δημοσίευση
-a, --alias <alias> Ψευδώνυμο για τον διακομιστή MCP
-d, --display-name <display-name> Εμφανιζόμενο όνομα για τον διακομιστή MCP
--dry-run Εμφάνιση του τι θα γινόταν χωρίς εκτέλεση
-?, -h, --help Εμφάνιση πληροφοριών βοήθειας και χρήσης

develop-mcp unpublish

Κατάργηση δημοσίευσης ενός διακομιστή MCP από ένα περιβάλλον Dataverse.

a365 develop-mcp unpublish [options]

Χρησιμοποιήστε αυτήν την εντολή για να καταργήσετε ένα διακομιστή MCP από το καθορισμένο περιβάλλον Dataverse.

unpublish επιλογές

Option Description
-e, --environment-id <environment-id> Αναγνωριστικό περιβάλλοντος Dataverse
-s, --server-name <server-name> Όνομα διακομιστή MCP για κατάργηση δημοσίευσης
--dry-run Εμφάνιση του τι θα γινόταν χωρίς εκτέλεση
-?, -h, --help Εμφάνιση πληροφοριών βοήθειας και χρήσης

develop-mcp approve

Εγκρίνετε έναν διακομιστή MCP.

a365 develop-mcp approve [options]

Αυτή η εντολή εγκρίνει ένα διακομιστή MCP για χρήση στο περιβάλλον.

approve επιλογές

Option Description
-s, --server-name <server-name> Όνομα διακομιστή MCP για έγκριση
--dry-run Εμφάνιση του τι θα γινόταν χωρίς εκτέλεση
-?, -h, --help Εμφάνιση πληροφοριών βοήθειας και χρήσης

develop-mcp block

Αποκλεισμός διακομιστή MCP.

a365 develop-mcp block [options]

Χρησιμοποιήστε αυτήν την εντολή για να αποκλείσετε τη χρήση ενός διακομιστή MCP στο περιβάλλον σας.

block επιλογές

Option Description
-s, --server-name <server-name> Όνομα διακομιστή MCP για αποκλεισμό
--dry-run Εμφάνιση του τι θα γινόταν χωρίς εκτέλεση
-?, -h, --help Εμφάνιση πληροφοριών βοήθειας και χρήσης

develop-mcp package-mcp-server

Δημιουργήστε ένα πακέτο διακομιστή MCP για υποβολή στο κέντρο διαχείρισης Microsoft.

a365 develop-mcp package-mcp-server [options]

Χρησιμοποιήστε αυτήν την εντολή για να δημιουργήσετε ένα πακέτο ανάπτυξης για έναν διακομιστή MCP που μπορείτε να υποβάλετε στο Κέντρο διαχείρισης της Microsoft.

package-mcp-server επιλογές

Option Description
--server-name <server-name> Όνομα διακομιστή MCP (ΑΠΑΙΤΕΊΤΑΙ)
--developer-name <developer-name> Εμφανιζόμενο όνομα εκδότη ή προγραμματιστή (ΑΠΑΙΤΕΊΤΑΙ)
--icon-url <icon-url> Δημόσια διεύθυνση URL σε ένα εικονίδιο PNG για τον διακομιστή MCP (ΑΠΑΙΤΕΊΤΑΙ)
--output-path <output-path> Κατάλογος προορισμού για το πακέτο ZIP που δημιουργήθηκε (ΑΠΑΙΤΕΊΤΑΙ)
--dry-run Εμφάνιση του τι θα γινόταν χωρίς εκτέλεση
-?, -h, --help Εμφάνιση πληροφοριών βοήθειας και χρήσης

develop-mcp register-external-mcp-server

Καταχωρίστε έναν εξωτερικό διακομιστή MCP με Entra, εξωτερικό OAuth, κλειδί API ή χωρίς έλεγχο ταυτότητας.

a365 develop-mcp register-external-mcp-server [options]

Χρησιμοποιήστε αυτήν την εντολή για να καταχωρήσετε έναν διακομιστή MCP που φιλοξενείται εξωτερικά (τρίτου μέρους) στον μισθωτή σας. Η εντολή δημιουργεί τις καταχωρήσεις εφαρμογών Microsoft Entra που χρειάζεται η πλατφόρμα, καλεί την πλατφόρμα παράγοντα 365 για να προσθέσει τον διακομιστή MCP και ρυθμίζει τις παραμέτρους των URI ανακατεύθυνσης και των δικαιωμάτων API στις νέες καταχωρήσεις εφαρμογών.

Το όνομα του διακομιστή πρέπει να ξεκινά με το ext_ πρόθεμα και να έχει μήκος το πολύ 20 χαρακτήρες, για παράδειγμα ext_MyServer. Τα ονόματα εργαλείων πρέπει να ταιριάζουν ακριβώς με τα ονόματα που εκτίθενται από τον απομακρυσμένο διακομιστή MCP. Τα αναντιστοιχία ονομάτων προκαλούν την αποτυχία των κλήσεων εργαλείων κατά το χρόνο εκτέλεσης.

Μπορείτε να παρέχετε παραμέτρους με τρεις τρόπους:

  • Περάστε τα ως επιλογές γραμμής εντολών.
  • Δώστε σε ένα αρχείο JSON .--input-file Οι επιλογές της γραμμής εντολών παρακάμπτουν τις τιμές από το αρχείο. Δείτε register-external-mcp-server-sample.json στα πρότυπα CLI για τη δομή του αρχείου.
  • Παραλείψτε οποιαδήποτε απαιτούμενη τιμή για να σας ζητηθεί διαδραστικά.

Μετά την επιτυχή εγγραφή, ζητήστε από τον διαχειριστή μισθωτή σας να εγκρίνει τον νέο διακομιστή MCP για να μπορέσουν οι εκπρόσωποι να τον χρησιμοποιήσουν. Εάν έχετε εγγραφεί στο ExternalOAuth, προσθέστε επίσης το εμφανιζόμενο URI ανακατεύθυνσης στην εξωτερική σας εφαρμογή IDP.

Important

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

register-external-mcp-server επιλογές

Ορισμένες επιλογές απαιτούνται μόνο για συγκεκριμένους τύπους ελέγχου ταυτότητας, όπως περιγράφεται στη στήλη περιγραφής.

Option Description
-s, --server-name <server-name> Όνομα διακομιστή MCP. Πρέπει να ξεκινά με ext_ και να αποτελείται το πολύ από 20 χαρακτήρες, για παράδειγμα ext_MyServer
-u, --server-url <server-url> Διεύθυνση URL απομακρυσμένου διακομιστή MCP. Πρέπει να είναι έγκυρη διεύθυνση URL HTTP ή HTTPS
-a, --auth-type <auth-type> Τύπος ελέγχου ταυτότητας: EntraOAuth, ExternalOAuth, APIKey, ή NoAuth
--publisher <publisher> Publisher name (χρησιμοποιείται στα μετα-δεδομένα πακέτου)
--description <description> Περιγραφή διακομιστή (χρησιμοποιείται στα μεταδεδομένα πακέτων)
--tools <tools> Λίστα ονομάτων εργαλείων διαχωρισμένων με κόμματα που εκτίθενται από αυτόν τον διακομιστή, για παράδειγμα tool1,tool2,tool3
-f, --input-file <input-file> Διαδρομή προς ένα αρχείο JSON με τις παραμέτρους εγγραφής
--remote-scopes <remote-scopes> Πεδία για τον απομακρυσμένο διακομιστή MCP, για παράδειγμα api://{appId-guid}/{scopeName}. Χρησιμοποιείται με EntraOAuth
-t, --tenant-id <tenant-id> Αναγνωριστικό μισθωτή Entra για την καταχώρηση της εφαρμογής. Προεπιλογή στον τρέχοντα az login μισθωτή
--service-tree-id <service-tree-id> ServiceTree ID για την εγγραφή της εφαρμογής Entra. Απαιτείται σε εταιρικούς μισθωτές της Microsoft
--idp-authorization-url <url> Εξωτερική διεύθυνση URL εξουσιοδότησης OAuth. Απαιτείται όταν --auth-type είναι ExternalOAuth
--idp-token-url <url> Εξωτερική διεύθυνση URL διακριτικού OAuth. Απαιτείται όταν --auth-type είναι ExternalOAuth
--idp-scopes <scopes> Εξωτερικά πεδία OAuth. Απαιτείται όταν --auth-type είναι ExternalOAuth
--idp-client-id <client-id> Εξωτερικό αναγνωριστικό προγράμματος-πελάτη OAuth. Απαιτείται όταν --auth-type είναι ExternalOAuth
--idp-client-secret <client-secret> Εξωτερικός μυστικός κωδικός προγράμματος-πελάτη OAuth. Απαιτείται όταν --auth-type είναι ExternalOAuth
--api-key-location <location> Θέση κλειδιού API: Header ή Query. Απαιτείται όταν --auth-type είναι APIKey
--api-key-name <name> Παράμετρος κλειδιού API ή όνομα κεφαλίδας, για παράδειγμα X-API-Key ή token. Απαιτείται όταν --auth-type είναι APIKey
--dry-run Εμφάνιση του τι θα γινόταν χωρίς εκτέλεση
-v, --verbose Ενεργοποίηση λεπτομερούς καταγραφής
-?, -h, --help Εμφάνιση πληροφοριών βοήθειας και χρήσης