Informations de référence sur la commande CLI develop-mcp agent 365

Gérez les serveurs MCP dans les environnements Dataverse. La develop-mcp commande offre des options pour publier, déspublier, approuver, bloquer, empaqueter et enregistrer les serveurs MCP pour une utilisation dans les environnements Dataverse.

Rôle minimal requis : varie selon la sous-commande

Syntax

a365 develop-mcp [command] [options]

Options

Option Description
-v, --verbose Activez la journalisation commentée
-?, , -h--help Afficher les informations d’aide et d’utilisation

develop-mcp list-environments

Répertoriez tous les environnements Dataverse disponibles pour la gestion des serveurs MCP.

a365 develop-mcp list-environments [options]

Cette commande affiche tous les environnements Dataverse dans lesquels vous pouvez gérer des serveurs MCP.

Options list-environments

Option Description
-c, --config <config> Chemin d’accès du fichier de configuration (par défaut : a365.config.json)
--dry-run Afficher ce qui serait fait sans exécuter
-v, --verbose Activez la journalisation commentée
-?, , -h--help Afficher les informations d’aide et d’utilisation

develop-mcp list-servers

Répertoriez les serveurs MCP dans un environnement Dataverse spécifique.

a365 develop-mcp list-servers [options]

Cette commande affiche tous les serveurs MCP actuellement déployés dans l’environnement Dataverse spécifié.

Options list-servers

Option Description
-e, --environment-id <environment-id> ID de l’environnement Dataverse
-c, --config <config> Chemin d’accès du fichier de configuration (par défaut : a365.config.json)
--dry-run Afficher ce qui serait fait sans exécuter
-v, --verbose Activez la journalisation commentée
-?, , -h--help Afficher les informations d’aide et d’utilisation

develop-mcp publish

Publiez un serveur MCP dans un environnement Dataverse.

a365 develop-mcp publish [options]

Utilisez cette commande pour publier un serveur MCP dans l’environnement Dataverse spécifié.

Options publish

Option Description
-e, --environment-id <environment-id> ID de l’environnement Dataverse
-s, --server-name <server-name> Nom du serveur MCP à publier
-a, --alias <alias> Alias pour le serveur MCP
-d, --display-name <display-name> Nom complet du serveur MCP
-c, --config <config> Chemin d’accès du fichier de configuration (par défaut : a365.config.json)
--dry-run Afficher ce qui serait fait sans exécuter
-?, , -h--help Afficher les informations d’aide et d’utilisation

develop-mcp unpublish

Annulez la publication d’un serveur MCP à partir d’un environnement Dataverse.

a365 develop-mcp unpublish [options]

Utilisez cette commande pour supprimer un serveur MCP de l’environnement Dataverse spécifié.

Options unpublish

Option Description
-e, --environment-id <environment-id> ID de l’environnement Dataverse
-s, --server-name <server-name> Nom du serveur MCP pour annuler la publication
-c, --config <config> Chemin d’accès du fichier de configuration (par défaut : a365.config.json)
--dry-run Afficher ce qui serait fait sans exécuter
-?, , -h--help Afficher les informations d’aide et d’utilisation

develop-mcp approve

Approuver un serveur MCP.

a365 develop-mcp approve [options]

Cette commande approuve un serveur MCP à utiliser dans l’environnement.

Options approve

Option Description
-s, --server-name <server-name> Nom du serveur MCP à approuver
-c, --config <config> Chemin d’accès du fichier de configuration (par défaut : a365.config.json)
--dry-run Afficher ce qui serait fait sans exécuter
-?, , -h--help Afficher les informations d’aide et d’utilisation

develop-mcp block

Bloquez un serveur MCP.

a365 develop-mcp block [options]

Utilisez cette commande pour empêcher l’utilisation d’un serveur MCP dans votre environnement.

Options block

Option Description
-s, --server-name <server-name> Nom du serveur MCP à bloquer
-c, --config <config> Chemin d’accès du fichier de configuration (par défaut : a365.config.json)
--dry-run Afficher ce qui serait fait sans exécuter
-?, , -h--help Afficher les informations d’aide et d’utilisation

develop-mcp package-mcp-server

Générez le package de serveur MCP pour la soumission sur Microsoft centre d’administration.

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

Utilisez cette commande pour créer un package de déploiement pour un serveur MCP que vous pouvez soumettre au Centre d’administration Microsoft.

Options package-mcp-server

