매번 맥락을 설명한다는 당연한 관행을 버리면, 개발은 이렇게까지 달라질 것이다.
AI 코딩 툴을 사용하면서 이런 경험이 있으신가요.
채팅欄에 “이 프로젝트의 파일 구성은 이렇게 되고, GitHub의 이 이슈 내용은 이렇게 되어”와 같은 비슷한 소개를 매번 건네고 나서야 비로소 본론에 들어가게 된다. 아무리 AI가 뛰어나더라도 AI가 “지금 눈 앞에 무엇이 있는지”를 모르는 상태에서 시작하기 때문에 결국 인간 측이 정보를 전달하는 역할을 하게 된다.
AI 코딩에서 가장 큰 어려움은 바로 “정보 접근의 부담”이라는 점이라고 생각됩니다. 커서나 VS Code는 매우 지능적인 AI 어시스턴트를 내장하고 있지만, 초기 상태에서는 단순히 “현재 열린 코드”만을 분석합니다. 데이터베이스 내용, GitHub에 쌓인 이슈, 외부 문서 등은 기본적으로는 보지 못한 상태에서 시작됩니다.
그 벽을 제거하기 위해 설계된 것이 모델 컨텍스트 프로토콜, 즉 MCP입니다. MCP는 2024년 11월에 Anthropic에서 공개한 AI 어시스턴트와 외부 도구 및 외부 데이터를 연결하기 위한 공통 규격입니다. 이 규격에 대응한 서버를 하나 설정하면 Cursor나 VS Code 에이전트가 외부 데이터베이스나 API, 파일群 등에 직접 접근할 수 있게 됩니다.
즉, MCP는 “AI에게 매번 설명을 하는” 과정을 그 자체로 완전히 생략하는 메커니즘이라고 생각하면 이해하기 쉽습니다.
이 글에서는 MCP라는 단어를 들어봤지만, 실제로 어떻게 설정해야 하는지 전혀 모르는 분들을 위해 커서(Cursor)와 VS Code 각각에서의 설정 방법, 어떤 구성이 대세로 소개되는지, 그리고 설정 파일의 내용을 하나씩 꼼꼼하게 설명해 드립니다. 읽어 낼 때쯤에는 “이 방법이면 제 환경에도 적용해 볼 수 있겠구나”라고 생각하실 수 있을 것입니다.
🧩먼저 MCP의 작동 원리를 명확히 이해합시다.
📦MCP는 “번역가”라고 생각하면 이해하기 쉬운
MCP의 기술적인 설명을 읽어보면 “호스트”, “클라이언트”, “서버”라는 용어가 등장하여 처음에는 혼란스러울 수 있는 부분입니다. 이 부분을 정리해 보겠습니다.
호스트는 커서나 VS Code와 같이 실제로 사용하시는 애플리케이션 자체를 의미합니다.
클라이언트는 호스트 내부에 있는 “연결 담당” 부분입니다. 호스트 안에 내장되어 있으며, 평소에는 의식할 필요가 없습니다.
서버는 이번의 주역입니다. GitHub, 데이터베이스, 파일 시스템 등 외부의 정보나 도구를 MCP라는 공통 언어로 변환하여 AI 에이전트에게 전달하는 작은 프로그램을 의미합니다.
구조적으로는 “Cursor(호스트)”가 “MCP 서버”에 문의를 보내고, 서버가 외부 데이터를 가져와 AI 에이전트가 사용할 수 있는 형태로 반환하는 방식입니다.
플러그(🔌) 서버와의 통신 방법은 주로 2가지 종류입니다.
MCP 서버와의 통신 방식에는 크게 두 가지 패턴이 있습니다.
출처: note 원문
번역: Gemma 3(.44) 초벌 + 교정 10청크
원문 보기 | 출처: note.com