IDE의 Q Developer에 대한 MCP 구성 - Amazon Q Developer
IDE 사용MCP 서버 추가MCP 구성 문제 해결MCP 서버 활성화MCP 서버 비활성화현재 활성화된 MCP 서버 삭제현재 비활성화된 MCP 서버 삭제도구 권한 검토 및 조정

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

IDE의 Q Developer에 대한 MCP 구성

이 페이지에서는 MCP 서버를 구성하기 위한 IDE별 옵션을 다룹니다. MCP 구성에 대한 일반적인 내용은 MCP 구성 이해를 참조하세요.

MCP 구성 UI 액세스

다음 이미지는 IDE에서 Q Developer용 MCP 서버를 구성하는 데 사용되는 GUI를 보여줍니다.

MCP 구성의 기본 요소에 대한 필드가 있는 GUI입니다.

IDE의 Q Developer에서 MCP 구성 UI에 액세스하려면:

  1. IDE(VS Code, JetBrains 등)를 엽니다.

  2. Q Developer 패널을 엽니다.

  3. 채팅 패널을 엽니다.

  4. 도구 아이콘을 선택합니다. tools icon

MCP 서버 추가

IDE에 MCP 서버를 추가하려면:

  1. MCP 구성 UI에 액세스합니다.

  2. 더하기(+) 기호를 선택합니다.

  3. 글로벌 또는 로컬 범위를 선택합니다.

    전역 범위를 선택하면 MCP 서버 구성이 ~/.aws/amazonq/mcp.json에 저장되고 모든 프로젝트에서 사용할 수 있습니다. 로컬 범위를 선택하면 구성이 현재 프로젝트 내의 .amazonq/mcp.json에 저장됩니다.

  4. 이름 필드에 MCP 서버의 이름을 입력합니다.

    예를 들어 AWS 설명서 MCP 서버를 설치하는 경우 이름은 AWS DocMCPServer일 수 있습니다.

  5. 전송 프로토콜을 선택합니다.

    현재 stdio만 지원됩니다.

  6. 명령 필드에 MCP 서버가 초기화될 때 실행할 셸 명령을 입력합니다.

    AWS 설명서 MCP 서버의 경우 명령은 입니다uvx. 이는 임시 Python 환경을 uv tool run생성하는의 별칭입니다.

  7. 인수 필드에 해당하는 경우 셸 명령에 부여할 인수를 입력합니다.

    AWS 설명서 MCP 서버의 경우 인수는 awslabs.aws-documentation-mcp-server@latest입니다. 이는 PyPI(Python 패키지 인덱스)에서 PyPI 패키지 식별자입니다.

    필요에 따라 인수를 더 추가합니다.

  8. 해당하는 경우 환경 변수를 입력합니다.

    이 예제의 경우 먼저 이름: FASTMCP_LOG_LEVEL 및 값: ERROR를 입력합니다.

    또한 AWS_DOCUMENTATION_PARTITION이라는 이름과 값 aws를 사용하여 작업할 파티션을 나타냅니다.

  9. 해당하는 경우 제한 시간 값을 입력합니다.

    이 예제에서는 권장 값인 60(초)을 유지합니다.

  10. 저장을 선택합니다.

    구성 패널이 도구 권한 패널로 대체됩니다.

  11. 의 절차를 따릅니다도구 권한 검토 및 조정.

MCP 구성 문제 해결

IDE에 MCP 서버를 추가하면 Amazon Q가 해당 서버에 연결을 시도합니다.

연결 문제가 있는 경우 패널 상단에 알림이 표시됩니다. 알림이 해결될 때까지 해당 MCP 서버의 도구가 제대로 작동할 것으로 기대해서는 안 됩니다.

적절한 변경을 수행할 수 있도록 구성 수정을 선택하여 MCP 구성 화면으로 돌아갑니다.

MCP 서버 활성화

다음 절차에서는 해당 MCP 서버가 아직 활성화되지 않은 것으로 가정합니다.

IDE에서 MCP 서버를 활성화하려면:

  1. MCP 서버 패널을 엽니다.

  2. 활성화하려는 서버 옆에 있는 활성화를 선택합니다.

MCP 서버 비활성화

IDE에서 MCP 서버를 비활성화하려면:

  1. MCP 서버 패널을 엽니다.

  2. 비활성화할 서버를 선택합니다.

  3. 설정 편집 옆에 있는 세 개의 점을 선택합니다.

  4. MCP 서버 비활성화를 선택합니다.

현재 활성화된 MCP 서버 삭제

IDE에서 현재 활성화된 MCP 서버를 삭제하려면:

  1. MCP 서버 패널을 엽니다.

  2. 삭제할 서버를 선택합니다.

    해당 서버에 대한 세부 정보가 포함된 패널이 열립니다.

  3. 설정 편집 옆에 있는 세 개의 점을 선택합니다.

  4. MCP 서버 삭제를 선택합니다.

  5. 메시지가 표시되면 삭제를 확인합니다.

현재 비활성화된 MCP 서버 삭제

IDE에서 현재 비활성화된 MCP 서버를 삭제하려면:

  1. MCP 서버 패널을 엽니다.

  2. 삭제하려는 서버 옆에 있는 삭제를 선택합니다.

  3. 메시지가 표시되면 삭제를 확인합니다.

도구 권한 검토 및 조정

도구 권한을 검토하고 조정하려면:

  1. MCP 서버 패널을 엽니다.

  2. 권한을 검토하고 조정하려는 MCP 서버를 선택합니다.

  3. 각 도구에 대해 다음 권한 수준 중 하나를 설정할 수 있습니다.

    • 질문: 도구를 사용할 때마다 권한을 묻는 프롬프트입니다.

    • 항상 허용: 프롬프트 없이 도구를 실행할 수 있습니다.

    • 거부:이 도구를 사용하지 마십시오.

  4. 저장 또는 적용을 선택하여 권한 설정을 업데이트합니다.