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, aprobar, bloquear, empaquetar y registrar servidores MCP para su uso en entornos Dataverse.

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.

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
--dry-run	Mostrar lo que se haría sin ejecutar
-?, -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 approve

Aprobar un servidor MCP.

a365 develop-mcp approve [options]

Este comando aprueba un servidor MCP para su uso en el entorno.

approve Opciones

Option	Description
-s, --server-name <server-name>	Nombre del servidor MCP para aprobar
--dry-run	Mostrar lo que se haría sin ejecutar
-?, -h, --help	Mostrar información de ayuda y uso

develop-mcp block

Bloquear un servidor MCP.

a365 develop-mcp block [options]

Use este comando para impedir que se use un servidor MCP en su entorno.

block Opciones

Option	Description
-s, --server-name <server-name>	Nombre del servidor MCP que se va a bloquear
--dry-run	Mostrar lo que se haría sin ejecutar
-?, -h, --help	Mostrar información de ayuda y uso

develop-mcp package-mcp-server

Genere el paquete de servidor MCP para su envío en Microsoft centro de administración.

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

Use este comando para crear un paquete de implementación para un servidor MCP que pueda enviar al Centro de administración de Microsoft.

package-mcp-server Opciones

Option	Description
--server-name <server-name>	Nombre del servidor MCP (OBLIGATORIO)
--developer-name <developer-name>	Nombre para mostrar del publicador o del desarrollador (OBLIGATORIO)
--icon-url <icon-url>	Dirección URL pública a un icono PNG para el servidor MCP (OBLIGATORIO)
--output-path <output-path>	Directorio de destino para el paquete ZIP generado (OBLIGATORIO)
--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
--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