CLI의 MCP 구성 - Amazon Q Developer
구성 명령원격 MCP 서버

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

CLI의 MCP 구성

이 페이지에서는 MCP 서버를 구성하기 위한 CLI별 옵션을 다룹니다.

구성 명령

사용량: qchat mcp [OPTIONS] COMMAND

MCP 구성 명령
명령 Description
qchat mcp add 구성된 서버 추가 또는 교체
qchat mcp remove MCP 구성에서 서버 제거
qchat mcp list 구성된 서버 나열
qchat mcp import 다른 파일에서 서버 구성 가져오기
qchat mcp status 구성된 서버의 상태 가져오기
qchat mcp help 지정된 하위 명령에 대한 명령 또는 도움말 목록 인쇄

MCP 서버 인수

--args 파라미터는 이제 이스케이프 또는 JSON 배열 형식을 사용하는 쉼표 포함 인수를 지원합니다.

# Escaped commas
q mcp add --name server --command cmd --args "arg1,arg2\,with\,commas,arg3"

# JSON array format  
q mcp add --name server --command cmd --args '["arg1", "arg2,with,commas", "arg3"]'

원격 MCP 서버

프로세스로 실행되는 로컬 MCP 서버 외에도 Amazon Q Developer CLI는 HTTP를 통해 통신하는 원격 MCP 서버를 지원합니다. 원격 서버는 OAuth 인증을 사용하거나 열려 있을 수 있습니다(인증 필요 없음).

구성

원격 MCP 서버는 type 및 url 필드를 사용하여 에이전트 구성 파일에 구성됩니다.

{
  "mcpServers": {
    "find-a-domain": {
      "type": "http",
      "url": "https://api.findadomain.dev/mcp"
    }
  }
}

OAuth 인증 흐름

OAuth 인증이 필요한 원격 MCP 서버를 사용하는 경우:

  1. 원격 MCP 서버가 포함된 에이전트로 Q CLI 세션 시작

  2. 서버는 처음에 "아직 로드되지 않음"으로 표시됩니다.

  3. /mcp 명령을 사용하여 인증 시작

  4. Q CLI는 서버에 인증이 필요함을 표시하고 URL을 제공합니다.

  5. Q CLI 세션을 열어 두고 브라우저에서 제공된 URL을 엽니다.

  6. 브라우저의 인증 지침을 따릅니다.

  7. Q CLI 창으로 돌아가기 - 인증에 성공하면 MCP 서버에 로그인됩니다.

인증이 완료되면 서버의 도구를 사용할 수 있게 됩니다.