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

IDE의 Q Developer에 대한 MCP 구성

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

MCP 구성 UI 액세스

IDE의 Q Developer에서 MCP 구성 UI에 액세스하는 방법:

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

  2. Q Developer 패널을 엽니다.

  3. 채팅 패널을 엽니다.

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

MCP 서버 추가

AI 클라이언트와 MCP 서버 간의 통신을 위한 두 가지 기본 전송 메커니즘은 STDIO와 HTTP입니다.

HTTP MCP 서버 추가

IDE에 HTTP MCP 서버를 추가하는 방법:

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

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

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

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

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

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

  6. URL 필드에 MCP 서버가 초기화할 때 직접 호출할 URL을 입력합니다.

  7. 헤더 - 선택 사항에서 HTTP 요청 헤더로 전송해야 하는 키-값 페어를 입력할 수 있습니다.

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

  9. 저장을 선택합니다.

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

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

참고

MCP HTTP 엔드포인트에 인증이 필요한 경우 Amazon Q는 사용자가 Amazon Q에 MCP 서버에 액세스할 수 있는 권한을 부여할 수 있도록 브라우저 페이지를 자동으로 엽니다.

STDIO MCP 서버 추가

IDE에 STDIO MCP 서버를 추가하는 방법:

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

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

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

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

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

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

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

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

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

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

    AWS 설명서 MCP 서버의 경우 인수는 awslabs.aws-documentation-mcp-server@latest입니다. 이는 Python 패키지 인덱스(PyPI)에서 호스팅되는 패키지를 가리키는 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. 각 도구에 대해 다음 권한 수준 중 하나를 설정할 수 있습니다.

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

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

    • 거부: 이 도구를 사용하지 마세요.