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

# MCP 서버 구성
<a name="mcp-servers-desktop"></a>

Amazon Quick 데스크톱 애플리케이션은 사용자 지정 도구 및 통합을 통해 Quick의 기능을 확장하는 개방형 표준인 모델 컨텍스트 프로토콜(MCP)을 지원합니다. MCP 서버를 연결하여 기본 제공 연결을 통해 사용할 수 없는 데이터베이스, 내부 APIs, 개발자 도구 및 기타 시스템에 빠르게 액세스할 수 있습니다.

## MCP란 무엇입니까?
<a name="mcp-what-is"></a>

모델 컨텍스트 프로토콜(MCP)은 AI 어시스턴트가 외부 도구 및 데이터 소스와 상호 작용할 수 있도록 하는 프로토콜입니다. MCP 서버를 Quick에 연결하면 해당 서버에서 제공하는 도구를 채팅 대화 및 예약된 에이전트에서 사용할 수 있습니다. 예를 들어 데이터베이스 쿼리 도구를 제공하는 MCP 서버를 연결한 다음 Quick에 채팅에서 직접 데이터베이스를 쿼리하도록 요청할 수 있습니다.

## MCP 설정 액세스
<a name="mcp-accessing-settings"></a>

MCP 서버를 관리하려면 사이드바에서 **설정을** 열고 **기능을** 선택한 다음 **MCP** 탭을 선택합니다.

MCP 탭에는 검색 창, 필터 드롭다운, 그리드 또는 목록 보기 토글이 있는 연결된 서버가 표시됩니다. **\+ MCP 추가를 선택하여 새 서버를 추가할 수 있습니다**.

## MCP 서버 추가
<a name="mcp-adding-server"></a>

**\+ MCP 추가**를 선택하면 **로컬**, **가져오기**, **원격**의 세 가지 연결 유형이 포함된 대화 상자가 나타납니다. MCP 서버 실행 방식과 일치하는 연결 유형을 선택합니다.

### 로컬
<a name="mcp-local"></a>

**로컬** 연결 유형을 사용하여 MCP 서버를 시스템에서 명령으로 실행합니다. 이는 개발 도구 및 로컬에 설치된 서버에 가장 일반적인 옵션입니다.

다음 표에서는 로컬 MCP 연결에 대한 필드를 설명합니다.


| Field | 필수 | 설명 | 
| --- | --- | --- | 
| 이름 | 예 | 이 MCP 서버를 식별하기 위한 표시 이름(예: "내 데이터베이스 MCP"). | 
| 명령 | 예 | 실행할 실행 파일입니다. 공통 값에는 python, node, 및 npx가 포함됩니다uvx. | 
| 인수 | 아니요 | 공백으로 구분된 명령줄 인수(예: -m mcp\_server --port 8080). | 
| 설명 | 아니요 | 이 MCP 서버가 수행하는 작업과 제공하는 도구에 대한 설명입니다. 이렇게 하면 서버의 도구를 언제 사용해야 하는지 Quick이 이해하는 데 도움이 됩니다. | 
| 환경 변수 | 아니요 | 서버에 필요한 환경 변수입니다. \+ 변수 추가를 선택하여 키-값 페어를 추가합니다. | 
| 제한 시간(초) | 아니요 | 서버 시작을 기다리는 최대 시간은 5\~300초입니다. 기본값은 30초입니다. | 

**로컬 MCP 서버를 추가하려면**  
다음 절차를 따르세요.

1. 사이드바에서 **설정을** 열고 **기능을** 선택합니다.

1. **MCP** 탭을 선택합니다.

1. **\+ MCP 추가**를 선택합니다.

1. 연결 유형으로 **Local**을 선택합니다.

1. 실행할 **이름과** **명령**(예: `python`)을 입력합니다.

1. 명령에 필요한 **인수**를 입력합니다(예: `-m my_mcp_server`).

1. **\+ MCP 추가**를 선택하여 저장합니다.

### 가져오기
<a name="mcp-import"></a>

**가져오기** 연결 유형을 사용하여 기존 구성 파일에서 MCP 서버 구성을 로드합니다. 이는 다른 도구에 대해 이미 MCP 서버가 구성되어 있고 Quick에서 해당 구성을 재사용하려는 경우에 유용합니다.

Quick은 다음 도구의 구성 파일을 지원합니다.
+ Kiro
+ Claude Code
+ AIM
+ 중력 방지
+ QuickWork 내보내기

다음 표에서는 MCP 연결 가져오기에 대한 필드를 설명합니다.


| Field | 필수 | 설명 | 
| --- | --- | --- | 
| Config 파일 경로 | 예 | 시스템의 구성 파일 경로입니다(예: \~/.kiro/settings/mcp.json). | 

구성 파일 경로를 입력하면 Quick은 파일을 자동으로 스캔하고 파일에 정의된 MCP 서버를 감지합니다. 또한 Quick은 시스템에 설치된 도구를 감지하여 **이 시스템에서 감지됨** 아래에 칩(예: "Kiro", "AIM", "Claude Code")으로 표시합니다.

**구성 파일에서 MCP 서버를 가져오려면**  
다음 절차를 따르세요.

