Claude Desktop 에 바른 MCP 등록하기
Claude Desktop 앱에 바른 MCP 서버를 연결하면, 대화 중에 Claude 가 직접 바른을 호출해 한국어 형태소 분석과 맞춤법 검사를 수행합니다.
준비물
- 바른 API 키 — 발급과 사용량은 클라우드에서 사용하기를 참고하세요.
- 엔드포인트 주소 — 바른 클라우드는
https://api.bareun.ai:443/mcp입니다. 맞춤법 검사기를 직접 설치한 경우에는 그 서버 주소의/mcp(예:http://localhost:5656/mcp)를 씁니다. MCP 는 맞춤법 검사기가 포함된 바른에서만 제공되며, 형태소 분석 전용 설치본에는/mcp가 없습니다. - 헤더 인증을 쓰는 경우 Node.js —
mcp-remote브리지 실행에 필요합니다.
등록 방법
설정 → 개발자 → 설정 파일 편집(claude_desktop_config.json)에 아래를 추가합니다.
Claude Desktop 은 헤더 인증이 필요한 원격 HTTP 서버를 mcp-remote 브리지로 연결합니다.
{
"mcpServers": {
"bareun": {
"command": "npx",
"args": [
"-y", "mcp-remote",
"https://api.bareun.ai:443/mcp",
"--header", "api-key: 발급받은_API_키"
]
}
}
}
저장 후 Claude Desktop 을 다시 시작하세요.
일부 플랜에서는 설정 → 커넥터(Connectors) → 사용자 지정 커넥터 추가에서 URL 로 직접
추가할 수 있습니다. 엔드포인트(https://api.bareun.ai:443/mcp)를 입력하면, 처음 연결할 때
브라우저가 열립니다. 거기에 바른 API 키를 입력해 로그인하면 됩니다. 한 번 로그인하면
인증 정보가 보관됩니다.
Note
커넥터로 --header 없이 mcp-remote 만 등록("args": ["-y","mcp-remote","https://api.bareun.ai:443/mcp"])해도,
브리지가 자동으로 OAuth 로그인 창을 띄워 줍니다.
연결 확인
- 대화 입력창의 도구 아이콘(🔌) 또는 설정 → 커넥터 에서
bareun과 도구 (analyze_syntax·tokenize·list_pos_tags·correct_grammar)가 보이면 연결된 것입니다. - "이 문장을 바른으로 교정해 줘" 처럼 요청하면 Claude 가 바른을 호출합니다.
문제가 생기면
- 서버가 회색이거나 안 보이나요?
claude_desktop_config.json의 JSON 문법(쉼표·따옴표)을 확인하고, 앱을 완전히 종료한 뒤 다시 여세요. npx/mcp-remote오류가 나나요? Node.js 가 설치돼 있는지 확인하세요(node -v).- 권한 오류(401)?
api-key:뒤에 실제 키가 들어갔는지, 키가 유효한지 확인하세요.
자주 묻는 질문
Q. 왜 Claude Desktop 은 mcp-remote 를 거치나요?
Claude Desktop 의 설정 파일은 기본적으로 로컬 실행형(stdio) 서버를 등록하는 형식이라,
원격 HTTP 서버에 헤더를 붙여 연결하려면 mcp-remote 브리지를 사용합니다. 커넥터 UI 를 쓰면
브리지 없이 URL 로 직접 추가할 수도 있습니다.
Q. API 키를 설정 파일에 적기 싫습니다.
커넥터(OAuth 로그인) 방식을 쓰거나, mcp-remote 를 --header 없이 등록하세요. 브라우저
로그인 창에서 API 키를 한 번 입력하면 됩니다.