그 밖의 클라이언트

그 밖의 MCP 클라이언트에 바른 등록하기

여기서 따로 다루지 않은 MCP 클라이언트(Windsurf, Gemini CLI, JetBrains AI Assistant 등)도 대부분 같은 방식으로 연결합니다. 공통 원칙은 두 가지뿐입니다.

• 엔드포인트: 바른 클라우드 https://api.bareun.ai:443/mcp, 또는 맞춤법 검사기를 직접 설치한 경우 그 서버 주소의 /mcp(예: http://localhost:5656/mcp). MCP 는 맞춤법 검사기가 포함된 바른에서만 제공되며(형태소 분석 전용 설치본엔 없음), 주소 끝에 반드시 /mcp 가 붙습니다.
• 인증: api-key 헤더(또는 Authorization: Bearer <키>)에 바른 API 키. OAuth 로그인을 지원하는 클라이언트라면 처음 연결 시 브라우저에서 바른 API 키를 입력해 로그인합니다.

준비물

바른 API 키 — 발급과 사용량은 클라우드에서 사용하기를 참고하세요.

클라이언트가 원격 HTTP 서버를 지원하면

설정에서 HTTP(Streamable HTTP) 서버 종류를 고르고, URL 과 api-key 헤더를 넣습니다. 많은 클라이언트가 아래 JSON 형태(키 이름은 도구마다 mcpServers/servers 등으로 조금 다름)를 씁니다.

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

클라이언트가 실행형(stdio)만 지원하면

원격 HTTP 를 직접 못 붙이는 클라이언트는 mcp-remote 브리지를 실행형으로 등록합니다 (Node.js 필요). 브리지가 HTTP 연결과 인증을 대신 처리합니다.

{
  "mcpServers": {
    "bareun": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.bareun.ai:443/mcp", "--header", "api-key: 발급받은_API_키"]
    }
  }
}

OAuth 로그인으로 붙이기

--header 를 빼고 mcp-remote 만 등록하면, 브리지가 자동으로 브라우저 로그인 창을 띄웁니다. 거기에 바른 API 키를 입력하면 됩니다. 키를 설정 파일에 남기지 않으려는 경우에 유용합니다.

연결 테스트 (개발자용)

등록 전에 엔드포인트를 빠르게 확인하려면 공식 MCP Inspector 를 쓸 수 있습니다(Node.js 필요).

npx @modelcontextprotocol/inspector

화면에서 Transport 를 Streamable HTTP, URL 을 엔드포인트(.../mcp)로 두고, 헤더에 api-key: 발급받은_API_키 를 넣어 연결하면 도구·리소스 목록이 보이고 각 도구를 눌러 호출해 볼 수 있습니다.

문제가 생기면

• 도구가 안 보이나요? 주소 끝에 /mcp 가 붙었는지, 서버 종류를 HTTP(Streamable HTTP) 로 골랐는지 확인하세요.
• 권한 오류(401)? api-key 헤더(또는 Authorization: Bearer <키>)에 실제 키가 들어갔는지 확인하세요.
• 맞춤법 교정 도구가 없나요? MCP 는 맞춤법 검사기가 포함된 바른에서만 제공됩니다.

자주 묻는 질문

Q. 목록에 없는 클라이언트도 바른 MCP 를 쓸 수 있나요?

대부분 가능합니다. 원격 HTTP(Streamable HTTP) 서버를 지원하면 URL 과 api-key 헤더로 바로 등록하고, 실행형(stdio)만 지원하면 mcp-remote 브리지로 연결합니다.

Q. 엔드포인트 주소는 어디서 확인하나요?

바른 클라우드는 https://api.bareun.ai:443/mcp 입니다. 맞춤법 검사기를 직접 설치한 경우에는 그 서버가 열린 주소에 /mcp 를 붙이면 됩니다(예: http://localhost:5656/mcp). MCP 는 맞춤법 검사기가 포함된 바른에서만 제공되며, 형태소 분석 전용 설치본에는 /mcp 가 없습니다.

도움이 되었나요?

의견 보내기