Cursor

Cursor 에 바른 MCP 등록하기

Cursor 에 바른 MCP 서버를 연결하면, 에이전트가 코드·문서를 다룰 때 직접 바른을 호출해 한국어 형태소 분석과 맞춤법 검사를 수행합니다.

준비물

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

등록 방법

프로젝트의 .cursor/mcp.json(또는 전역 ~/.cursor/mcp.json)에 추가합니다.

API 키 헤더 (권장·간단)OAuth 로그인 (Sign in)

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

헤더 없이 주소만 등록합니다.

{
  "mcpServers": {
    "bareun": {
      "url": "https://api.bareun.ai:443/mcp"
    }
  }
}

Settings → MCP 화면에서 bareun 서버 옆의 로그인(Login/Sign in) 을 누르면 브라우저가 열립니다. 바른 API 키를 입력하면 연결됩니다. 한 번 로그인하면 인증 정보가 보관됩니다.

연결 확인

• Settings → MCP 화면에 bareun 서버와 도구 (analyze_syntax·tokenize·list_pos_tags·correct_grammar)가 보이고 표시등이 초록색이면 연결된 것입니다.
• 에이전트(Composer)에서 "이 문장을 바른으로 교정해 줘" 처럼 요청하면 바른을 호출합니다.

문제가 생기면

• 표시등이 빨간색인가요? .cursor/mcp.json 의 JSON 문법을 확인하고, Settings → MCP 에서 서버를 새로고침(refresh)하세요.
• 도구가 안 보이나요? 주소 끝에 /mcp 가 붙었는지 확인하세요.
• 권한 오류(401)? 헤더 방식이면 키가 올바른지, OAuth 방식이면 다시 로그인했는지 확인하세요.

자주 묻는 질문

Q. 헤더 방식과 OAuth 로그인 중 무엇을 써야 하나요?

둘 다 같은 바른 API 키로 인증합니다. 빠르게 붙이려면 헤더 방식이 간단하고, 키를 설정 파일에 남기고 싶지 않다면 OAuth 로그인이 편리합니다.

Q. 전역과 프로젝트 설정 중 어디에 넣어야 하나요?

여러 프로젝트에서 쓰려면 전역 ~/.cursor/mcp.json, 특정 프로젝트에서만 쓰려면 그 프로젝트의 .cursor/mcp.json 에 넣습니다.

도움이 되었나요?

의견 보내기