에이전트 365 CLI develop 명령 참조

에이전트 개발을 위한 MCP 도구 서버를 관리합니다. 이 develop 명령은 에이전트 개발을 위해 MCP(모델 컨텍스트 프로토콜) 도구 서버를 관리하는 옵션을 제공합니다. 사용 가능한 서버를 나열하고, 구성된 서버를 보고, 에이전트 구성에서 MCP 서버를 추가하거나 제거할 수 있습니다.

필요한 최소 역할: 없음(로컬 매니페스트 관리)

Syntax

a365 develop [command] [options]

Options

Option Description
-v, --verbose 자세한 로깅 정보 표시 사용
-?, , -h--help 도움말 및 사용 정보를 표시합니다.

develop list-available

카탈로그에서 사용할 수 있는 모든 MCP 서버를 나열합니다(설치할 수 있는 항목).

a365 develop list-available [options]

이 명령은 카탈로그에서 사용할 수 있는 모든 MCP 서버를 표시하며 에이전트 개발에 사용할 수 있도록 설치할 수 있습니다.

list-available 옵션

Option Description
--dry-run 명령을 실행하지 않고 수행할 작업을 표시합니다.
--skip-auth Skip authentication. 테스트 전용입니다. 유효한 인증 없이 명령이 실패할 수 있습니다.
-?, , -h--help 도움말 및 사용 정보를 표시합니다.

Note

develop list-available 를 필요로 a365.config.json하지 않습니다. 환경 변수(기본값)A365_ENVIRONMENT에서 prod 환경을 읽습니다.

develop list-configured

로컬 ToolingManifest.json에서 현재 구성된 MCP 서버를 나열합니다.

a365 develop list-configured [options]

이 명령은 로컬 ToolingManifest.json 파일에서 현재 구성한 모든 MCP 서버를 보여 줍니다.

list-configured 옵션

Option Description
--project-path <path> .을 포함하는 ToolingManifest.jsonagent 프로젝트 디렉터리로 가는 경로 DeploymentProjectPath a365.config.json.
--dry-run 명령을 실행하지 않고 수행할 작업을 표시합니다.
-?, , -h--help 도움말 및 사용 정보를 표시합니다.

develop add-mcp-servers

현재 에이전트 구성에 MCP 서버를 추가합니다.

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

이 명령은 지정된 MCP 서버를 프로젝트 폴더에 ToolingManifest.json 추가합니다. 에이전트 청사진에 권한을 부여하지 않습니다.

Important

이 명령어는 업데이트 ToolingManifest.json 만 하며, 에이전트 블루프린트에 권한을 부여하지 않습니다. 권한 적용 방법은 설정 과정 단계에 따라 다릅니다:

  • 초기 설정 전: 계속 진행합니다 a365 setup all. MCP 권한은 초기 청사진 만들기의 일부로 적용됩니다.
  • 청사진이 이미 있으면 전역 관리자가 별도로 실행 a365 setup permissions mcp 해야 합니다. 관리자는 업데이트 deploymentProjectPathToolingManifest.json된 .

add-mcp-servers 인수

에이전트 구성에 추가할 MCP 서버 이름을 하나 이상 지정합니다. 여러 서버 이름을 공백으로 구분하여 제공할 수 있습니다.

Argument Description
<servers> 추가할 MCP 서버의 이름

add-mcp-servers 옵션

다음 옵션을 사용하여 명령의 동작을 사용자 지정합니다 add-mcp-servers .

Option Description
--project-path <path> .을 포함하는 ToolingManifest.jsonagent 프로젝트 디렉터리로 가는 경로 DeploymentProjectPath a365.config.json.
--dry-run 명령을 실행하지 않고 수행할 작업을 표시합니다.
-?, , -h--help 도움말 및 사용 정보를 표시합니다.

develop remove-mcp-servers

현재 에이전트 구성에서 MCP 서버를 제거합니다.

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

이 명령은 현재 에이전트 구성에서 지정된 MCP 서버를 제거합니다.

remove-mcp-servers 인수

Argument Description
<servers> 제거할 MCP 서버의 이름

remove-mcp-servers 옵션

Option Description
--project-path <path> .을 포함하는 ToolingManifest.jsonagent 프로젝트 디렉터리로 가는 경로 DeploymentProjectPath a365.config.json.
--dry-run 명령을 실행하지 않고 수행할 작업을 표시합니다.
-?, , -h--help 도움말 및 사용 정보를 표시합니다.

