Referencia de comandos de la CLI develop del agente 365

Administrar servidores de herramientas MCP para el desarrollo de agentes. El develop comando proporciona opciones para administrar servidores de herramientas MCP (Protocolo de contexto de modelo) para el desarrollo del agente. Puede enumerar los servidores disponibles, ver los servidores configurados y agregar o quitar servidores MCP de la configuración del agente.

Rol mínimo necesario: Ninguno (administración de manifiestos local)

Syntax

a365 develop [command] [options]

Options

Option Description
-c, --config <config> Ruta de acceso del archivo de configuración. Default: a365.config.json
-v, --verbose Habilitación del registro detallado
-?, , -h, --help Mostrar información de ayuda y uso.

develop list-available

Enumere todos los servidores MCP disponibles en el catálogo (lo que puede instalar).

a365 develop list-available [options]

Este comando muestra todos los servidores MCP que están disponibles en el catálogo y puede instalarlos para usarlos con el desarrollo del agente.

list-available Opciones

Option Description
--dry-run Mostrar lo que haría el comando sin ejecutarlo.
--skip-auth Skip authentication. Solo para pruebas. Es probable que se produzca un error en el comando sin autenticación válida.
-?, , -h, --help Mostrar información de ayuda y uso.

Note

develop list-available no requiere a365.config.json. Lee el entorno desde la A365_ENVIRONMENT variable de entorno (por defecto es prod).

develop list-configured

Enumere los servidores MCP configurados actualmente desde el local ToolingManifest.json.

a365 develop list-configured [options]

Este comando muestra todos los servidores MCP que configuró actualmente en el archivo ToolingManifest.json local.

list-configured Opciones

Option Description
--project-path <path> Ruta hacia el directorio del proyecto agente que contiene ToolingManifest.json. Anula DeploymentProjectPath desde a365.config.json.
--dry-run Mostrar lo que haría el comando sin ejecutarlo.
-?, , -h, --help Mostrar información de ayuda y uso.

develop add-mcp-servers

Agregue servidores MCP a la configuración del agente actual.

a365 develop add-mcp-servers [<servers>...] [options]

Este comando agrega los servidores MCP especificados a ToolingManifest.json en la carpeta del proyecto. No concede permisos al plano técnico del agente.

Important

Este comando solo se actualiza ToolingManifest.json : no concede permisos al blueprint del agente. Cómo solicitas permisos depende de en qué punto del proceso de configuración estés:

  • Antes de la instalación inicial: continúe con a365 setup all. Los permisos de MCP se aplican como parte de la creación inicial del plano técnico.
  • Después de que el blueprint ya exista: un administrador global debe ejecutarlo a365 setup permissions mcp por separado. El administrador debe verificar que apunta deploymentProjectPath a la carpeta del proyecto que contiene el archivo actualizado ToolingManifest.json.

Argumentos de add-mcp-servers

Especifique uno o varios nombres de servidor MCP para agregar a la configuración del agente. Puede proporcionar varios nombres de servidor separados por espacios.

Argument Description
<servers> Nombres de los servidores MCP que se van a agregar

add-mcp-servers Opciones

Use estas opciones para personalizar el comportamiento del add-mcp-servers comando.

Option Description
--project-path <path> Ruta hacia el directorio del proyecto agente que contiene ToolingManifest.json. Anula DeploymentProjectPath desde a365.config.json.
--dry-run Mostrar lo que haría el comando sin ejecutarlo.
-?, , -h, --help Mostrar información de ayuda y uso.

develop remove-mcp-servers

Quite los servidores MCP de la configuración del agente actual.

a365 develop remove-mcp-servers [<servers>...] [options]

Este comando quita los servidores MCP especificados de la configuración del agente actual.

Argumentos de remove-mcp-servers

Argument Description
<servers> Nombres de los servidores MCP que se van a quitar

remove-mcp-servers Opciones

Option Description
--project-path <path> Ruta hacia el directorio del proyecto agente que contiene ToolingManifest.json. Anula DeploymentProjectPath desde a365.config.json.
--dry-run Mostrar lo que haría el comando sin ejecutarlo.
-?, , -h, --help Mostrar información de ayuda y uso.

develop add-permissions

