에이전트 365 CLI develop-mcp 명령 참조

Dataverse 환경에서 MCP 서버를 관리합니다. 이 명령어는 develop-mcp Dataverse 환경에서 사용할 MCP 서버를 게시, 언퍼블리블, 승인, 차단, 패키징, 등록하는 옵션을 제공합니다.

필요한 최소 역할: 하위 명령에 따라 다름

Syntax

a365 develop-mcp [command] [options]

Options

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

develop-mcp list-environments

MCP 서버 관리에 사용할 수 있는 모든 Dataverse 환경을 나열합니다.

a365 develop-mcp list-environments [options]

이 명령은 MCP 서버를 관리할 수 있는 모든 Dataverse 환경을 표시합니다.

list-environments 옵션

Option Description
--dry-run 실행하지 않고 수행할 작업 표시
-v, --verbose 자세한 로깅 정보 표시 사용
-?, , -h--help 도움말 및 사용 정보 표시

develop-mcp list-servers

특정 Dataverse 환경에서 MCP 서버를 나열합니다.

a365 develop-mcp list-servers [options]

이 명령은 지정된 Dataverse 환경에 현재 배포된 모든 MCP 서버를 보여 줍니다.

list-servers 옵션

Option Description
-e, --environment-id <environment-id> Dataverse 환경 ID
--dry-run 실행하지 않고 수행할 작업 표시
-v, --verbose 자세한 로깅 정보 표시 사용
-?, , -h--help 도움말 및 사용 정보 표시

develop-mcp publish

Dataverse 환경에 MCP 서버를 게시합니다.

a365 develop-mcp publish [options]

이 명령을 사용하여 MCP 서버를 지정된 Dataverse 환경에 게시합니다.

publish 옵션

Option Description
-e, --environment-id <environment-id> Dataverse 환경 ID
-s, --server-name <server-name> 게시할 MCP 서버 이름
-a, --alias <alias> MCP 서버의 별칭
-d, --display-name <display-name> MCP 서버의 표시 이름
--dry-run 실행하지 않고 수행할 작업 표시
-?, , -h--help 도움말 및 사용 정보 표시

develop-mcp unpublish

Dataverse 환경에서 MCP 서버를 게시 취소합니다.

a365 develop-mcp unpublish [options]

이 명령을 사용하여 지정된 Dataverse 환경에서 MCP 서버를 제거합니다.

unpublish 옵션

Option Description
-e, --environment-id <environment-id> Dataverse 환경 ID
-s, --server-name <server-name> 게시를 취소할 MCP 서버 이름
--dry-run 실행하지 않고 수행할 작업 표시
-?, , -h--help 도움말 및 사용 정보 표시

develop-mcp approve

MCP 서버를 승인합니다.

a365 develop-mcp approve [options]

이 명령은 환경에서 사용할 MCP 서버를 승인합니다.

approve 옵션

Option Description
-s, --server-name <server-name> 승인할 MCP 서버 이름
--dry-run 실행하지 않고 수행할 작업 표시
-?, , -h--help 도움말 및 사용 정보 표시

develop-mcp block

MCP 서버를 차단합니다.

a365 develop-mcp block [options]

이 명령을 사용하여 사용자 환경에서 MCP 서버가 사용되지 않도록 차단합니다.

block 옵션

Option Description
-s, --server-name <server-name> 차단할 MCP 서버 이름
--dry-run 실행하지 않고 수행할 작업 표시
-?, , -h--help 도움말 및 사용 정보 표시

develop-mcp package-mcp-server

Microsoft 관리 센터에서 제출할 MCP 서버 패키지를 생성합니다.

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

이 명령을 사용하여 Microsoft 관리 센터에 제출할 수 있는 MCP 서버에 대한 배포 패키지를 만듭니다.

package-mcp-server 옵션

Option Description
--server-name <server-name> MCP 서버 이름(필수)
--developer-name <developer-name> 게시자 또는 개발자 표시 이름(필수)
--icon-url <icon-url> MCP 서버의 PNG 아이콘에 대한 공용 URL(필수)
--output-path <output-path> 생성된 ZIP 패키지의 대상 디렉터리(필수)
--dry-run 실행하지 않고 수행할 작업 표시
-?, , -h--help 도움말 및 사용 정보 표시

