기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
MCP 서버 구성
Amazon Quick 데스크톱 애플리케이션은 사용자 지정 도구 및 통합을 통해 Quick의 기능을 확장하는 개방형 표준인 모델 컨텍스트 프로토콜(MCP)을 지원합니다. MCP 서버를 연결하여 기본 제공 연결을 통해 사용할 수 없는 데이터베이스, 내부 APIs, 개발자 도구 및 기타 시스템에 빠르게 액세스할 수 있습니다.
MCP란 무엇입니까?
모델 컨텍스트 프로토콜(MCP)은 AI 어시스턴트가 외부 도구 및 데이터 소스와 상호 작용할 수 있도록 하는 프로토콜입니다. MCP 서버를 Quick에 연결하면 해당 서버에서 제공하는 도구를 채팅 대화 및 예약된 에이전트에서 사용할 수 있습니다. 예를 들어 데이터베이스 쿼리 도구를 제공하는 MCP 서버를 연결한 다음 Quick에 채팅에서 직접 데이터베이스를 쿼리하도록 요청할 수 있습니다.
MCP 설정 액세스
MCP 서버를 관리하려면 사이드바에서 설정을 열고 기능을 선택한 다음 MCP 탭을 선택합니다.
MCP 탭에는 검색 창, 필터 드롭다운, 그리드 또는 목록 보기 토글이 있는 연결된 서버가 표시됩니다. + MCP 추가를 선택하여 새 서버를 추가할 수 있습니다.
MCP 서버 추가
+ MCP 추가를 선택하면 로컬, 가져오기, 원격의 세 가지 연결 유형이 포함된 대화 상자가 나타납니다. MCP 서버 실행 방식과 일치하는 연결 유형을 선택합니다.
로컬
로컬 연결 유형을 사용하여 MCP 서버를 시스템에서 명령으로 실행합니다. 이는 개발 도구 및 로컬에 설치된 서버에 가장 일반적인 옵션입니다.
다음 표에서는 로컬 MCP 연결에 대한 필드를 설명합니다.
| Field | 필수 | 설명 |
|---|---|---|
| 이름 | 예 | 이 MCP 서버를 식별하기 위한 표시 이름(예: "내 데이터베이스 MCP"). |
| 명령 | 예 | 실행할 실행 파일입니다. 공통 값에는 python, node, 및 npx가 포함됩니다uvx. |
| 인수 | 아니요 | 공백으로 구분된 명령줄 인수(예: -m mcp_server --port 8080). |
| 설명 | 아니요 | 이 MCP 서버가 수행하는 작업과 제공하는 도구에 대한 설명입니다. 이렇게 하면 서버의 도구를 언제 사용해야 하는지 Quick이 이해하는 데 도움이 됩니다. |
| 환경 변수 | 아니요 | 서버에 필요한 환경 변수입니다. + 변수 추가를 선택하여 키-값 페어를 추가합니다. |
| 제한 시간(초) | 아니요 | 서버 시작을 기다리는 최대 시간은 5~300초입니다. 기본값은 30초입니다. |
로컬 MCP 서버를 추가하려면
다음 절차를 따르세요.
-
사이드바에서 설정을 열고 기능을 선택합니다.
-
MCP 탭을 선택합니다.
-
+ MCP 추가를 선택합니다.
-
연결 유형으로 Local을 선택합니다.
-
실행할 이름과 명령(예:
python)을 입력합니다. -
명령에 필요한 인수를 입력합니다(예:
-m my_mcp_server). -
+ MCP 추가를 선택하여 저장합니다.
가져오기
가져오기 연결 유형을 사용하여 기존 구성 파일에서 MCP 서버 구성을 로드합니다. 이는 다른 도구에 대해 이미 MCP 서버가 구성되어 있고 Quick에서 해당 구성을 재사용하려는 경우에 유용합니다.
Quick은 다음 도구의 구성 파일을 지원합니다.
Kiro
Claude Code
AIM
중력 방지
QuickWork 내보내기
다음 표에서는 MCP 연결 가져오기에 대한 필드를 설명합니다.
| Field | 필수 | 설명 |
|---|---|---|
| Config 파일 경로 | 예 | 시스템의 구성 파일 경로입니다(예: ~/.kiro/settings/mcp.json). |
구성 파일 경로를 입력하면 Quick은 파일을 자동으로 스캔하고 파일에 정의된 MCP 서버를 감지합니다. 또한 Quick은 시스템에 설치된 도구를 감지하여 이 시스템에서 감지됨 아래에 칩(예: "Kiro", "AIM", "Claude Code")으로 표시합니다.
구성 파일에서 MCP 서버를 가져오려면
다음 절차를 따르세요.
-
사이드바에서 설정을 열고 기능을 선택합니다.
-
MCP 탭을 선택합니다.
-
+ MCP 추가를 선택합니다.
-
연결 유형으로 가져오기를 선택합니다.
-
기존 MCP 구성 파일의 Config 파일 경로를 입력합니다.
-
감지된 서버 및 시스템 도구를 검토합니다.
-
파일 로드를 선택하여 서버를 가져옵니다.
원격
원격 연결 유형을 사용하여 HTTP를 통해 원격 시스템 또는 클라우드 서비스에서 실행되는 MCP 서버에 연결합니다. 이는 공유 팀 서버 또는 호스팅 MCP 서비스에 유용합니다.
다음 표에서는 원격 MCP 연결에 대한 필드를 설명합니다.
| Field | 필수 | 설명 |
|---|---|---|
| 이름 | 예 | 이 MCP 서버를 식별하기 위한 표시 이름입니다. |
| URL | 예 | MCP 엔드포인트의 URL입니다(예: https://mcp.example.com/sse). |
| 토큰 | 아니요 | 원격 서버를 사용한 인증을 위한 보유자 토큰입니다. |
| 설명 | 아니요 | 이 MCP 서버가 수행하는 작업과 제공하는 도구에 대한 설명입니다. |
| 제한 시간(초) | 아니요 | 서버가 응답할 때까지 기다리는 최대 시간은 5~300초입니다. 기본값은 30초입니다. |
원격 MCP 서버를 추가하려면
다음 절차를 따르세요.
-
사이드바에서 설정을 열고 기능을 선택합니다.
-
MCP 탭을 선택합니다.
-
+ MCP 추가를 선택합니다.
-
연결 유형으로 원격을 선택합니다.
-
MCP 엔드포인트의 이름과 URL을 입력합니다.
-
(선택 사항) 서버에 인증이 필요한 경우 토큰을 입력합니다.
-
+ MCP 추가를 선택하여 저장합니다.
MCP 서버 관리
MCP 서버를 추가하면 MCP 탭에 서버가 나타납니다. 다음 기능을 사용하여 서버를 관리할 수 있습니다.
-
검색 - 검색 창을 사용하여 이름으로 서버를 찾습니다.
-
필터 - 드롭다운 필터를 사용하여 모든 서버를 표시하거나 상태별로 필터링합니다.
-
보기 토글 - 그리드 보기와 목록 보기 간에 전환합니다.
-
토글 - 개별 MCP 서버를 제거하지 않고 켜거나 끕니다.
-
편집 - 서버 구성을 수정합니다.
-
제거 - 서버 연결을 삭제합니다.
코딩 에이전트
MCP 탭에는 MCP 서버 아래에 코딩 에이전트 섹션도 포함되어 있습니다. 코딩 에이전트는 에이전트 클라이언트 프로토콜(ACP)을 사용하여 Kiro 또는 Claude Code와 같은 로컬 코딩 에이전트에 코딩 작업을 위임합니다.
코딩 에이전트를 추가하려면
다음 절차를 따르세요.
-
사이드바에서 설정을 열고 기능을 선택합니다.
-
MCP 탭을 선택합니다.
-
에이전트 코딩 섹션에서 + 에이전트 추가를 선택합니다.
-
에이전트 연결 설정을 구성합니다.
-
구성을 저장합니다.
코딩 에이전트를 구성한 후 채팅에서 해당 에이전트에 태스크를 위임할 수 있습니다. 예를 들어 "Kiro를 사용하여이 모듈 리팩터링" 또는 "Claude Code에이 함수에 대한 테스트를 작성하도록 요청"이라고 말할 수 있습니다. 는 작업을 코딩 에이전트로 빠르게 디스패치하고 결과를 다시 보고합니다.
예약된 에이전트에서 MCP 도구 사용
예약된 에이전트에 MCP 서버를 기능으로 연결할 수 있습니다. 예약된 에이전트를 생성하거나 편집할 때 에이전트가 액세스할 수 있는 MCP 서버를 선택할 수 있습니다. 이렇게 하면 자동화된 에이전트가 일정에 따라 실행될 때 사용자 지정 도구를 사용할 수 있습니다.
예약된 에이전트에 MCP 기능을 연결하려면 설정 > 기능 > 예약된 작업에서 에이전트를 열고 해당 에이전트의 기능 탭을 선택한 다음 사용 가능한 MCP 서버를 선택합니다.
참고
예약된 에이전트가 도구를 사용하려고 할 때 MCP 서버가 실행되고 액세스 가능해야 합니다. 로컬 MCP 서버의 경우 필요할 때 서버 프로세스가 자동으로 시작됩니다. 원격 서버의 경우 서버가 온라인 상태이고 연결 가능한지 확인합니다.
