# 연동 (/ko/docs/verdent-manager/core-features/integration)

> 서드파티 도구와 서비스를 연결하기 위해 Verdent 확장 프로그램을 찾아보고, 설치하고, 관리합니다



Tool Integration은 확장 프로그램을 찾아보고, 설치하고, 관리하기 위한 Verdent의 시스템입니다. 복잡한 API 스크립트를 수동으로 설정하는 대신, 몇 번만 선택하면 플러그인을 설치할 수 있습니다.

플러그인을 추가하면 Verdent이 공식 마켓플레이스에서 안전한 패키지를 다운로드하고, 무결성을 확인한 뒤, 새 배포 명령, 데이터베이스 관리 Skill, 워크플로 자동화 도구 등 모든 구성 요소를 자동으로 등록합니다.

## 지원되는 연동 [#지원되는-연동]

현재 마켓플레이스에서 사용할 수 있는 인기 플러그인:

| 도구       | 일반적인 사용 사례                                    |
| -------- | --------------------------------------------- |
| GitHub   | PR 보기, 이슈 관리, Actions 실행                      |
| Stripe   | 결제 조회, 구독 관리, 매출 분석                           |
| Supabase | 데이터베이스 읽기/쓰기, 사용자 관리, 테이블 쿼리                  |
| Notion   | 문서와 데이터베이스 쿼리, 페이지 생성, 지식 베이스 관리, 프로젝트 정보 동기화 |
| Linear   | 이슈와 프로젝트 관리, 개발 진행 상황 추적, 작업 상태 동기화           |

## 플러그인 설치 [#플러그인-설치]

<Steps>
  <Step title="Settings 열기">
    Verdent을 실행하고 **Settings**로 이동합니다.
  </Step>

  <Step title="Integrations 탭 열기">
    플러그인은 두 섹션으로 나뉘어 표시됩니다.

    * **Installed** — 이미 설치한 플러그인
    * **Recommended** — 마켓플레이스에서 사용할 수 있는 플러그인
  </Step>

  <Step title="플러그인 선택">
    **Recommended** 섹션에서 아무 플러그인 카드나 선택해 세부 정보를 엽니다.
  </Step>

  <Step title="Verdent에 추가">
    기능과 구성 요소를 검토한 다음 **Add to Verdent**를 선택합니다. 플러그인은 자동으로 다운로드, 검증, 설치됩니다.
  </Step>

  <Step title="MCP 연결">
    안내에 따라 해당 MCP을 연결하면 플러그인이 외부 서비스에 접근할 수 있습니다.
  </Step>
</Steps>

## 인증 [#인증]

플러그인마다 서로 다른 안전한 인증 방식을 사용합니다.

* **OAuth** — GitHub, Notion, Linear 같은 플러그인은 매끄러운 OAuth 흐름을 지원합니다. Verdent이 클라이언트 자격 증명을 자동으로 처리하므로, 브라우저에서 로그인하고 승인하기만 하면 됩니다. 복사해 붙여넣을 필요가 없습니다.

<Note>
  사용자가 제공하는 모든 API 키 또는 액세스 토큰은 사용자의 기기에 로컬로 저장됩니다. Verdent은 사용자의 자격 증명을 당사 서버에 업로드하지 않습니다.
</Note>

## 플러그인 사용 [#플러그인-사용]

설치 후 플러그인을 사용하는 주요 방법은 두 가지입니다.

### Manager에 직접 말하기 [#manager에-직접-말하기]

Manager에게 자연스럽게 연동을 사용해 달라고 요청합니다.

* "내 최신 PR을 요약하기 위해 GitHub 연동을 사용해 줘"
* "내 Supabase 사용자 테이블에서 최근 등록된 사용자를 확인해 줘"

### Chat에서 사용해 보기 [#chat에서-사용해-보기]