Agregue permisos de API de servidor MCP para Microsoft Entra aplicaciones para escenarios de desarrollo en los que necesite configurar aplicaciones personalizadas para acceder a los servidores MCP.

a365 develop add-permissions [options]

add-permissions Opciones

Use estas opciones para agregar los ámbitos y permisos de API necesarios al registro de la aplicación, aprovechando los valores del manifiesto de herramientas.

Option Description
-c, --config <config> Ruta de acceso del archivo de configuración (valor predeterminado: a365.config.json)
-m, --manifest <manifest> Ruta de acceso a ToolingManifest.json (valor predeterminado: <deploymentProjectPath>/ToolingManifest.json)
--app-id <app-id> Id. de aplicación (cliente) para agregar permisos a (valor predeterminado: clientAppId desde la configuración)
--scopes <scopes> Ámbitos específicos que se van a agregar (separados por espacios) (valor predeterminado: Todos los ámbitos de ToolingManifest.json)
--dry-run Mostrar lo que haría el comando sin realizar cambios
-v, --verbose Mostrar salida detallada
-?, , -h, --help Mostrar información de ayuda y uso.

Important

La aplicación especificada por --app-id o clientAppId debe tener el permiso Application.ReadWrite.All en Microsoft Entra. Este comando es para aplicaciones cliente personalizadas. Para configurar los permisos para los planos técnicos del agente, use a365 setup permissions mcp en su lugar.

develop get-token

Recupere tokens de portador para probar servidores MCP durante el desarrollo mediante la autenticación interactiva del explorador.

a365 develop get-token [options]

get-token Opciones

Use estas opciones para solicitar un token de acceso, controlar ámbitos, comportamiento de actualización y elegir el formato de salida.

Option Description
-c, --config <config> Ruta de acceso del archivo de configuración (valor predeterminado: a365.config.json)
--app-id <app-id> Id. de aplicación (cliente) para la autenticación (valor predeterminado: clientAppId desde la configuración)
-m, --manifest <manifest> Ruta de acceso a ToolingManifest.json (valor predeterminado: <deploymentProjectPath>/ToolingManifest.json)
--scopes <scopes> Ámbitos específicos para solicitar (separados por espacios) (valor predeterminado: Leer de ToolingManifest.json)
-o, --output <output> Formato de salida: table, jsono raw (valor predeterminado: table)
--force-refresh Forzar la actualización del token pasando la memoria caché
--resource <resource> Palabra clave resource para la que se va a obtener el token: mcp (valor predeterminado) o powerplatform
--resource-id <resource-id> Identificador de aplicación de recursos personalizados (GUID) para recursos no cubiertos por --resource palabras clave
-v, --verbose Mostrar una salida detallada, incluido el token completo
-?, , -h, --help Mostrar información de ayuda y uso.

get-token opciones de recursos

Use las opciones --resource y --resource-id para obtener tokens para distintos recursos de Azure:

  • --resource: use una palabra clave para seleccionar un recurso predefinido:
    • mcp (valor predeterminado): Herramientas del agente 365 para servidores MCP
    • powerplatform: API de Power Platform
  • --resource-id: escriba un identificador de aplicación de recurso personalizado (GUID) para los recursos no cubiertos por palabras clave.

Important

No puedes usar --resource y --resource-id juntos. Cuando use cualquiera de las opciones, incluya --scopes. Solo el flujo de MCP predeterminado admite la resolución de ámbito basada en manifiestos.

develop start-mock-tooling-server

Inicie un servidor de herramientas ficticio con fines de prueba y desarrollo.

a365 develop start-mock-tooling-server [options]

Este comando inicia un servidor de herramientas ficticio con fines de prueba y desarrollo. Con este servidor, puede simular interacciones de servidor MCP sin necesidad de implementaciones reales del servidor.

start-mock-tooling-server Opciones

Use estas opciones para personalizar el comportamiento del start-mock-tooling-server comando.

Option Description Default
-p, --port <port> Número de puerto del servidor ficticio 5309
-v, --verbose Habilitación del registro detallado false
-?, -h, --help Mostrar información de ayuda y uso -
-bg Ejecución del servidor en un nuevo terminal -
  • Last updated on