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

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

Note

Οι develop-mcp approveεντολές , develop-mcp blockκαι develop-mcp package-mcp-server καταργούνται από το Agent 365 CLI. Οι διαχειριστές ενοικιαστών εκτελούν πλέον έγκριση και αποκλεισμό διακομιστή στο κέντρο διαχείρισης Microsoft — τα εκκρεμή αιτήματα εξετάζονται στη σελίδα Requested Agents. Το CLI δεν παράγει πλέον πακέτα διακομιστή MCP για υποβολή στο Κέντρο διαχείρισης. Οι διαχειριστές ενσωματώνουν και διαχειρίζονται διακομιστές απευθείας στο κέντρο διαχείρισης.

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

Syntax

a365 develop-mcp [command] [options]

Options

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

develop-mcp evaluate

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

a365 develop-mcp evaluate --server-url <server-url> [--auth-token <auth-token>] [options]

evaluate επιλογές

Option	Description
-u, --server-url <server-url>	Required. Η διεύθυνση URL τελικού σημείου HTTP του διακομιστή MCP με δυνατότητα ροής (συνήθως τελειώνει σε /mcp).
--auth-token <auth-token>	Optional. Απαιτείται μόνο όταν ο διακομιστής MCP απαιτεί έλεγχο ταυτότητας. Διακριτικό κομιστή για τον διακομιστή. Προτιμήστε τη A365_MCP_AUTH_TOKEN μεταβλητή περιβάλλοντος. Ένα διακριτικό που μεταβιβάζεται στη γραμμή εντολών είναι ορατό στις καταχωρίσεις διεργασιών και στο ιστορικό κελύφους.
-o, --output-dir <output-dir>	Κατάλογος για τη λίστα ελέγχου και τα αρχεία αναφοράς. Προεπιλογή στον τρέχοντα κατάλογο (.).
--eval-engine <eval-engine>	Ποιος τοπικός παράγοντας κωδικοποίησης βαθμολογεί τους σημασιολογικούς ελέγχους: auto (προεπιλογή, δοκιμάστε GitHub Copilot και μετά Claude Code), github-copilot, claude-code ή none (παραλείψτε τη βαθμολόγηση AI και περιμένετε μια λίστα ελέγχου με προ-βαθμολογία).
-v, --verbose	Ενεργοποιήστε την λεπτομερή καταγραφή.
-?, -h, --help	Εμφάνιση πληροφοριών βοήθειας και χρήσης.

evaluate Παραδείγματα

Αξιολογήστε έναν τοπικό διακομιστή με αυτόματη επιλογή μηχανής:

a365 develop-mcp evaluate --server-url "http://localhost:5000/mcp"

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

$env:A365_MCP_AUTH_TOKEN = "<bearer-token>"
a365 develop-mcp evaluate --server-url "https://my-mcp-server.contoso.com/mcp" --output-dir "./eval"

Δημιουργήστε μόνο τη λίστα ελέγχου και, στη συνέχεια, βαθμολογήστε την με το δικό σας LLM:

a365 develop-mcp evaluate --server-url "https://my-mcp-server.contoso.com/mcp" --eval-engine none

Αναγκάστε μια συγκεκριμένη μηχανή βαθμολόγησης:

a365 develop-mcp evaluate --server-url "http://localhost:5000/mcp" --eval-engine claude-code

Μάθετε πώς να αξιολογείτε διακομιστές MCP

evaluate μεταβλητές περιβάλλοντος

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

Environment variable	Purpose
A365_MCP_AUTH_TOKEN	Διακριτικό κομιστή για τον διακομιστή MCP, που χρησιμοποιείται όταν --auth-token δεν μεταβιβάζεται. Προτιμάται έναντι της σημαίας επειδή διατηρεί το διακριτικό εκτός καταχωρίσεων διεργασιών και ιστορικού κελύφους.
A365_EVAL_COPILOT_MODEL	Παρακάμψτε το μοντέλο GitHub Copilot. Απαιτεί ένα ακριβές αναγνωριστικό μοντέλου, για παράδειγμα claude-haiku-4.5.
A365_EVAL_CLAUDE_MODEL	Παρακάμψτε το μοντέλο Claude Code. Αποδέχεται ένα ψευδώνυμο μοντέλου (για παράδειγμα haiku) ή ένα πλήρες αναγνωριστικό μοντέλου.

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.

Όταν δημοσιεύετε, το CLI δημιουργεί μια καταχώρηση εφαρμογής <server-name>-PublicClients Microsoft Entra στον μισθωτή σας. Αυτή η εφαρμογή κατέχει τα δικαιώματα OAuth που χρησιμοποιεί ο κεντρικός υπολογιστής-πελάτης (όπως το Visual Studio Code και το Microsoft 365 Copilot CLI) για να καλέσει τον δημοσιευμένο διακομιστή MCP. Επειδή η εντολή δημιουργεί μια καταχώρηση εφαρμογής, ο λογαριασμός που εκτελεί το CLI πρέπει να έχει το δικαίωμα Application.ReadWrite.All Microsoft Graph. Το τρέξιμο publish χωρίς αυτό αποτυγχάνει.

Note

Παρέχετε --publisher-name προσαρμοσμένους διακομιστές MCP (που δημιουργούνται από τον χρήστη). Η τιμή εγγράφεται στα μεταδεδομένα προγραμματιστή του δημοσιευμένου πακέτου και απαιτείται για αυτούς τους διακομιστές. Παραβλέπεται για διακομιστές που ανήκουν σε Microsoft πρώτου μέρους (για παράδειγμα, msdyn_DataverseMCPServer), οι οποίοι δημοσιεύονται πάντα ως "Microsoft". Όταν το παραλείπετε, το CLI το ζητά διαδραστικά. pass --yes για δημοσίευση χωρίς προτροπές σε CI ή σεναριακά περιβάλλοντα.

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
-p, --publisher-name <publisher-name>	Publisher όνομα γραμμένο στα δημοσιευμένα μεταδεδομένα πακέτου. Απαιτείται για προσαρμοσμένους διακομιστές MCP (που δημιουργούνται από τον χρήστη). αγνοείται για διακομιστές πρώτου κατασκευαστή που ανήκουν στη Microsoft. Ζητείται διαδραστικά όταν παραλείπεται.
-y, --yes	Παραλείψτε το διαδραστικό "Προχωρήστε στη δημοσίευση; (y/N)" confirmation. Χρήση σε περιβάλλοντα CI ή σεναρίου.
--dry-run	Εμφάνιση του τι θα γινόταν χωρίς εκτέλεση
-v, --verbose	Ενεργοποίηση λεπτομερούς καταγραφής
-?, -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 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
-l, --secret-lifetime-months <months>	Διάρκεια ζωής σε μήνες (1-24) για τα μυστικά πελάτη που δημιουργούνται στις δημιουργημένες εφαρμογές Entra. Προεπιλογή σε 24 μήνες (2 χρόνια). Ορίστε μια τιμή μικρότερη από το appManagementPolicies όριο στον μισθωτή σας, εάν η πολιτική μισθωτή σας επιβάλλει μικρότερο μέγιστο
--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	Εμφάνιση πληροφοριών βοήθειας και χρήσης