본문 바로가기
M MCP모아
튜토리얼

Continue MCP 설정 가이드 — VS Code에서 Continue와 MCP 서버 연동법

Continue.dev VS Code 확장에서 MCP 서버를 연결하는 방법을 단계별로 설명합니다. Continue MCP 설정 파일 작성부터 서버 연동 확인까지 완전히 해결합니다.

VS Code에서 Continue 확장과 MCP 서버를 연동하는 설정 화면을 보여주는 표지 이미지

Continue.dev VS Code 확장에서 MCP 서버를 연결하려면 ~/.continue/config.yaml 파일의 mcpServers 블록에 서버 정보를 추가하면 됩니다. Claude Desktop의 JSON 설정 방식과는 형식이 다르므로 주의가 필요하며, 파일 저장 후 VS Code를 재시작하면 대부분의 문제가 해결됩니다. 이 가이드는 Continue MCP 설정 전 과정을 단계별로 설명하고, 흔한 오류 해결법과 실전 예시 설정까지 모두 다룹니다.

Continue와 MCP, 왜 연결해야 할까요?

Continue는 VS Code와 JetBrains 계열 IDE에서 동작하는 오픈소스 AI 코딩 어시스턴트입니다. 기본적으로 여러 LLM(Claude, GPT 등)을 지원하지만, MCP(Model Context Protocol) 서버를 연결하면 기능이 크게 확장됩니다.

예를 들어 아래와 같은 작업이 가능해집니다.

연결하는 MCP 서버추가되는 능력
코르독(KorDoc)HWP·PDF·DOCX 문서를 AI가 직접 읽고 코드에 반영
HWP-MCP한글 문서를 편집·생성하는 작업 자동화
한포지(HwpForge)HWPX 형식 한글 문서를 AI 에이전트가 읽고 씀
커스텀 사내 MCP 서버사내 API, 문서 저장소, 이슈 트래커 등 연동

기존에 Claude Desktop에서 MCP를 써봤다면 방식이 비슷하지만, 설정 파일 형식과 위치가 완전히 다릅니다. 이 차이를 정확히 이해하는 것이 출발점입니다.

준비물

  • VS Code (최신 버전 권장)
  • Continue 확장 설치 완료
  • Node.js 18 이상 (npx 기반 MCP 서버 사용 시)
  • 연결하려는 MCP 서버의 패키지명 또는 실행 경로

데이터 흐름 구조

Continue가 MCP 서버와 통신하는 구조는 아래와 같습니다.

VS Code (Continue 확장)
    │
    ▼
~/.continue/config.yaml  ←── 설정 파일 (여기에 서버 등록)
    │
    ▼
MCP 서버 프로세스 (npx / uvx / 바이너리)
    │
    ▼
외부 도구 / 파일 시스템 / API

Continue는 설정 파일을 읽어 각 MCP 서버를 하위 프로세스로 실행하고, 채팅 요청 시 필요한 도구를 서버에 위임합니다.

단계별 Continue MCP 설정 방법

1단계: Continue 확장 설치

VS Code 좌측 확장 패널(단축키: Ctrl+Shift+X / Cmd+Shift+X)에서 “Continue” 를 검색한 뒤 설치합니다. 설치 후 좌측 사이드바에 Continue 아이콘이 생깁니다.

2단계: config.yaml 파일 열기

Continue 설정 파일은 홈 디렉토리의 .continue 폴더 안에 있습니다.

  • macOS / Linux: ~/.continue/config.yaml
  • Windows: C:\Users\사용자명\.continue\config.yaml

VS Code에서 바로 여는 방법도 있습니다. Continue 패널 우측 상단의 **설정 아이콘(톱니바퀴)**을 클릭하면 config.yaml이 편집기에서 열립니다.

3단계: mcpServers 블록 추가

config.yaml에 mcpServers 키를 추가하고, 연결할 서버 정보를 입력합니다. 아래는 기본 구조입니다.

mcpServers:
  - name: 서버이름
    command: npx
    args:
      - -y
      - 패키지명

npx 기반 서버 실제 예시 (코르독)

코르독(KorDoc)은 HWP·PDF·DOCX 등 한국 공문서를 Markdown으로 변환해주는 MCP 서버입니다. 설치 명령은 npx -y kordoc setup이며, config.yaml에는 아래와 같이 등록합니다.

mcpServers:
  - name: kordoc
    command: npx
    args:
      - -y
      - kordoc
      - setup

HWP-MCP 추가 예시

HWP-MCP는 AI가 한글(.hwp/.hwpx) 문서를 읽고 편집·생성할 수 있게 해주는 서버입니다. 설치 명령은 npx -y hwp-mcp입니다.

mcpServers:
  - name: kordoc
    command: npx
    args:
      - -y
      - kordoc
      - setup
  - name: hwp-mcp
    command: npx
    args:
      - -y
      - hwp-mcp

한포지(HwpForge) 추가 예시

한포지(HwpForge)는 HWPX 형식 한글 문서를 AI 에이전트가 읽고 쓸 수 있게 해주는 서버입니다. 설치 명령은 npx -y @hwpforge/mcp입니다.

