Claude Desktop

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 브리지 실행에 필요합니다.

등록 방법

설정 파일 (mcp-remote)커넥터 (OAuth 로그인)

설정 → 개발자 → 설정 파일 편집(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 키를 한 번 입력하면 됩니다.

도움이 되었나요?

의견 보내기