Referencia de comandos de la CLI develop-mcp del agente 365

Administrar servidores MCP en entornos de Dataverse. El develop-mcp comando ofrece opciones para publicar, despublicar y registrar servidores MCP para su uso en entornos Dataverse.

Note

Los develop-mcp approvecomandos , develop-mcp block, y develop-mcp package-mcp-server se eliminan de la CLI del Agente 365. Los administradores de inquilinos ahora realizan la aprobación y el bloqueo del servidor en el centro de administración Microsoft — las solicitudes pendientes se revisan en la página Solicitados Agentes. La CLI ya no produce paquetes de servidores MCP para la presentación en el Centro de Administración; los administradores a bordo y gestionan los servidores directamente en el centro de administración.

Rol mínimo necesario: varía según el subcomando.

Syntax

a365 develop-mcp [command] [options]

Options

Option	Description
-v, --verbose	Habilitación del registro detallado
-?, , -h, --help	Mostrar información de ayuda y uso

develop-mcp list-environments

Enumere todos los entornos de Dataverse disponibles para la administración del servidor MCP.

a365 develop-mcp list-environments [options]

Este comando muestra todos los entornos de Dataverse donde puede administrar servidores MCP.

list-environments Opciones

Option	Description
--dry-run	Mostrar lo que se haría sin ejecutar
-v, --verbose	Habilitación del registro detallado
-?, , -h, --help	Mostrar información de ayuda y uso

develop-mcp list-servers

Enumeración de servidores MCP en un entorno específico de Dataverse.

a365 develop-mcp list-servers [options]

Este comando muestra todos los servidores MCP que se implementan actualmente en el entorno de Dataverse especificado.

list-servers Opciones

Option	Description
-e, --environment-id <environment-id>	Id. de entorno de Dataverse
--dry-run	Mostrar lo que se haría sin ejecutar
-v, --verbose	Habilitación del registro detallado
-?, , -h, --help	Mostrar información de ayuda y uso

develop-mcp publish

Publique un servidor MCP en un entorno de Dataverse.

a365 develop-mcp publish [options]

Use este comando para publicar un servidor MCP en el entorno de Dataverse especificado.

Cuando publicas, la CLI crea un registro <server-name>-PublicClients Microsoft Entra app en tu inquilino. Esta aplicación posee los permisos OAuth que los hosts cliente (como Visual Studio Code y la CLI de Microsoft 365 Copilot) utilizan para llamar al servidor MCP publicado. Como el comando crea un registro de la app, la cuenta que ejecuta la CLI debe tener el permiso Application.ReadWrite.All Microsoft Graph. Funcionar publish sin él falla.

Note

Proporcionar --publisher-name servidores MCP personalizados (creados por los usuarios). El valor se escribe en los metadatos de desarrollador del paquete publicado y es necesario para estos servidores. Se ignora en los servidores de primera mano de Microsoft (por ejemplo, msdyn_DataverseMCPServer), que siempre publican como "Microsoft". Cuando lo omites, la CLI lo solicita de forma interactiva; pasar --yes a publicar sin indicaciones en contextos de CI o scriptados.

publish Opciones

Option	Description
-e, --environment-id <environment-id>	Id. de entorno de Dataverse
-s, --server-name <server-name>	Nombre del servidor MCP para publicar
-a, --alias <alias>	Alias para el servidor MCP
-d, --display-name <display-name>	Nombre para mostrar del servidor MCP
-p, --publisher-name <publisher-name>	Nombre del Publisher escrito en los metadatos del paquete publicado. Requerida para servidores MCP personalizados (creados por usuarios); ignorado por servidores propios de Microsoft. Se recomienda de forma interactiva cuando se omite.
-y, --yes	Salta la interacción "¿Seguir publicando? (y/N)" confirmation. Uso en contextos de CI o guionizados.
--dry-run	Mostrar lo que se haría sin ejecutar
-v, --verbose	Habilitación del registro detallado
-?, , -h, --help	Mostrar información de ayuda y uso

develop-mcp unpublish

Anulación de la publicación de un servidor MCP desde un entorno de Dataverse.

a365 develop-mcp unpublish [options]

Use este comando para quitar un servidor MCP del entorno de Dataverse especificado.

unpublish Opciones

Option	Description
-e, --environment-id <environment-id>	Id. de entorno de Dataverse
-s, --server-name <server-name>	Nombre del servidor MCP para anular la publicación
--dry-run	Mostrar lo que se haría sin ejecutar
-?, , -h, --help	Mostrar información de ayuda y uso

