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

# CLI의 MCP 구성
CLI에서

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

## 구성 명령


사용량: `qchat mcp [OPTIONS] COMMAND ` 


**MCP 구성 명령**  

| 명령 | 설명 | 
| --- | --- | 
|  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 세션 시작

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

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

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

1. Q CLI 세션을 열어 둔 상태로 브라우저에서 제공된 URL을 엽니다.

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

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

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