기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # IDE의 Q Developer에 대한 MCP 구성 이 페이지에서는 MCP 서버를 구성하기 위한 IDE별 옵션을 다룹니다. ## IDE의 Q Developer에 대한 MCP 구성 파일 이해 GUI를 사용하여 IDE의 Q Developer에 MCP 서버를 추가하면 구성이 다음 두 파일 중 하나에 저장됩니다. + 글로벌 범위: \~/.aws/amazonq/default.json + 로컬 범위: .amazonq/default.json 그러나 레거시 이유로 MCP 구성 정보를 다른 두 위치에 넣을 수도 있습니다. + 글로벌 범위: \~/.aws/amazonq/mcp.json + 로컬 범위: .amazonq/mcp.json Q Developer는 MCP 서버, 권한 및 저장된 설정에 대한 워크스페이스 수준 구성에 우선 순위를 부여합니다. **참고** mcp.json 파일에서 MCP 구성을 이미 설정했고 MCP 구성 GUI를 처음 사용하는 경우 GUI에 해당 구성이 표시됩니다. 레거시 mcp.json 파일에 대한 지원은 글로벌 default.json 구성 파일의 useLegacyMcpJson 필드에 의해 활성화됩니다. 기본적으로 이 필드는 true로 설정되어 있습니다. 자세한 내용은 Q Developer CLI GitHub 리포지토리의 [UseLegacyMcpJson 필드를](https://github.com/aws/amazon-q-developer-cli/blob/main/docs/agent-format.md#uselegacymcpjson-field) 참조하세요. mcp.json 파일은 Q CLI에서도 사용할 수 있습니다. MCP 도구에 세분화된 제어를 설정하는 방법에 대한 자세한 내용은 [기본 제공 도구 참조](https://github.com/aws/amazon-q-developer-cli/blob/main/docs/agent-format.md#tools-field)를 참조하세요. ## MCP 구성 UI 액세스 IDE의 Q Developer에서 MCP 구성 UI에 액세스하는 방법: 1. IDE(VS Code, JetBrains 등)를 엽니다. 1. Q Developer 패널을 엽니다. 1. **채팅** 패널을 엽니다. 1. 도구 아이콘을 선택합니다. ![tools icon](http://docs.aws.amazon.com/ko_kr/amazonq/latest/qdeveloper-ug/images/tools-icon-full.png) ## MCP 서버 추가 AI 클라이언트와 MCP 서버 간의 통신을 위한 두 가지 기본 전송 메커니즘은 STDIO와 HTTP입니다. ### HTTP MCP 서버 추가 IDE에 HTTP MCP 서버를 추가하는 방법: 1. [MCP 구성 UI에 액세스합니다](#mcp-ide-configuration-access-ui). 1. 더하기(\+) 기호를 선택합니다. 1. 글로벌 또는 로컬 중 해당 범위를 선택합니다. 전역 범위를 선택하면 MCP 서버 구성이 \~/.aws/amazonq/default.json에 저장되고 모든 프로젝트에서 사용할 수 있습니다. 로컬 범위를 선택하면 구성이 현재 프로젝트 내의 .amazonq/default.json에 저장됩니다. 1. **이름** 필드에 MCP 서버의 이름을 입력합니다. 1. 전송 프로토콜로 `http`를 선택합니다. 1. **URL** 필드에 MCP 서버가 초기화할 때 직접 호출할 URL을 입력합니다. 1. **헤더 - 선택 사항**에서 HTTP 요청 헤더로 전송해야 하는 키-값 페어를 입력할 수 있습니다. 1. 해당하는 경우 **제한 시간** 값을 입력합니다. 1. **저장**을 선택합니다. 구성 패널이 도구 권한 패널로 대체됩니다. 1. [도구 권한 검토 및 조정](#mcp-ide-configuration-review-adjust-tool)의 절차를 따릅니다. **참고** MCP HTTP 엔드포인트에 인증이 필요한 경우 Amazon Q는 사용자가 Amazon Q에 MCP 서버에 액세스할 수 있는 권한을 부여할 수 있도록 브라우저 페이지를 자동으로 엽니다. ### STDIO MCP 서버 추가 IDE에 STDIO MCP 서버를 추가하는 방법: 1. [MCP 구성 UI에 액세스합니다](#mcp-ide-configuration-access-ui). 1. 더하기(\+) 기호를 선택합니다. 1. 글로벌 또는 로컬 중 해당 범위를 선택합니다. 전역 범위를 선택하면 MCP 서버 구성이 \~/.aws/amazonq/default.json에 저장되고 모든 프로젝트에서 사용할 수 있습니다. 로컬 범위를 선택하면 구성이 현재 프로젝트 내의 .amazonq/default.json에 저장됩니다. 1. **이름** 필드에 MCP 서버의 이름을 입력합니다. 예를 들어 [AWS 설명서 MCP 서버](https://awslabs.github.io/mcp/servers/aws-documentation-mcp-server/)를 설치하는 경우 이름은 {{AWS DocMCPServer}}일 수 있습니다. 1. 전송 프로토콜로 `stdio`를 선택합니다. 1. **명령** 필드에 MCP 서버가 초기화될 때 실행할 쉘 명령을 입력합니다. AWS 설명서 MCP 서버의 경우 명령은 입니다`uvx`. 이는 임시 Python 환경을 생성하는 `uv tool run`의 별칭입니다. 1. 해당하는 경우 **인수** 필드에 쉘 명령에 부여할 인수를 입력합니다. AWS 설명서 MCP 서버의 경우 인수는 {{awslabs.aws-documentation-mcp-server@latest}}입니다. 이는 Python 패키지 인덱스(PyPI)에서 호스팅되는 패키지를 가리키는 PyPI 패키지 식별자입니다. 필요에 따라 인수를 더 추가합니다. 1. 해당하는 경우 환경 변수를 입력합니다. 이 예제의 경우 먼저 이름: {{FASTMCP\_LOG\_LEVEL}} 및 값: {{ERROR}}를 입력합니다. 또한 {{AWS\_DOCUMENTATION\_PARTITION}}이라는 이름과 값 {{aws}}를 사용하여 작업할 [파티션](https://docs.aws.amazon.com/whitepapers/latest/aws-fault-isolation-boundaries/partitions.html)을 표시합니다. 1. 해당하는 경우 **제한 시간** 값을 입력합니다. 이 예제에서는 권장 값인 60(초)을 유지합니다. 1. **저장**을 선택합니다. 구성 패널이 도구 권한 패널로 대체됩니다. 1. [도구 권한 검토 및 조정](#mcp-ide-configuration-review-adjust-tool)의 절차를 따릅니다. ## MCP 구성 문제 해결 IDE에 MCP 서버를 추가하면 Amazon Q가 해당 서버에 연결을 시도합니다. 연결 문제가 있는 경우 패널 상단에 알림이 표시됩니다. 알림 사항이 해결될 때까지 해당 MCP 서버의 도구가 제대로 작동할 것으로 기대해서는 안 됩니다. 적절한 변경을 수행할 수 있도록 **구성 수정**을 선택하여 MCP 구성 화면으로 돌아갑니다. ## MCP 서버 활성화 다음 절차에서는 해당 MCP 서버가 아직 활성화되지 않은 것으로 가정합니다. IDE에서 MCP 서버를 활성화하는 방법: 1. MCP 서버 패널을 엽니다. 1. 활성화하려는 서버 옆에 있는 **활성화**를 선택합니다. ## MCP 서버 비활성화 IDE에서 MCP 서버를 비활성화하는 방법: 1. MCP 서버 패널을 엽니다. 1. 비활성화할 서버를 선택합니다. 1. **설정 편집** 옆에 있는 세 개의 점을 선택합니다. 1. **MCP 서버 비활성화**를 선택합니다. ## 현재 활성화된 MCP 서버 삭제 IDE에서 현재 활성화된 MCP 서버를 삭제하는 방법: 1. MCP 서버 패널을 엽니다. 1. 삭제하려는 서버를 선택합니다. 해당 서버에 대한 세부 정보가 포함된 패널이 열립니다. 1. **설정 편집** 옆에 있는 세 개의 점을 선택합니다. 1. **MCP 서버 삭제**를 선택합니다. 1. 메시지가 표시되면 삭제를 확인합니다. ## 현재 비활성화된 MCP 서버 삭제 IDE에서 현재 비활성화된 MCP 서버를 삭제하는 방법: 1. MCP 서버 패널을 엽니다. 1. 삭제하려는 서버 옆에 있는 **삭제**를 선택합니다. 1. 메시지가 표시되면 삭제를 확인합니다. ## 도구 권한 검토 및 조정 도구 권한을 검토하고 조정하는 방법: 1. MCP 서버 패널을 엽니다. 1. 권한을 검토하고 조정할 MCP 서버를 선택합니다. 1. 각 도구에 대해 다음 권한 수준 중 하나를 설정할 수 있습니다. + 질문: 도구를 사용할 때마다 권한을 묻는 프롬프트가 표시됩니다. + 항상 허용: 프롬프트 없이 도구를 실행할 수 있습니다. + 거부: 이 도구를 사용하지 마세요.