develop-mcp register-external-mcp-server

Registra un servidor MCP externo con Entra, OAuth externo, clave API o sin autenticación.

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

Usa este comando para registrar un servidor MCP alojado externamente (de terceros) con tu inquilino. El comando crea los registros de la app Microsoft Entra que la plataforma necesita, llama a la plataforma Agent 365 para añadir el servidor MCP y configura los URI de redirección y los permisos de la API en los nuevos registros de la app.

El nombre del servidor debe comenzar con el ext_ prefijo y tener como máximo 20 caracteres, por ext_MyServerejemplo. Los nombres de las herramientas deben coincidir exactamente con los nombres expuestos por el servidor MCP remoto. Los nombres desajustados hacen que las invocaciones de herramientas fallen en tiempo de ejecución.

Puedes suministrar parámetros de tres maneras:

• Pásalas como opciones de línea de comandos.
• Proporciona un archivo JSON con --input-file. Las opciones de línea de comandos sobrescriben valores del archivo. Consulta register-external-mcp-server-sample.json en las plantillas CLI para la estructura de archivos.
• Omite cualquier valor necesario que se deba indicar de forma interactiva.

Después de que el registro tenga éxito, pide a tu administrador de inquilinos que apruebe el nuevo servidor MCP antes de que los agentes puedan usarlo. Si te registraste con ExternalOAuth, también añade el URI de redirección mostrado a tu solicitud externa IDP.

Important

Si el registro falla después de que se creen los registros de la app Microsoft Entra, las aplicaciones no se revierten automáticamente. Bórralos manualmente en el portal de Azure antes de volver a intentarlo.

register-external-mcp-server Opciones

Algunas opciones solo son necesarias para tipos específicos de autenticación, como se describe en la columna de descripción.

Option	Description
-s, --server-name <server-name>	Nombre del servidor MCP. Por ejemplo, debe empezar con ext_ y ser como máximo 20 caracteres ext_MyServer
-u, --server-url <server-url>	URL remota del servidor MCP. Debe ser una URL HTTP o HTTPS válida
-a, --auth-type <auth-type>	Tipo de autenticación: EntraOAuth, ExternalOAuth, APIKey, o NoAuth
--publisher <publisher>	Nombre del Publisher (usado en los metadatos del paquete)
--description <description>	Descripción del servidor (usada en los metadatos del paquete)
--tools <tools>	Por ejemplo, una lista separada por comas de nombres de herramientas expuestos por este servidor tool1,tool2,tool3
-f, --input-file <input-file>	Ruta hacia un archivo JSON con los parámetros de registro
--remote-scopes <remote-scopes>	Ámbitos para el servidor MCP remoto, por api://{appId-guid}/{scopeName}ejemplo. Se usa con EntraOAuth.
-t, --tenant-id <tenant-id>	Entra el ID del inquilino para el registro de la app. Por defecto al inquilino actual az login
--service-tree-id <service-tree-id>	Identificador ServiceTree para el registro de la app Entra. Obligatorio en los tenants corporativos de Microsoft
-l, --secret-lifetime-months <months>	Duración en meses (1-24) para los secretos generados de los clientes en las aplicaciones creadas de Entra. El plazo por defecto es de 24 meses (2 años). Establece un valor menor que el appManagementPolicies límite en tu inquilino si tu póliza de inquilino impone un máximo más bajo
--idp-authorization-url <url>	URL de autorización OAuth externa. Obligatorio cuando se --auth-typeExternalOAuth
--idp-token-url <url>	URL externa del token OAuth. Obligatorio cuando se --auth-typeExternalOAuth
--idp-scopes <scopes>	Oscilaciones OAuth externas. Obligatorio cuando se --auth-typeExternalOAuth
--idp-client-id <client-id>	ID de cliente OAuth externo. Obligatorio cuando se --auth-typeExternalOAuth
--idp-client-secret <client-secret>	Secreto externo de cliente OAuth. Obligatorio cuando se --auth-typeExternalOAuth
--api-key-location <location>	Ubicación de la clave API: Header o Query. Obligatorio cuando se --auth-typeAPIKey
--api-key-name <name>	Parámetro clave API o nombre de cabecera, por ejemplo X-API-Key o token. Obligatorio cuando se --auth-typeAPIKey
--dry-run	Mostrar lo que se haría sin ejecutar
-v, --verbose	Habilitación del registro detallado
-?, , -h, --help	Mostrar información de ayuda y uso