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

# 커넥터
<a name="connections-desktop"></a>

**설정** > **기능의** **커넥터** 탭을 사용하면 웹 커넥터, MCP 서버 및 코딩 에이전트를 관리할 수 있습니다. 이름으로 커넥터를 검색하거나, 목록을 새로 고치거나, 추가 커넥터를 찾아보거나, **\+** 생성 버튼을 사용하여 새 커넥터를 생성할 수 있습니다.

## 웹 커넥터
<a name="connections-desktop-web-connectors"></a>

웹 커넥터는 Quick을 Slack, Microsoft Outlook, Jira, Google Calendar 등과 같은 외부 서비스에 연결합니다. 서비스를 연결하면 Quick은 대화 및 에이전트 실행 중에 해당 서비스에서 읽고 쓸 수 있습니다.

통합별 설정 가이드는 섹션을 참조하세요[통합 관련 가이드](integration-guides.md).

### 서비스 연결
<a name="connections-desktop-connecting"></a>

1. **설정을** 확장한 다음 **기능을** 선택합니다.

1. **커넥터** 탭의 **웹 커넥터**에서 서비스를 찾습니다.

1. 나열된 커넥터가 없는 경우 **찾아보**기를 선택하여 사용 가능한 커넥터를 검색합니다.

1. 해당 서비스의 인증 흐름을 완료합니다.

나열된 커넥터 이외의 커넥터를 찾아보고 추가하려면 **자세히 찾아보**기를 선택합니다. 웹에 추가된 커넥터는 데스크톱 애플리케이션에 자동으로 표시됩니다.

## MCP 서버
<a name="connections-desktop-mcp-servers"></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. **Connectors(커넥터)** 탭을 선택합니다.

1. **MCP 서버** 섹션에서 **\+ 생성을** 선택한 다음 **MCP 서버를** 선택합니다.

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

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

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

1. **저장**을 선택합니다.

#### 가져오기
<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. **Connectors(커넥터)** 탭을 선택합니다.

1. **MCP 서버** 섹션에서 **\+ 생성을** 선택한 다음 **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. **Connectors(커넥터)** 탭을 선택합니다.

1. **MCP 서버** 섹션에서 **\+ 생성을** 선택한 다음 **MCP 서버를** 선택합니다.

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

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

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

1. **저장**을 선택합니다.

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

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

### 예약된 작업에서 MCP 도구 사용
<a name="mcp-scheduled-tasks"></a>

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

예약된 작업에 MCP 기능을 연결하려면 상단 표시줄에서 **Mission Control**을 열고 작업을 선택한 다음 **기능** 탭을 선택하고 사용할 MCP 서버를 선택합니다.

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

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

코딩 에이전트는 Quick이 개발 작업을 위임할 수 있는 외부 AI 코딩 도구입니다. 에이전트 클라이언트 프로토콜(ACP)을 사용하여 Kiro 또는 Claude Code와 같은 도구와 통신합니다. 활성화되면 Quick에 구현을 위해 코딩 에이전트로 작업을 보내도록 요청할 수 있습니다. 각 코딩 에이전트에는 이름, 설명 및 이를 활성화하거나 비활성화하는 토글이 표시됩니다.

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

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

1. **Connectors(커넥터)** 탭을 선택합니다.

1. **코딩 에이전트** 섹션에서 **\+ 생성을** 선택한 다음 **코딩 에이전트**를 선택합니다.

1. 에이전트 연결 설정을 구성하고 **저장**을 선택합니다.

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

## 활동 피드 통합
<a name="connections-desktop-activity-feed"></a>

메시징, 이메일 또는 일정 서비스를 연결한 후 활동 피드에 항목을 표시하는 서비스를 구성할 수 있습니다. 피드 소스를 구성하려면 **설정을** 확장하고 **사용자 지정**을 선택한 다음 **활동 피드**를 선택합니다.