어디서 시작해야 할지 잘 모르겠다면 **Settings → Integrations**로 이동해 설치된 플러그인을 선택한 다음 **Try in Chat**을 선택합니다. Settings가 닫히고 플러그인의 기본 프롬프트가 채팅 입력창에 삽입됩니다.

## 설치된 플러그인 관리 [#설치된-플러그인-관리]

Verdent이 접근할 수 있는 도구는 항상 사용자가 완전히 제어할 수 있습니다.

* **세부 정보 보기** — 설치된 플러그인 카드를 선택하면 정확한 구성 요소, 예를 들어 MCPs, Skills, Rules 등을 볼 수 있습니다.
* **제거** — 플러그인 세부 정보를 열고 **Uninstall**을 선택합니다. 확인 후 Verdent은 런타임 등록을 완전히 제거하고, 캐시된 파일을 삭제하며, 상태를 정리합니다.
* **재설치** — 언제든 **Recommended** 섹션에서 플러그인을 다시 찾아 재설치할 수 있습니다.

<Note>
  제거하면 모든 로컬 파일과 기능이 삭제됩니다. 완전히 연결을 해제하려면 서드파티 서비스 대시보드에서 OAuth 접근 권한을 철회하거나 API 키를 삭제해야 할 수도 있습니다.
</Note>

## 플러그인 안에 포함되는 것 [#플러그인-안에-포함되는-것]

연동에는 여러 구성 요소가 포함될 수 있습니다.

* **MCP Servers** — Verdent이 외부 서비스의 데이터를 읽고 쓸 수 있게 해 주는 표준화된 도구
* **Skills** — 작업별 AI 기능 또는 워크플로. 예: GitHub "code review" Skill
* **Subagents** — Manager가 복잡한 작업을 위임할 수 있는, 특정 목적에 집중한 독립 에이전트
* **Rules** — 특정 도구를 사용할 때 Verdent이 어떻게 동작해야 하는지 정의하는 사용자 지정 동작 지침
* **Commands** — 채팅에서 직접 실행할 수 있는 편리한 슬래시 명령. 예: `/deploy`

## 사용 사례 [#사용-사례]

### 코드 리뷰 및 병합 (GitHub) [#코드-리뷰-및-병합-github]

기능을 마친 뒤 이렇게 요청합니다.

> 내 최신 커밋으로 PR을 만들고 변경 사항을 요약해 줘.

Verdent은 GitHub 플러그인을 사용해 PR 초안을 만들고, 요약을 추가하며, CI/CD 상태를 확인합니다.

### 구독 관리 (Stripe) [#구독-관리-stripe]

고객이 청구 문제로 이메일을 보냈습니다.

> [user@example.com](mailto:user@example.com)의 Stripe 구독을 찾아서 마지막 결제가 성공했는지 확인해 줘.

Verdent이 데이터를 안전하게 가져오므로 Stripe 대시보드를 열 필요가 없습니다.

### 모니터링 (Supabase) [#모니터링-supabase]

Supabase를 연결한 뒤:

> 사용자 테이블에서 금융 유형 사용자의 고객 레코드를 가져와 줘.

Verdent이 데이터를 직접 가져와 표시합니다.

### 프로젝트 추적 (Linear) [#프로젝트-추적-linear]

회의 전에:

> Linear에서 이번 스프린트의 완료되지 않은 모든 이슈를 우선순위순으로 보여 줘.

Verdent이 진행 상황을 집계하며, 수정된 버그를 바로 Done으로 표시할 수 있습니다.

### 지식 및 문서 (Notion) [#지식-및-문서-notion]

> Notion에서 제품 요구사항 문서의 최신 버전을 찾고, 핵심 요구사항을 작업 목록으로 바꿔 줘.

Verdent이 콘텐츠를 가져와 구조화된 작업 목록을 자동으로 생성합니다.

<Note>
  SHA256으로 검증된 안전한 패키지를 사용하려면 항상 공식 Verdent 마켓플레이스를 통해 플러그인을 설치하세요.
</Note>