VS Code에 MCP 추가하기: 도구를 넘어서
2025년 5월 14일 | Harald Kirschner
VS Code에 에이전트 모드를 처음 도입했을 때, 채팅을 통해 코드 및 작업 공간과 상호 작용하는 새로운 방법을 열었습니다. 에이전트에게 파일을 검사하고, 빌드를 실행하고, 심지어 테스트를 디버깅하도록 요청할 수 있었습니다. 하지만 모델이 학습한 내용과 작업 공간의 내용에 의해 제한되었습니다. 따라서 다음 단계는 명확했습니다. 에이전트가 이러한 경계를 넘어 안전하고 사용자 제어 방식으로 실제 외부 서비스와 상호 작용할 수 있는 방법이 필요했습니다.
첫 번째 시도는 친숙한 VS Code 패턴인 Tools 및 Chat participants API를 통한 확장성을 따랐습니다. 이는 이미 생태계에 수천 개의 확장이 있다는 점을 고려할 때 합리적이었지만, 업계는 새로운 표준인 Model Context Protocol(MCP)을 향해 빠르게 움직이고 있었습니다. MCP는 HTTP가 웹 통신을 표준화한 것처럼 AI 에이전트를 다양한 외부 도구 및 서비스와 일관된 방식으로 연결하는 프로토콜로 이해하는 것이 가장 좋습니다. 목표는 VS Code뿐만 아니라 모든 클라이언트가 데이터베이스, 코드 검색, 배포 시스템과 같은 강력한 도구 서버를 연결하고 "그냥 작동"하도록 하는 것입니다.
MCP로의 전환은 거의 하룻밤 사이에 더 넓은 생태계를 열었습니다. 이제 VS Code 사용자는 프론트엔드 검증을 위한 Playwright MCP Server, 리포지토리 인사이트 및 풀 리퀘스트를 위한 GitHub MCP Server, 또는 더 스마트한 API 사용을 위한 Context7과 같은 서버를 활용할 수 있습니다. 서버 목록은 계속 성장하고 있으며 MCP는 AI 에이전트에 추가 기능을 제공하는 데 있어 빠르게 기반이 되고 있습니다.
모두를 위한 MCP 만들기: VS Code의 디자인 원칙 적용
VS Code의 디자인 철학은 항상 강력한 기능을 사용하기 쉽게 만들고, 기본적으로 안전하며, 사용자에게 명확한 제어를 제공하는 데 중점을 두었습니다. 이러한 동일한 원칙이 MCP 통합을 안내했습니다.
이전에는 MCP 서버를 시작하려면 JSON 블록을 구성 파일에 복사하고 명령줄 플래그를 관리해야 했습니다. 이를 단순화하고자 했습니다. **MCP: Add Server** 명령을 사용하면 패키지 관리자(NPM, PyPI, Docker)에서 서버를 설정하고 VS Code가 나머지를 처리하도록 할 수 있습니다. 웹사이트는 온보딩을 더욱 간소화하기 위해 'VS Code에 설치' 버튼을 제공할 수도 있으며, VS Code는 가능한 경우 Claude Desktop과 같은 다른 클라이언트의 구성을 자동으로 검색합니다.
보안도 또 다른 주요 초점이었습니다. MCP 서버의 비밀 관리는 소스 제어에 암호를 커밋하는 것을 의미해서는 안 됩니다. 비밀을 한 번 프롬프트하고 암호화하여 안전하게 저장하는 입력 변수와 로컬 개발을 위해 이미 신뢰하는 기존 .env 파일을 참조하는 지원을 추가했습니다. 이를 통해 팀은 구성을 안전하게 공유하고 검토할 수 있습니다.
사용자 제어는 경험의 중심입니다. 도구 선택기를 통해 특정 세션에서 에이전트가 액세스할 수 있는 도구를 결정하고 명확한 설명과 컨트롤을 볼 수 있습니다. 서버를 개발하거나 디버깅하는 사용자를 위해 VS Code는 로그를 표시하고 서버를 시작, 중지 및 다시 시작하기 쉽게 만듭니다. 이러한 세심한 배려 덕분에 MCP는 강력할 뿐만 아니라 최종 사용자와 서버 개발자 모두에게 접근하기 쉽습니다.
기본 이상: 더 풍부한 MCP 기능
도구에 대한 기본 호환성을 구현하는 것으로 여정이 끝나지 않았습니다. MCP의 많은 가치는 사양의 더 깊은 기능에서 비롯됩니다. 이러한 기능은 완벽하게 지원될 때 도구를 더욱 문맥적이고 적응적이며 강력하게 만듭니다.
예를 들어, 루트 지원을 통해 MCP 서버는 작업 공간의 구조를 이해할 수 있습니다. 사용자가 폴더 경로를 묻거나 구성에 의존할 필요 없이 서버는 작업 공간 폴더 목록을 미리 받아 해당 프로젝트에 맞게 도구를 조정할 수 있습니다. 이를 통해 모노레포 전체의 모든 TODO를 찾거나 감지된 인프라 파일에 따라 배포 도구를 활성화하는 등의 사용 사례를 지원합니다.
동적 도구 검색을 통해 서버는 실시간으로 사용 가능한 도구 집합을 변경할 수 있습니다. 정적 목록 대신 서버는 컨텍스트나 프로젝트 상태에 따라 도구를 조정할 수 있습니다. 예를 들어 워크플로가 진행됨에 따라 다른 작업을 표시하거나 코드베이스에서 감지된 프레임워크와 관련된 도구를 표시할 수 있습니다. 이를 통해 에이전트의 기능은 관련성을 유지하고 깔끔함을 유지합니다. 실제 사용 사례는 TypeScript SDK의 동적 서버 예제 또는 GitHub MCP Server의 동적 도구 세트 검색 기능을 확인하십시오.
가장 최근의 VS Code 업데이트는 도구 주석에 대한 지원도 추가했습니다. 이를 통해 서버는 사람이 읽을 수 있는 이름이나 도구를 읽기 전용 모드로 실행해야 하는지에 대한 힌트와 같은 유용한 메타데이터를 도구에 제공할 수 있습니다. 이러한 세부 정보는 에이전트의 동작과 사용자 이해도를 모두 향상시킵니다.
마지막으로, 스트림 가능한 HTTP는 MCP 사양의 최신 전송으로 지원됩니다. 이를 통해 원격 서버 통합이 더욱 원활하고 확장 가능해지며, 특히 클라우드 호스팅 또는 서버리스 도구 공급자의 경우 더욱 그렇습니다.
우리의 목표는 VS Code에서 최신 MCP 기능을 지원하여 사용자가 풍부한 AI 경험을 누리고 서버 개발자가 자신감을 가지고 이러한 기능을 구현할 수 있도록 하는 것입니다.
생태계 성장: 협업 및 다음 단계
MCP는 현재 GitHub, Playwright, Azure, Perplexity의 공식 서버를 지원하고 있으며 생태계는 계속 커지고 있습니다. VS Code를 차별화하는 것은 조기 채택뿐만 아니라 사양 우선 엔지니어링에 대한 약속입니다. MCP 사양을 면밀히 따르고 권한 부여, 검색 및 보안에 대한 개선 사항을 다시 기여함으로써 프로토콜이 성숙함에 따라 이를 형성하는 데 도움을 주고 있으며, 생태계의 혁신이 VS Code 사용자뿐만 아니라 모두에게 혜택을 주도록 보장합니다.
앞으로 우리는 VS Code에 사양에 이미 포함된 향후 MCP 기능인 권한 부여, 프롬프트, 리소스 및 샘플링을 지원하기 위해 적극적으로 노력하고 있습니다. 이러한 추가 기능은 제품에 통합될 때 더욱 풍부하고 유연한 에이전트 통합을 제공할 것입니다.
개발자 도구 또는 인프라를 구축하고 있다면 MCP는 이제 VS Code 및 그 이상에서 AI 에이전트에 액세스할 수 있도록 하는 실용적이고 개방적인 방법입니다. 기성품 서버를 사용하거나 자신만의 서버를 만들고 싶든, 경험은 강력하고 간단해야 합니다.
시작하려면 ModelContextProtocol.io, VS Code MCP 문서 또는 GitHub의 참조 서버를 확인하십시오.
여러분이 구축할 것과 생태계가 확장됨에 따라 에이전트 워크플로우가 어떻게 발전할지 기대됩니다.
행복한 코딩 되세요!