develop-mcp register-external-mcp-server

Entra, 외부 OAuth, API 키, 또는 인증 없이 외부 MCP 서버를 등록하세요.

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

이 명령어를 사용해 외부에서 호스팅된(제3자) MCP 서버를 테넌트에 등록하세요. 이 명령어는 플랫폼이 필요로 하는 Microsoft Entra 앱 등록을 생성하고, Agent 365 플랫폼을 호출하여 MCP 서버를 추가하며, 새 앱 등록에 대해 리디렉션 URI와 API 권한을 설정합니다.

서버 이름은 접두사로 ext_ 시작해야 하며 최대 20자(예: ext_MyServer)여야 합니다. 도구 이름은 원격 MCP 서버에서 노출된 이름과 정확히 일치해야 합니다. 이름이 맞지 않으면 실행 시 도구 호출이 실패합니다.

매개변수를 제공하는 방법은 세 가지입니다:

  • 명령줄 옵션으로 전달하세요.
  • .을 포함한 --input-fileJSON 파일을 제공합니다. 명령줄 옵션은 파일의 값을 덮어씁니다. 파일 구조는 CLI 템플릿에서 확인하세요 register-external-mcp-server-sample.json .
  • 인터랙티브로 프롬프트할 필요한 값은 생략하세요.

등록이 성공한 후, 테넌트 관리자에게 새 MCP 서버 승인을 요청해 보세요. 만약 에 등록 ExternalOAuth했다면, 표시된 리디렉션 URI를 외부 IDP 애플리케이션에도 추가하세요.

Important

Microsoft Entra 앱 등록이 생성된 후 등록이 실패하면, 앱이 자동으로 롤백되지 않습니다. 다시 시도하기 전에 Azure 포털에서 수동으로 삭제하세요.

register-external-mcp-server 옵션

일부 옵션은 설명란에 설명된 특정 인증 유형에만 필요합니다.

Option Description
-s, --server-name <server-name> MCP 서버 이름. 예를 들어, 최대 20자로 시작 ext_ 해야 합니다 ext_MyServer
-u, --server-url <server-url> 원격 MCP 서버 URL. 유효한 HTTP 또는 HTTPS URL이어야 합니다
-a, --auth-type <auth-type> 인증 유형: EntraOAuth, ExternalOAuth, APIKey, 또는 NoAuth
--publisher <publisher> Publisher 이름 (패키지 메타데이터에 사용됨)
--description <description> 서버 설명 (패키지 메타데이터에 사용됨)
--tools <tools> 예를 들어, 이 서버에서 노출된 도구 이름의 쉼표 구분 목록 tool1,tool2,tool3
-f, --input-file <input-file> 등록 매개변수가 포함된 JSON 파일 경로
--remote-scopes <remote-scopes> 예를 api://{appId-guid}/{scopeName}들어, 원격 MCP 서버의 범위 . EntraOAuth에 사용됩니다.
-t, --tenant-id <tenant-id> 앱 등록을 위한 Entra tenant ID. 현재 az login 세입자로 기본 설정
--service-tree-id <service-tree-id> Entra 앱 등록용 ServiceTree ID입니다. Microsoft 기업 테넌트에서 필수
--idp-authorization-url <url> 외부 OAuth 권한 URL. --auth-type ExternalOAuth 때 필요합니다.
--idp-token-url <url> 외부 OAuth 토큰 URL. --auth-type ExternalOAuth 때 필요합니다.
--idp-scopes <scopes> 외부 OAuth 스코프. --auth-type ExternalOAuth 때 필요합니다.
--idp-client-id <client-id> 외부 OAuth 클라이언트 ID. --auth-type ExternalOAuth 때 필요합니다.
--idp-client-secret <client-secret> 외부 OAuth 클라이언트 비밀. --auth-type ExternalOAuth 때 필요합니다.
--api-key-location <location> API 키 위치: Header 또는 Query. --auth-type APIKey 때 필요합니다.
--api-key-name <name> API 키 매개변수 또는 헤더 이름, 예를 들어 X-API-Keytoken. --auth-type APIKey 때 필요합니다.
--dry-run 실행하지 않고 수행할 작업 표시
-v, --verbose 자세한 로깅 정보 표시 사용
-?, , -h--help 도움말 및 사용 정보 표시
  • Last updated on