VS Code 에 바른 MCP 등록하기

VS Code 의 채팅(에이전트 모드)에 바른 MCP 서버를 연결하면, 편집 중인 글이나 코드 주석을 모델이 직접 바른으로 분석·교정할 수 있습니다.

준비물

바른 API 키 — 발급과 사용량은 클라우드에서 사용하기를 참고하세요.
엔드포인트 주소 — 바른 클라우드는 https://api.bareun.ai:443/mcp 입니다. 맞춤법 검사기를 직접 설치한 경우에는 그 서버 주소의 /mcp(예: http://localhost:5656/mcp)를 씁니다. MCP 는 맞춤법 검사기가 포함된 바른에서만 제공되며, 형태소 분석 전용 설치본에는 /mcp 가 없습니다.

등록 방법

VS Code 는 원격 MCP 서버의 OAuth 로그인을 기본으로 지원합니다. 설정 파일은 작업 영역의 .vscode/mcp.json(또는 사용자 프로필)에 둡니다. 명령 팔레트의 MCP: Add Server 로도 추가할 수 있습니다.

주소만 등록하면 됩니다. 키는 적지 않습니다.

{
  "servers": {
    "bareun": {
      "type": "http",
      "url": "https://api.bareun.ai:443/mcp"
    }
  }
}

서버를 시작(Start) 하면 VS Code 가 처음 연결할 때 브라우저 로그인 창을 엽니다. 거기에 바른 API 키를 입력하면 연결됩니다. 한 번 로그인하면 VS Code 가 인증 정보를 안전하게 보관하므로 다음부터는 다시 입력하지 않아도 됩니다.

이 방식이 권장됩니다

API 키가 설정 파일(mcp.json)에 남지 않고, VS Code 의 보안 저장소에 보관됩니다. 로그인한 서버는 계정 메뉴 → 신뢰하는 MCP 서버 관리(Manage Trusted MCP Servers) 에서 관리할 수 있습니다.

로그인 창 없이 키를 헤더로 바로 넘기려면 headers 를 씁니다.

{
  "servers": {
    "bareun": {
      "type": "http",
      "url": "https://api.bareun.ai:443/mcp",
      "headers": { "api-key": "발급받은_API_키" }
    }
  }
}

키를 평문으로 적지 않으려면 입력 변수를 쓸 수 있습니다.

{
  "inputs": [
    { "id": "bareun-key", "type": "promptString", "description": "바른 API 키", "password": true }
  ],
  "servers": {
    "bareun": {
      "type": "http",
      "url": "https://api.bareun.ai:443/mcp",
      "headers": { "api-key": "${input:bareun-key}" }
    }
  }
}

연결 확인

채팅을 에이전트 모드로 두고, 도구 선택 화면에서 bareun 과 도구 (analyze_syntax·tokenize·list_pos_tags·correct_grammar)가 보이면 연결된 것입니다.
mcp.json 의 서버 항목 위 Start/Restart 로 상태를 확인할 수 있습니다.
"이 문장을 바른으로 교정해 줘" 처럼 요청하면 모델이 바른을 호출합니다.

문제가 생기면

로그인 창이 안 뜨거나 반복해서 뜨나요? 서버를 Restart 해 보고, 주소 끝에 /mcp 가 붙었는지 확인하세요.
도구가 안 보이나요? 채팅이 에이전트 모드인지, 서버가 Start 됐는지 확인하세요.
권한 오류(401)? 헤더 방식이면 키가 올바른지, OAuth 방식이면 다시 로그인했는지 확인하세요. 신뢰 관리 메뉴에서 서버 인증을 한 번 해제한 뒤 다시 로그인하면 깨끗하게 재연결됩니다.

자주 묻는 질문

브라우저 로그인 창에 바른 API 키를 입력합니다. 바른은 API 키로 사용자를 식별하므로, 로그인 창에서 입력하는 값이 곧 API 키입니다.

Q. 키를 `mcp.json` 에 적지 않고 쓸 수 있나요?

네. OAuth 로그인 방식을 쓰면 키가 설정 파일에 남지 않고 VS Code 보안 저장소에 보관됩니다. 헤더 방식을 쓰더라도 입력 변수(${input:...})로 키를 분리할 수 있습니다.