Option Description
--server-name <server-name> Nom du serveur MCP (OBLIGATOIRE)
--developer-name <developer-name> Nom complet du serveur de publication ou du développeur (OBLIGATOIRE)
--icon-url <icon-url> URL publique vers une icône PNG pour le serveur MCP (OBLIGATOIRE)
--output-path <output-path> Répertoire cible du package ZIP généré (OBLIGATOIRE)
--dry-run Afficher ce qui serait fait sans exécuter
-c, --config <config> Chemin d’accès du fichier de configuration (par défaut : a365.config.json)
-?, , -h--help Afficher les informations d’aide et d’utilisation

develop-mcp register-external-mcp-server

Enregistrez un serveur MCP externe avec Entra, OAuth externe, clé API ou sans authentification.

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

Utilisez cette commande pour enregistrer un serveur MCP hébergé externement (tiers) auprès de votre locataire. La commande crée les enregistrements de l’application Microsoft Entra dont la plateforme a besoin, appelle la plateforme Agent 365 pour ajouter le serveur MCP, et configure les URI de redirection et les permissions API sur les nouvelles inscriptions d’applications.

Le nom du serveur doit commencer par le ext_ préfixe et faire au maximum 20 caractères, par ext_MyServerexemple . Les noms d’outils doivent correspondre exactement à ceux exposés par le serveur MCP distant. Des noms incompatibles provoquent l’échec des invocations d’outils à l’exécution.

Vous pouvez fournir des paramètres de trois façons :

  • Faites-les passer en ligne de commande.
  • Fournir un fichier JSON avec --input-file. Les options en ligne de commande supplantent les valeurs du fichier. Voir register-external-mcp-server-sample.json dans les modèles CLI pour la structure du fichier.
  • Omettez toute valeur requise à proposer de manière interactive.

Après la réussite de l’enregistrement, demandez à votre administrateur locataire d’approuver le nouveau serveur MCP avant que les agents ne puissent l’utiliser. Si vous vous êtes enregistré avec ExternalOAuth, ajoutez également l’URI de redirection affichée à votre application IDP externe.

Important

Si l'enregistrement échoue après la création des inscriptions à l'application Microsoft Entra, les applications ne sont pas automatiquement annulées. Supprimez-les manuellement dans le portail Azure avant de réessayer.

Options register-external-mcp-server

Certaines options ne sont requises que pour certains types d’authentification, comme décrit dans la colonne de description.

Option Description
-s, --server-name <server-name> Nom du serveur MCP. Par exemple, il faut commencer avec ext_ et faire au maximum 20 caractères ext_MyServer
-u, --server-url <server-url> URL du serveur MCP distant. Doit être une URL HTTP ou HTTPS valide
-a, --auth-type <auth-type> Type d’authentification : EntraOAuth, ExternalOAuth, APIKey, ou NoAuth
--publisher <publisher> Nom de l’Publisher (utilisé dans les métadonnées du paquet)
--description <description> Description du serveur (utilisée dans les métadonnées du paquet)
--tools <tools> Liste des noms d’outils séparés par virgules exposés par ce serveur, par exemple tool1,tool2,tool3
-f, --input-file <input-file> Chemin vers un fichier JSON avec les paramètres d’enregistrement
--remote-scopes <remote-scopes> Les scopes pour le serveur MCP distant, par api://{appId-guid}/{scopeName}exemple . Utilisé avec EntraOAuth
-t, --tenant-id <tenant-id> Entrée tenant ID pour l’inscription à l’application. Par défaut au locataire actuel az login
--service-tree-id <service-tree-id> ServiceTree ID pour l’enregistrement de l’application Entra. Obligatoire dans les locataires corporatifs Microsoft
--idp-authorization-url <url> URL d’autorisation OAuth externe. Obligatoire lorsque --auth-type est ExternalOAuth
--idp-token-url <url> URL externe du token OAuth. Obligatoire lorsque --auth-type est ExternalOAuth
--idp-scopes <scopes> Oscillations OAuth externes. Obligatoire lorsque --auth-type est ExternalOAuth
--idp-client-id <client-id> ID client externe OAuth. Obligatoire lorsque --auth-type est ExternalOAuth
--idp-client-secret <client-secret> Secret client OAuth externe. Obligatoire lorsque --auth-type est ExternalOAuth
--api-key-location <location> Emplacement de la clé API : Header ou Query. Obligatoire lorsque --auth-type est APIKey
--api-key-name <name> Par exemple X-API-Key ou nom d’en-tête de clé API, ou token. Obligatoire lorsque --auth-type est APIKey
--dry-run Afficher ce qui serait fait sans exécuter
-v, --verbose Activez la journalisation commentée
-?, , -h--help Afficher les informations d’aide et d’utilisation
  • Last updated on