VS Code 에이전트 모드 활용법: 자율 코딩과 MCP 서버로 앱 만들기

핵심 메시지

• VS Code의 채팅은 Ask(답변), Edit(파일 수정), Agent(자율 작업) 세 가지 모드로 나뉘며, 에이전트 모드는 사용자 설정에서 켤 수 있다.
• 에이전트 모드는 개발자처럼 의존성 설치·터미널 명령·파일 수정을 스스로 수행하되, 명령 실행이나 웹 접근에는 사용자 허가를 받는다.
• LLM에는 학습 컷오프가 있어 최신 문서를 모르므로, fetch 도구로 공식 문서 URL을 주고 "지침을 그대로 따르라"고 명시하면 정확도가 올라간다.
• MCP(모델 컨텍스트 프로토콜) 서버를 통해 VS Code가 Postgres 같은 데이터베이스와 대화할 수 있다.
• PRD(요구사항 문서)를 주면 에이전트가 약 30분 만에 완성 앱을 만들어냈고, 모델 키 직접 연결로 Gemini나 로컬 Ollama 모델도 쓸 수 있다.

쉽게 이해하기

VS Code에 한꺼번에 도착한 새 AI 기능들을 소개하는 영상이다. 핵심은 에이전트 모드이며, 그 밖에 새로운 코드 완성 모델, MCP 서버, 모델 키 직접 연결(Bring Your Own Key) 등이 함께 다뤄진다. 발표자는 이 기능들만으로 완성된 애플리케이션 한 개를 만들어 보인다.

채팅 사이드바의 드롭다운에는 Ask, Edit, Agent 세 모드가 있다. Ask는 답만 돌려주고, Edit는 파일을 생성·수정할 권한을 가지며, Agent는 한 발 더 나아가 의존성 설치와 터미널 명령까지 스스로 실행한다. 에이전트 모드가 아직 보이지 않으면 사용자 설정에서 "agent"를 검색해 체크박스를 켜면 된다.

Astro 프로젝트에 Tailwind CSS를 설치하는 예시에서, 세 모드 모두 처음에는 틀린 답을 내놓는다. 사용 중인 Claude 3.5의 학습 컷오프가 2024년 4월인데 설치 문서는 2025년에 갱신되었기 때문이다. 해결책은 fetch 도구로 공식 문서 URL을 전달하고 "지침을 정확히 따르라"고 지시하는 것이다. 그러면 에이전트는 이미 있는 프로젝트 생성 단계를 건너뛰고 설정 파일 수정, 전역 CSS 생성, 개발 서버 실행까지 문서대로 진행한다.

보안 측면에서 에이전트는 터미널 명령 실행이나 웹 페이지 열람 전에 반드시 허가를 요청한다. 변경 사항은 자동 저장되지만 "keep"을 누르기 전까지는 되돌릴 수 있어, 커밋 전에 안전하게 실험할 수 있다.

데이터베이스 연동은 MCP 서버로 해결한다. MCP 서버는 로컬에서 실행되는 작은 프로그램으로 Postgres 같은 시스템과 대화하는 방법을 알고, VS Code는 모델 컨텍스트 프로토콜로 그 프로그램과 통신한다. mcp.so 등에서 서버를 찾아 NPM·Docker·Python 형태로 설치하고 연결 문자열을 넣으면, 에이전트가 스스로 쿼리를 만들어 스키마를 조회한다. 마지막으로 발표자는 PRD를 건네 약 30분 만에 링크 목록 공유 앱을 완성시키고, 모델 키를 직접 넣어 Gemini 2.5 Pro나 로컬 Ollama 모델로 바꿔 쓰는 모습까지 보여준다.

주요 인사이트

• 같은 프롬프트라도 모드에 따라 결과의 성격이 다르다. Ask는 정보 제공, Edit는 파일 반영, Agent는 실제 실행까지 위임한다는 점을 이해하면 상황에 맞게 골라 쓸 수 있다.
• AI의 오답은 대개 능력 부족이 아니라 컨텍스트 부족에서 온다. 학습 컷오프를 감안해 최신 문서를 직접 제공하는 습관이 결과 품질을 좌우한다.
• 자율성과 안전은 함께 간다. 터미널 명령·웹 접근에 매번 허가를 받는 구조와 되돌리기 가능한 자동 저장이 있어야 에이전트에게 일을 맡길 수 있다.
• MCP는 IDE와 외부 시스템을 잇는 표준 통로 역할을 한다. 데이터베이스 정보를 수작업으로 옮기지 않고도 AI가 실제 스키마를 이해하게 만든다.
• 모델 키 직접 연결로 특정 모델에 종속되지 않는다. 클라우드 상용 모델과 로컬 모델을 필요에 따라 오가며 쓸 수 있다.

자주 묻는 질문

관련 AI 소식