1. 사이드바에서 **설정을** 열고 **기능을** 선택합니다.

1. **MCP** 탭을 선택합니다.

1. **\+ MCP 추가**를 선택합니다.

1. 연결 유형으로 **가져오기**를 선택합니다.

1. 기존 MCP 구성 **파일의 Config 파일 경로를** 입력합니다.

1. 감지된 서버 및 시스템 도구를 검토합니다.

1. **파일 로드를** 선택하여 서버를 가져옵니다.

### 원격
<a name="mcp-remote"></a>

**원격** 연결 유형을 사용하여 HTTP를 통해 원격 시스템 또는 클라우드 서비스에서 실행되는 MCP 서버에 연결합니다. 이는 공유 팀 서버 또는 호스팅 MCP 서비스에 유용합니다.

다음 표에서는 원격 MCP 연결에 대한 필드를 설명합니다.


| Field | 필수 | 설명 | 
| --- | --- | --- | 
| 이름 | 예 | 이 MCP 서버를 식별하기 위한 표시 이름입니다. | 
| URL | 예 | MCP 엔드포인트의 URL입니다(예: https://mcp.example.com/sse). | 
| 토큰 | 아니요 | 원격 서버를 사용한 인증을 위한 보유자 토큰입니다. | 
| 설명 | 아니요 | 이 MCP 서버가 수행하는 작업과 제공하는 도구에 대한 설명입니다. | 
| 제한 시간(초) | 아니요 | 서버가 응답할 때까지 기다리는 최대 시간은 5\~300초입니다. 기본값은 30초입니다. | 

**원격 MCP 서버를 추가하려면**  
다음 절차를 따르세요.

1. 사이드바에서 **설정을** 열고 **기능을** 선택합니다.

1. **MCP** 탭을 선택합니다.

1. **\+ MCP 추가**를 선택합니다.

1. 연결 유형으로 **원격**을 선택합니다.

1. MCP 엔드포인트의 **이름과** **URL**을 입력합니다.

1. (선택 사항) 서버에 인증이 필요한 경우 **토큰**을 입력합니다.

1. **\+ MCP 추가**를 선택하여 저장합니다.

## MCP 서버 관리
<a name="mcp-managing-servers"></a>

MCP 서버를 추가하면 MCP 탭에 서버가 나타납니다. 다음 기능을 사용하여 서버를 관리할 수 있습니다.
+ **검색** - 검색 창을 사용하여 이름으로 서버를 찾습니다.
+ **필터** - 드롭다운 필터를 사용하여 모든 서버를 표시하거나 상태별로 필터링합니다.
+ **보기 토글** - 그리드 보기와 목록 보기 간에 전환합니다.
+ **토글** - 개별 MCP 서버를 제거하지 않고 켜거나 끕니다.
+ **편집** - 서버 구성을 수정합니다.
+ **제거** - 서버 연결을 삭제합니다.

## 코딩 에이전트
<a name="mcp-coding-agents"></a>

MCP 탭에는 MCP 서버 아래에 **코딩 에이전트** 섹션도 포함되어 있습니다. 코딩 에이전트는 에이전트 클라이언트 프로토콜(ACP)을 사용하여 Kiro 또는 Claude Code와 같은 로컬 코딩 에이전트에 코딩 작업을 위임합니다.

**코딩 에이전트를 추가하려면**  
다음 절차를 따르세요.

1. 사이드바에서 **설정을** 열고 **기능을** 선택합니다.

1. **MCP** 탭을 선택합니다.

1. **에이전트 코딩** 섹션에서 **\+ 에이전트 추가**를 선택합니다.

1. 에이전트 연결 설정을 구성합니다.

1. 구성을 저장합니다.

코딩 에이전트를 구성한 후 채팅에서 해당 에이전트에 태스크를 위임할 수 있습니다. 예를 들어 "Kiro를 사용하여이 모듈 리팩터링" 또는 "Claude Code에이 함수에 대한 테스트를 작성하도록 요청"이라고 말할 수 있습니다. 는 작업을 코딩 에이전트로 빠르게 디스패치하고 결과를 다시 보고합니다.

## 예약된 에이전트에서 MCP 도구 사용
<a name="mcp-scheduled-agents"></a>

예약된 에이전트에 MCP 서버를 기능으로 연결할 수 있습니다. 예약된 에이전트를 생성하거나 편집할 때 에이전트가 액세스할 수 있는 MCP 서버를 선택할 수 있습니다. 이렇게 하면 자동화된 에이전트가 일정에 따라 실행될 때 사용자 지정 도구를 사용할 수 있습니다.

예약된 에이전트에 MCP 기능을 연결하려면 **설정** > **기능** > **예약된 작업**에서 에이전트를 열고 해당 에이전트의 **기능** 탭을 선택한 다음 사용 가능한 MCP 서버를 선택합니다.

**참고**  
예약된 에이전트가 도구를 사용하려고 할 때 MCP 서버가 실행되고 액세스 가능해야 합니다. 로컬 MCP 서버의 경우 필요할 때 서버 프로세스가 자동으로 시작됩니다. 원격 서버의 경우 서버가 온라인 상태이고 연결 가능한지 확인합니다.