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 evaluate`

Evalúa tu servidor MCP según las mejores prácticas científicas para evaluar la preparación para la producción. Esta herramienta produce un informe de evaluación completo con puntuaciones, explicaciones y acciones concretas. El comando descubre las herramientas que expone un servidor MCP, ejecuta un conjunto de comprobaciones semánticas deterministas y puntuadas por IA contra sus esquemas, y produce un informe HTML que califica la calidad del esquema y lista las acciones prioritarias para mejorar.

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

`evaluate` Opciones

Option	Description
`-u`, `--server-url <server-url>`	Required. La URL HTTP del endpoint streamable del servidor MCP (normalmente termina en `/mcp`).
`--auth-token <auth-token>`	Optional. Solo se necesita cuando el servidor MCP requiere autenticación. Ficha portadora para el servidor. Prefiero la `A365_MCP_AUTH_TOKEN` variable de entorno; un token pasado por la línea de comandos es visible para los listados de procesos y el historial del shell.
`-o`, `--output-dir <output-dir>`	Directorio para la lista de comprobación y los archivos de informes. Por defecto se asigna al directorio actual (`.`).
`--eval-engine <eval-engine>`	¿Qué agente local de codificación puntua las comprobaciones semánticas: `auto` (por defecto; prueba GitHub Copilot y luego Claude Code), `github-copilot`, `claude-code` o `none` (salta la puntuación de IA y espera una lista de verificación pre-puntuada).
`-v`, `--verbose`	Habilite el registro detallado.
`-?`, , `-h`, `--help`	Mostrar información de ayuda y uso.

ejemplos de `evaluate`

Evalúa un servidor local con selección automática del motor:

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

Evalúa un servidor autenticado, con el token suministrado a través de una variable de entorno y artefactos escritos en una subcarpeta:

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

Genera solo la lista de verificación y luego apúntala con tu propio LLM:

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

Forzar un motor de puntuación específico:

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

Aprende cómo evaluar servidores MCP

`evaluate` variables de entorno

Utiliza las siguientes variables de entorno para proporcionar autenticación y, opcionalmente, controla qué modelo utiliza cada motor de puntuación local.

Environment variable	Purpose
`A365_MCP_AUTH_TOKEN`	Token portador para el servidor MCP, usado cuando `--auth-token` no se ha aprobado. Prefiere sobre la bandera porque mantiene el token fuera de los listados de procesos y del historial de la shell.
`A365_EVAL_COPILOT_MODEL`	Anula el modelo de GitHub Copilot. Requiere un ID exacto del modelo, por `claude-haiku-4.5`ejemplo .
`A365_EVAL_CLAUDE_MODEL`	Anular el modelo de Código Claude. Acepta un alias de modelo (por ejemplo `haiku`) o un ID completo de modelo.

`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

Comentaris

Us ha resultat útil aquesta pàgina?

Last updated on 2026-06-12

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

Syntax

Options

develop-mcp evaluate

evaluate Opciones

ejemplos de evaluate

evaluate variables de entorno

develop-mcp list-environments

list-environments Opciones

develop-mcp list-servers

list-servers Opciones

develop-mcp publish

publish Opciones

develop-mcp unpublish

unpublish Opciones

develop-mcp register-external-mcp-server

register-external-mcp-server Opciones