콘텐츠로 이동

Claude (웹·공개 커넥터)

Claude(웹)에 바른 커넥터 등록하기

Claude 웹앱(및 Claude Desktop)의 사용자 지정 커넥터(custom connector) 로 바른 MCP 서버를 등록하면, 대화 중에 Claude 가 직접 바른을 호출해 한국어 형태소 분석과 맞춤법 검사를 수행합니다. 팀·조직에서 함께 쓰도록 커넥터를 공개(게시) 할 수도 있습니다.

준비물

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

사용자 지정 커넥터는 플랜에 따라 제공됩니다

원격 MCP 서버를 직접 추가하는 사용자 지정 커넥터와 조직 공개(게시) 기능은 Claude 의 플랜(개인·Team·Enterprise 등)에 따라 메뉴 위치와 사용 가능 여부가 다릅니다. 메뉴가 보이지 않으면 사용 중인 플랜에서 해당 기능을 지원하는지 확인하세요.

등록 방법

웹 브라우저에서 진행합니다. 키는 적지 않고, 추가 후 로그인 창에서 한 번 입력합니다.

  1. Claude 웹앱에서 설정(Settings) → 커넥터(Connectors) 로 이동합니다.
  2. 사용자 지정 커넥터 추가(Add custom connector) 를 선택합니다.
  3. 아래 값을 입력하고 추가합니다.
    • 이름: 바른(원하는 이름)
    • 원격 MCP 서버 URL: https://api.bareun.ai:443/mcp
  4. 추가한 커넥터에서 연결(Connect) 을 누르면 로그인 창이 열립니다. 거기에 바른 API 키를 입력해 로그인합니다.
  5. 로그인에 성공하면 바른의 도구 (analyze_syntax·tokenize·list_pos_tags·correct_grammar)가 등록됩니다.

로그인 창에 입력하는 값 = 바른 API 키

바른은 API 키로 사용자를 식별합니다. 그래서 커넥터 로그인 창에서 입력하는 값이 곧 바른 API 키입니다. 한 번 로그인하면 인증 정보가 보관되어 다음부터는 다시 입력하지 않아도 됩니다.

조직에 공개(게시)하기

Team·Enterprise 플랜에서는 추가한 바른 커넥터를 조직 구성원에게 공개해, 구성원이 각자 같은 커넥터를 손쉽게 켜서 쓸 수 있습니다.

  • 조직 관리자(또는 커넥터를 만든 사람)가 설정 → 커넥터에서 바른 커넥터를 조직에 공개(게시) 합니다. 게시 후에는 구성원이 자신의 커넥터 목록에서 바른을 켜고, 각자 자신의 바른 API 키로 로그인합니다.
  • 사용량은 로그인에 쓰인 API 키 단위로 집계되므로, 구성원마다 자신의 키로 로그인하는 것을 권장합니다.

공개 전 확인하세요

공개(게시)는 조직 구성원이 이 커넥터를 볼 수 있게 합니다. API 키 자체는 게시되지 않으며, 각 구성원이 연결할 때 자신의 키로 로그인합니다. 키를 여러 사람과 공유하지 말고 구성원별로 발급해 사용하세요.

연결 확인

  • 대화 입력창의 도구/커넥터 메뉴 또는 설정 → 커넥터에서 바른 과 도구 네 가지가 보이면 연결된 것입니다.
  • "이 문장을 바른으로 교정해 줘" 처럼 요청하면 Claude 가 바른을 호출합니다.

문제가 생기면

  • 로그인 창에 무엇을 넣어야 하나요? 바른 API 키를 입력하면 됩니다(발급 방법).
  • 권한 오류(401)가 나나요? 입력한 키가 올바른지, 유효한지 확인하세요. 커넥터의 연결을 한 번 해제한 뒤 다시 로그인하면 깨끗하게 재연결됩니다.
  • 연결이 안 되거나 도구가 안 보이나요? 주소 끝에 /mcp 가 붙었는지 확인하고, 잠시 후 다시 연결해 보세요. 설치형 서버라면 외부에서 접근 가능한 https 주소인지 확인하세요(브라우저 기반 커넥터는 평문 http·사설 주소로는 연결하지 못할 수 있습니다).

자주 묻는 질문

Q. 커넥터 로그인 창에 무엇을 입력하나요?

바른 API 키를 입력합니다. 바른은 API 키로 사용자를 식별하므로, 로그인 창에서 입력하는 값이 곧 API 키입니다. 한 번 로그인하면 인증 정보가 보관됩니다.

Q. 조직 전체가 함께 쓰도록 공개할 수 있나요?

Team·Enterprise 플랜에서는 바른 커넥터를 조직에 공개(게시)할 수 있습니다. 게시해도 API 키는 공유되지 않으며, 구성원이 각자 자신의 바른 API 키로 로그인합니다. 사용량은 키 단위로 집계되므로 구성원별로 키를 발급해 쓰는 것을 권장합니다.

Q. 제미나이·챗GPT 웹 채팅창에도 같은 방법으로 추가할 수 있나요?

아니요. 그 서비스들의 웹 채팅창은 임의의 MCP 서버 주소를 입력하는 설정을 열어 두지 않았습니다. 이런 환경에서는 코드로 직접 연동하거나, 사용자 지정 커넥터를 지원하는 도구(Claude·Cursor·VS Code 등)를 사용하세요.

Q. Claude Desktop 앱에서도 되나요?

네. Claude Desktop 의 커넥터 메뉴에서도 같은 방식으로 추가할 수 있습니다. 설정 파일(mcp-remote) 방식까지 포함한 자세한 안내는 Claude Desktop 문서를 참고하세요.

도움이 되었나요?