# MCP 연동 (/ko/docs/verdent-for-vscode/advanced-features/mcp)
> Model Context Protocol 서버와 플러그인으로 Verdent 확장하기
### 학습 내용 [#학습-내용]
Verdent for VS Code에서 Model Context Protocol(MCP) 연동을 개괄적으로 살펴봅니다. 설정, 구성, 확장 옵션을 포함합니다.
포괄적인 MCP 문서는 현재 개발 중입니다. 이 페이지에서는 MCP 기능을 개괄적으로 소개하며, 자세한 가이드는 곧 제공될 예정입니다. 구체적인 연동 질문은 [support@verdent.ai](mailto:support@verdent.ai)로 문의하세요.
***
## MCP(Model Context Protocol)이란? [#mcpmodel-context-protocol이란]
Model Context Protocol(MCP)은 외부 도구, 데이터 소스, 서비스에 연결해 Verdent의 기능을 확장하는 연동 시스템입니다.
**핵심 개념:**
MCP를 사용하면 Verdent이 기본 제공 도구 세트를 넘어서는 시스템과 상호작용할 수 있으며, 다음과 원활하게 연동할 수 있습니다.
* 외부 API 및 웹 서비스
* 데이터베이스 시스템
* 클라우드 플랫폼(AWS, Azure, GCP)
* 프로젝트 관리 도구
* CI/CD 파이프라인
* 맞춤 내부 도구
**아키텍처:**
MCP 서버는 Verdent와 외부 시스템 사이의 브리지 역할을 합니다. 각 MCP 서버는 특정 기능을 노출하며, Verdent은 코딩 세션 중 `file_read` 또는 `bash` 같은 기본 제공 도구와 비슷한 방식으로 이를 호출할 수 있습니다.
**구성 저장소:**
MCP 서버 구성은 `~/.verdent/mcp.json`에 저장되며 설정 메뉴에서 관리합니다.
***
## MCP 연동의 장점 [#mcp-연동의-장점]
### 확장된 기능 [#확장된-기능]
**외부 시스템 접근:**
기본 기능으로는 사용할 수 없는 도구와 서비스에 Verdent을 연결합니다. 코딩 워크플로를 벗어나지 않고 데이터베이스를 쿼리하거나, 클라우드 서비스와 상호작용하거나, 프로젝트별 API와 연동할 수 있습니다.
**맞춤 도구 개발:**
프로젝트의 고유한 요구사항에 맞춘 MCP 서버를 만들 수 있습니다. 내부 도구, 독점 API, 도메인 특화 시스템을 위한 전문 연동을 구축하세요.
### 상호 운용성 [#상호-운용성]
**생태계 활용:**
성장 중인 MCP 생태계를 활용하세요. 커뮤니티에서 개발한 MCP 서버는 인기 도구와 서비스를 위한 사전 구축 연동을 제공합니다.
**표준화된 프로토콜:**
MCP는 도구 연동을 위한 일관된 인터페이스를 제공하여, 새로운 기능이 Verdent의 기존 도구 시스템과 자연스럽게 통합되도록 합니다.
### 워크플로 자동화 [#워크플로-자동화]
**원활한 연동:**
MCP 서버는 Verdent의 도구 세트 일부가 됩니다. 에이전트는 적절한 경우 MCP 도구를 자동으로 사용하거나, 특정 작업을 위해 사용자가 명시적으로 호출할 수 있습니다.
**컨텍스트 인식 작업:**
MCP 연동은 코드베이스 컨텍스트를 이해하므로, 현재 개발 상태를 기반으로 외부 시스템과 지능적으로 상호작용할 수 있습니다.
***
## MCP 서버 설정 [#mcp-서버-설정]
### 구성 절차 [#구성-절차]
**MCP 설정 열기:**
1. Verdent에서 설정 메뉴를 엽니다.
2. **MCP Servers** 섹션으로 이동합니다.
3. `~/.verdent/mcp.json` 구성을 확인하거나 수정합니다.
**구성 파일:**
MCP 서버는 `~/.verdent/mcp.json` 파일을 통해 구성되며, 이 파일은 서버 연결, 인증, 연동 매개변수를 정의합니다.
자세한 MCP 구성 스키마와 설정 안내는 마무리 중입니다. MCP 서버 설정에 대한 즉각적인 도움이 필요하면 MCP 프로토콜 명세를 참고하거나 Verdent 지원팀에 문의하세요.
### 구성 관리 [#구성-관리]
**서버 추가:**
연결 세부정보와 인증 자격 증명을 포함한 항목을 `mcp.json`에 추가하여 새 MCP 서버를 구성합니다.
**여러 서버:**
Verdent은 여러 MCP 서버를 동시에 지원하므로 여러 외부 시스템과 동시에 연동할 수 있습니다.
**연결 테스트:**
개발 워크플로에서 사용하기 전에 MCP 서버 구성을 검증하여 연결이 성공하는지 확인합니다.
***
## MCP 플러그인 및 확장 [#mcp-플러그인-및-확장]
### 사용 가능한 플러그인 [#사용-가능한-플러그인]
MCP 플러그인은 일반적인 도구와 서비스를 위한 사전 구축 연동을 제공합니다.
사용 가능한 MCP 플러그인의 선별 목록을 정리 중입니다. 현재 플러그인 사용 가능 여부는 공식 Verdent 문서 또는 MCP 생태계 리소스를 확인하세요.
**예상 플러그인 범주:**
* **데이터베이스 연동:** PostgreSQL, MySQL, MongoDB 쿼리 도구
* **클라우드 서비스:** AWS, Azure, GCP API 상호작용
* **개발자 도구:** GitHub, GitLab, Jira, Linear 연동
* **CI/CD 플랫폼:** Jenkins, GitHub Actions, CircleCI
* **모니터링 서비스:** Datadog, New Relic, Sentry
* **커뮤니케이션:** Slack, Discord, Microsoft Teams 알림
### 플러그인 설치 [#플러그인-설치]
**설치 방법:**
플러그인은 MCP 설정 인터페이스를 통해 설치하고 구성하며, 일반적으로 다음이 필요합니다.
* 플러그인 식별자 또는 소스
* 구성 매개변수
* 인증 자격 증명(해당하는 경우)
**의존성 관리:**
MCP 플러그인은 외부 서비스나 라이브러리에 대한 의존성이 있을 수 있습니다. 설치 과정은 가능한 경우 의존성 해결을 자동으로 처리합니다.
***
## 맞춤 MCP 서버 개발 [#맞춤-mcp-서버-개발]
### 맞춤 서버 만들기 [#맞춤-서버-만들기]
고급 사용자는 독점 도구 또는 도메인 특화 시스템을 연동하기 위해 맞춤 MCP 서버를 만들 수 있습니다.
**개발 방식:**
맞춤 MCP 서버는 MCP 프로토콜 명세를 구현하고, Verdent이 호출할 수 있는 도구 기능을 노출합니다.
**맞춤 서버 사용 사례:**
* **내부 API 연동:** 회사별 API 및 서비스에 연결
* **레거시 시스템 브리지:** Verdent가 레거시 인프라와 상호작용할 수 있도록 지원
* **특수 데이터 소스:** 독점 데이터베이스 또는 데이터 웨어하우스에 접근
* **워크플로 자동화:** 맞춤 빌드, 배포 또는 테스트 파이프라인 실행
프로토콜 구현 요구사항, SDK 문서, 테스트 도구를 포함한 포괄적인 맞춤 MCP 서버 개발 가이드는 개발 중입니다. 즉시 맞춤 연동이 필요하면 MCP 프로토콜 명세를 참고하세요.
### 연동 패턴 [#연동-패턴]
**워크스페이스 수준 구성:**
MCP 서버는 프로젝트별 연동을 위해 워크스페이스 수준에서 구성할 수 있으며, 팀은 버전 관리를 통해 MCP 구성을 공유할 수 있습니다.
**도구 상호 운용성:**
MCP에서 제공하는 도구는 Verdent의 기본 제공 도구(`file_read`, `bash`, `spawn_subagent`)와 원활하게 통합되어, 여러 도구 유형을 결합한 복잡한 워크플로를 지원합니다.
***
## MCP 워크플로 예시 [#mcp-워크플로-예시]
### 데이터베이스 쿼리 연동 [#데이터베이스-쿼리-연동]
**시나리오:** 데이터 문제를 디버깅하기 위해 프로덕션 데이터베이스를 쿼리합니다.
**MCP 방식:**
```
User: "Check the orders table for customer ID 12345"
Verdent: [Uses MCP database server to execute safe read-only query]
Results: 3 orders found for customer 12345
[Displays formatted results]
```
MCP 데이터베이스 서버가 인증, 쿼리 검증, 결과 형식화를 처리합니다.
### 클라우드 서비스 상호작용 [#클라우드-서비스-상호작용]
**시나리오:** AWS Lambda 함수 로그에서 오류를 확인합니다.
**MCP 방식:**
```
User: "Show me recent errors from the payment-processor Lambda function"
Verdent: [Invokes MCP AWS integration]
[Retrieves CloudWatch logs for specified function]
[Filters for ERROR level entries]
[Presents formatted error summaries]
```
MCP AWS 서버가 인증, API 호출, 로그 파싱을 관리합니다.
### CI/CD 파이프라인 모니터링 [#cicd-파이프라인-모니터링]
**시나리오:** 변경사항을 배포하기 전에 빌드 상태를 확인합니다.
**MCP 방식:**
```
User: "Is the main branch build passing?"
Verdent: [Queries MCP CI/CD integration]
Build #245: ✓ Passed (2 minutes ago)
All tests passed, ready for deployment
```
MCP CI/CD 서버가 파이프라인 상태를 추적하고 실시간 피드백을 제공합니다.
***
## 보안 고려사항 [#보안-고려사항]
### 인증 및 권한 부여 [#인증-및-권한-부여]
**자격 증명 관리:**
MCP 서버는 외부 서비스에 대한 인증을 처리합니다. 자격 증명은 MCP 구성에 안전하게 저장되며 채팅 기록이나 코드에 노출되지 않습니다.
**권한 범위 지정:**
MCP 서버에는 필요한 최소 권한만 구성합니다. 가능하면 읽기 전용 접근을 사용하고, 파괴적인 작업은 제한하세요.
### 안전한 작업 [#안전한-작업]
**명령 검토:**
MCP 도구가 포함된 작업은 실행 전에 Manual Accept Mode에서 검토할 수 있어 가시성과 제어를 제공합니다.
**감사 로깅:**
MCP 서버 작업은 Verdent의 채팅 기록에 표시되어 외부 시스템 상호작용의 감사 추적을 만듭니다.
***
## MCP 연동 문제 해결 [#mcp-연동-문제-해결]
### 일반적인 문제 [#일반적인-문제]
**연결 실패:**
* MCP 서버에 대한 네트워크 연결을 확인합니다.
* `mcp.json`의 인증 자격 증명을 확인합니다.
* MCP 서버가 실행 중이고 접근 가능한지 확인합니다.
* 구성 파일 문법을 검증합니다.
**권한 오류:**
* API 키 또는 자격 증명에 필요한 권한이 있는지 확인합니다.
* 서비스 할당량 또는 속도 제한을 확인합니다.
* 방화벽 규칙이 MCP 트래픽을 허용하는지 확인합니다.
**도구 호출 문제:**
* MCP 서버가 예상 도구를 올바르게 노출하는지 확인합니다.
* 도구 매개변수 형식이 서버 기대값과 일치하는지 확인합니다.
* 오류 세부정보는 MCP 서버 로그를 검토합니다.
### 도움받기 [#도움받기]
**지원 채널:**
* Verdent 지원: [support@verdent.ai](mailto:support@verdent.ai)
* [MCP 프로토콜 문서](https://modelcontextprotocol.io)
* 실시간 지원을 위한 [Verdent Discord 커뮤니티](https://discord.com/invite/NGjXEZcbJq)
**진단 정보:**
MCP 문제를 보고할 때는 다음을 제공하세요.
* MCP 서버 유형 및 버전
* 구성 세부정보(자격 증명은 제거)
* 채팅 기록의 오류 메시지
* MCP 서버 로그(접근 가능한 경우)
***
## MCP 문서 리소스 [#mcp-문서-리소스]
### 공식 문서 [#공식-문서]
다음을 포함한 포괄적인 MCP 연동 가이드를 개발 중입니다.
* 전체 MCP 프로토콜 명세
* 서버 개발 SDK 문서
* 플러그인 마켓플레이스 및 레지스트리
* 연동 예시 및 튜토리얼
* 맞춤 서버 개발을 위한 API 참조
**곧 제공 예정:**
* 단계별 MCP 서버 설정 가이드
* 플러그인 설치 및 구성 안내
* 맞춤 서버 개발 튜토리얼
* MCP 연동 모범 사례
* MCP 워크플로 성능 최적화
### 임시 리소스 [#임시-리소스]
**현재 MCP 정보:**
* MCP 프로토콜 명세(외부)
* 커뮤니티에서 개발한 MCP 서버 및 예시
* MCP 생태계 GitHub 저장소
**세부정보 문의:**
즉각적인 MCP 연동 지원이 필요하면 구체적인 사용 사례와 연동 요구사항을 [support@verdent.ai](mailto:support@verdent.ai)로 보내 주세요.
***
## 함께 보기 [#함께-보기]
기본 제공 도구 기능
기타 확장 방법
Verdent 설정 및 환경설정
효과적인 프롬프트 기법