develop add-permissions

MCP 서버에 액세스하도록 사용자 지정 애플리케이션을 구성해야 하는 개발 시나리오의 Microsoft Entra 애플리케이션에 MCP 서버 API 권한을 추가합니다.

a365 develop add-permissions [options]

add-permissions 옵션

도구 매니페스트의 값을 활용하여 앱 등록에 필요한 API 권한 및 범위를 추가하려면 다음 옵션을 사용합니다.

Option Description
-m, --manifest <manifest> ToolingManifest.json 경로(기본값: <deploymentProjectPath>/ToolingManifest.json)
--app-id <app-id> 권한을 추가하는 애플리케이션(클라이언트) ID(기본값: clientAppId 구성에서)
--scopes <scopes> 추가할 특정 범위(공백으로 구분됨)(기본값: 모든 범위에서 ToolingManifest.json)
--dry-run 명령을 변경하지 않고 수행할 작업을 표시합니다.
-v, --verbose 자세한 출력 표시
-?, , -h--help 도움말 및 사용 정보를 표시합니다.

Important

--app-id 또는 clientAppId 지정된 애플리케이션에는 Microsoft Entra Application.ReadWrite.All 권한이 있어야 합니다. 이 명령은 사용자 지정 클라이언트 애플리케이션용입니다. 에이전트 청사진에 대한 권한을 구성하려면 대신 사용합니다 a365 setup permissions mcp .

develop get-token

대화형 브라우저 인증을 사용하여 개발하는 동안 MCP 서버를 테스트하기 위한 전달자 토큰을 검색합니다.

a365 develop get-token [options]

get-token 옵션

이러한 옵션을 사용하여 액세스 토큰을 요청하고, 범위를 제어하고, 동작을 새로 고치고, 출력 형식을 선택합니다.

Option Description
--app-id <app-id> 인증을 위한 애플리케이션(클라이언트) ID(기본값: clientAppId 구성에서)
-m, --manifest <manifest> ToolingManifest.json 경로(기본값: <deploymentProjectPath>/ToolingManifest.json)
--scopes <scopes> 요청할 특정 범위(공백으로 구분됨)(기본값: 읽기 대상 ToolingManifest.json)
-o, --output <output> 출력 형식: table, json또는 raw (기본값: table)
--force-refresh 캐시를 우회하는 토큰 새로 고침 강제 적용
--resource <resource> 토큰을 가져올 리소스 키워드( mcp 기본값) 또는 powerplatform
--resource-id <resource-id> 키워드에서 다루지 --resource 않는 리소스에 대한 사용자 지정 리소스 애플리케이션 ID(GUID)
-v, --verbose 전체 토큰을 포함한 자세한 출력 표시
-?, , -h--help 도움말 및 사용 정보를 표시합니다.

get-token 리소스 옵션

--resource 및 --resource-id 옵션을 사용하여 다른 Azure 리소스에 대한 토큰을 가져옵니다.

  • --resource: 키워드를 사용하여 미리 정의된 리소스를 선택합니다.
    • mcp (기본값): MCP 서버용 에이전트 365 도구
    • powerplatform: 파워 플랫폼 API
  • --resource-id: 키워드에서 다루지 않는 리소스에 대한 사용자 지정 GUID(리소스 애플리케이션 ID) 입력

Important

함께 사용할 --resource--resource-id 수 없습니다. 두 옵션 중 하나를 사용하는 경우 다음을 포함합니다 --scopes. 기본 MCP 흐름만 매니페스트 기반 범위 확인을 지원합니다.

develop start-mock-tooling-server

테스트 및 개발 목적으로 모의 도구 서버를 시작합니다.

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

이 명령은 테스트 및 개발 목적으로 모의 도구 서버를 시작합니다. 이 서버를 사용하면 실제 서버 구현 없이 MCP 서버 상호 작용을 시뮬레이션할 수 있습니다.

start-mock-tooling-server 옵션

다음 옵션을 사용하여 명령의 동작을 사용자 지정합니다 start-mock-tooling-server .

Option Description Default
-p, --port <port> 모의 서버의 포트 번호 5309
-v, --verbose 자세한 로깅 정보 표시 사용 false
-?, -h, --help 도움말 및 사용 정보 표시 -
-bg 새 터미널에서 서버 실행 -
  • Last updated on