mcpServers:
  - name: kordoc
    command: npx
    args:
      - -y
      - kordoc
      - setup
  - name: hwp-mcp
    command: npx
    args:
      - -y
      - hwp-mcp
  - name: hwpforge
    command: npx
    args:
      - -y
      - "@hwpforge/mcp"

4단계: 파일 저장 후 재로드

config.yaml을 저장하면 Continue가 변경을 자동으로 감지합니다. 만약 MCP 서버가 바로 인식되지 않는다면 VS Code 창을 완전히 닫고 다시 열어주세요.

5단계: MCP 서버 동작 확인

Continue 채팅 패널을 열고, 입력창 왼쪽의 도구(Tool) 아이콘 또는 @ 멘션을 입력해 보세요. 등록한 MCP 서버의 도구 이름이 목록에 표시된다면 연동 성공입니다.

연결 상태를 확인하는 또 다른 방법은 VS Code 출력 패널에서 Continue 채널을 선택하는 것입니다. MCP 서버 시작 로그와 오류 메시지가 여기에 출력됩니다.

Claude Desktop과 Continue의 MCP 설정 비교

두 클라이언트를 함께 쓴다면 설정 파일을 혼동하지 않는 것이 중요합니다.

항목Claude DesktopContinue
설정 파일 형식JSONYAML
설정 파일 위치 (macOS)~/Library/Application Support/Claude/claude_desktop_config.json~/.continue/config.yaml
서버 등록 키mcpServersmcpServers
서버 항목 형식"서버명": { "command": "...", "args": [...] }- name: ...\n command: ...\n args: [...]
환경 변수 주입"env": { "KEY": "value" }env: { KEY: value }

두 도구 모두 동일한 MCP 서버를 각자 설정 파일에 등록하면 독립적으로 사용할 수 있습니다.

흔한 오류와 해결 방법

”MCP server failed to start” 오류

가장 흔한 원인은 세 가지입니다.

  1. Node.js가 설치되지 않았거나 PATH에 없음 — 터미널에서 node -v와 npx -v를 실행해 버전이 출력되는지 확인합니다. 출력되지 않는다면 Node.js를 설치하세요.
  2. YAML 들여쓰기 오류 — YAML은 탭 문자를 허용하지 않습니다. 반드시 스페이스(2칸 또는 4칸)를 일관되게 사용하세요.
  3. 패키지명에 @ 기호 처리 — @hwpforge/mcp 처럼 @로 시작하는 패키지는 YAML args 배열에서 따옴표로 감싸야 합니다.

MCP 도구가 채팅에서 보이지 않음

Continue가 MCP 기능을 활성화하려면 설정에서 experimental.modelContextProtocolServers 관련 옵션이 활성화돼 있어야 합니다. 버전에 따라 별도 활성화가 필요할 수 있으니 Continue 공식 문서를 확인하세요.

API 키가 필요한 서버 설정

환경 변수를 주입하려면 아래처럼 env 블록을 추가합니다.

mcpServers:
  - name: my-api-server
    command: npx
    args:
      - -y
      - my-mcp-package
    env:
      MY_API_KEY: "your-api-key-here"

자주 묻는 질문

Continue와 Claude Desktop의 MCP 설정 방식이 다른가요?

네, 다릅니다. Claude Desktop은 JSON 형식의 claude_desktop_config.json에 설정하고, Continue는 YAML 형식의 ~/.continue/config.yaml에 mcpServers 블록으로 설정합니다. 형식과 위치가 모두 다르므로 각각 별도로 구성해야 합니다.

config.yaml을 수정했는데 MCP 서버가 뜨지 않습니다. 왜 그런가요?

파일 저장 후 Continue가 자동 재로드되지 않는 경우 VS Code 창 전체를 재시작해 보세요. 또한 YAML 들여쓰기 오류가 자주 원인이 되므로, 탭 대신 스페이스 2칸을 사용하고 있는지 확인하세요.

npx 기반 MCP 서버는 Continue에서 어떻게 등록하나요?

command를 npx로, args 배열에 -y와 패키지명을 순서대로 넣으면 됩니다. 코르독 서버라면 command: npx, args: ['-y', 'kordoc', 'setup']처럼 작성합니다.

Continue MCP 서버에서 API 키가 필요한 경우 어떻게 처리하나요?

config.yaml의 해당 서버 항목 아래 env 블록을 추가해 환경 변수로 주입합니다. 키를 파일에 직접 쓰는 것이 불편하다면 시스템 환경 변수로 미리 설정하고 env 블록에서 참조할 수 있습니다.

Continue는 어떤 MCP 서버 유형을 지원하나요?

Continue는 stdio(표준 입출력) 방식의 MCP 서버를 기본으로 지원합니다. npx, uvx, 직접 실행 가능한 바이너리 모두 사용할 수 있으며, SSE(Server-Sent Events) 방식의 원격 서버도 url 키로 지원합니다.

여러 MCP 서버를 동시에 연결할 수 있나요?

네, mcpServers 블록 아래 서버 항목을 여러 개 나열하면 됩니다. 각 서버는 고유한 name으로 구분되며, Continue가 기동될 때 모두 함께 시작됩니다.

다음 단계

Continue MCP 설정을 완료했다면, 이제 다양한 MCP 서버를 추가해 AI 코딩 어시스턴트의 능력을 확장할 수 있습니다.

이 글과 관련된 MCP 서버