VS Code Continue 플러그인과 MCP 연동 기본 가이드

VS Code에서 Continue 같은 AI 코딩 어시스턴트를 쓰다 보면 모델이 현재 파일은 잘 보지만 프로젝트 밖의 정보에는 약한 경우가 있다. 로컬 문서, 데이터베이스 스키마, 내부 API 설명, 운영 로그처럼 실제 개발 판단에 필요한 자료가 에디터 바깥에 흩어져 있기 때문이다. 이때 MCP는 AI 도구와 외부 리소스를 연결하는 공통 접점으로 활용할 수 있다.

다만 MCP를 붙인다고 해서 맥락 이해도가 자동으로 좋아지는 것은 아니다. 어떤 리소스를 연결할지, 읽기 전용으로 둘지, 권한을 어떻게 제한할지, 실패했을 때 어떻게 진단할지까지 함께 설계해야 한다. 특히 로컬 파일시스템과 데이터베이스를 연결할 때는 편의성보다 접근 범위를 먼저 생각해야 한다.

Continue와 MCP가 맡는 역할

두 도구의 역할 구분

Continue는 개발자가 VS Code 안에서 AI 모델과 대화하고 코드 맥락을 활용할 수 있게 해주는 도구다. MCP는 모델이나 클라이언트가 외부 도구와 데이터를 호출할 수 있도록 연결 방식을 표준화하는 쪽에 가깝다. 두 가지를 함께 쓰면 에디터 안에서 파일뿐 아니라 문서 검색, 데이터베이스 조회, 내부 도구 호출 같은 흐름을 만들 수 있다. 중요한 것은 Continue가 모든 데이터를 직접 알고 있는 것이 아니라, MCP 서버가 필요한 리소스를 도구 형태로 노출한다는 점이다. 따라서 MCP 서버 설계가 느슨하면 AI가 너무 많은 정보를 보거나, 반대로 필요한 정보를 못 찾는 문제가 생긴다.

로컬 파일시스템 연결

로컬 파일시스템을 MCP로 연결하면 설계 문서, 설정 파일, 테스트 로그 등을 모델이 필요할 때 조회할 수 있다. 하지만 프로젝트 전체 디스크를 열어두기보다 작업 폴더와 문서 폴더처럼 제한된 경로만 허용하는 편이 안전하다. 의존성 폴더, 빌드 산출물, 민감한 환경 파일은 제외해야 한다. 파일 도구는 처음에는 읽기 전용으로 시작하는 것이 좋다. 쓰기 기능은 사용자 확인이나 별도 도구로 분리해야 한다. 조회와 수정이 같은 도구 안에 섞이면 모델이 의도보다 넓은 행동을 할 수 있다.

데이터베이스 연결

관계형 데이터베이스나 문서형 데이터베이스를 MCP로 연결하면 스키마 확인, 샘플 데이터 조회, 쿼리 작성 보조가 가능하다. 그러나 운영 데이터베이스를 직접 연결하는 것은 신중해야 한다. 가능하면 읽기 전용 계정, 개발용 복제본, 제한된 뷰를 사용한다. 민감 정보가 포함된 컬럼은 마스킹하거나 처음부터 노출하지 않는 편이 좋다.

실전에서 연동을 시작하는 방법

작은 리소스부터 연결하기

처음부터 파일시스템과 여러 데이터베이스를 모두 연결하지 말고, 프로젝트 문서 폴더 하나부터 시작한다. MCP 도구 호출이 실제로 어떤 결과를 반환하는지 확인한 뒤 범위를 넓히면 문제를 찾기 쉽다. 연결이 많아질수록 모델이 선택할 도구도 늘어나므로 설명 품질이 중요해진다.

도구 설명을 구체적으로 작성하기

MCP 도구 이름과 설명에는 언제 사용해야 하는지, 어떤 입력을 받는지, 반환 결과가 무엇인지 짧게 적는다. 예를 들어 문서 검색용 도구는 프로젝트 문서 검색용이고 소스 코드 검색에는 쓰지 않는다고 설명할 수 있다. 이런 설명은 모델이 불필요한 도구 호출을 줄이는 데 도움이 된다.

읽기 전용 계정을 사용하기

데이터베이스 연결은 가능하면 읽기 전용 계정으로 시작한다. AI 어시스턴트가 쿼리를 제안하는 것과 실제 데이터를 변경하는 것은 위험도가 다르다. 쓰기 작업이 필요하다면 별도 승인 흐름이나 사람이 검토하는 단계로 분리하는 편이 안전하다.

트러블슈팅은 세 단계로 나누기

연동이 안 될 때는 클라이언트 설정, MCP 서버 실행 상태, 대상 리소스 권한을 나눠서 확인한다. Continue가 MCP 서버를 찾지 못하는 문제와 MCP 서버가 데이터베이스에 접속하지 못하는 문제는 원인이 다르다. 로그를 한곳에서만 보지 말고 각 계층의 오류 메시지를 따로 확인해야 원인을 빠르게 좁힐 수 있다.

주의할 점

MCP 연결 방식은 도구 버전과 플러그인 설정 방식에 따라 달라질 수 있다. 따라서 인터넷에서 찾은 설정을 그대로 붙여 넣기보다 현재 사용하는 Continue 버전과 MCP 서버 실행 방식을 먼저 확인해야 한다. 경로, 명령어, 환경 변수 이름이 조금만 달라도 연결이 실패할 수 있다.

또 하나의 주의점은 민감 정보 노출이다. 데이터베이스 연결 문자열, API 키, 환경 변수 파일이 도구 결과에 섞이면 모델 대화나 로그에 남을 수 있다. 파일 검색 도구와 데이터베이스 도구 모두에서 제외 규칙과 마스킹 규칙을 먼저 준비하는 것이 좋다.

정리

Continue와 MCP를 함께 쓰면 VS Code 안의 AI 어시스턴트가 로컬 문서와 데이터베이스 맥락을 더 잘 활용할 수 있다. 하지만 좋은 연동은 많은 리소스를 연결하는 것이 아니라 필요한 리소스를 안전하게 연결하는 데서 시작된다. 읽기 전용, 제한된 범위, 명확한 도구 설명, 계층별 트러블슈팅 흐름을 갖추면 실무에서도 유지하기 쉬운 구조를 만들 수 있다.