Claude 설정

최종 수정: 2026년 6월 25일

Claude에 WEEGLOO MCP 서버를 연결하면, Claude가 Space·Content Type·Content·Media 같은 리소스를 직접 만들고 읽고 수정할 수 있습니다. MCP가 무엇이고 어떤 준비가 필요한지는 MCP에서 다룹니다. 이 페이지는 Claude에 한정해 연결 방법을 단계로 안내합니다.

Claude는 두 가지 환경에서 연결합니다. 웹 버전(claude.ai)과 데스크톱 앱입니다. 두 환경의 차이는 다음과 같습니다.

  • 웹 버전: HTTP 방식의 weegloo 서버만 연결됩니다. 리소스를 만들고 읽고 수정하는 작업은 모두 가능합니다.
  • 데스크톱 앱: weegloo 서버에 더해, 파일을 다루는 weegloo-upload 서버까지 연결됩니다. Media 업로드나 Web Hosting 배포처럼 파일이 오가는 작업을 하려면 데스크톱 앱이 필요합니다.

두 환경 모두 Claude 유료 요금제(Pro 이상)가 있어야 MCP 서버를 연결할 수 있습니다.

연결에 필요한 Personal Access Token 발급은 Personal Access Token 발급하기에서 다룹니다. 아래 설정에서 <Personal Access Token>이라고 적힌 자리에는 발급받은 값을 그대로 넣습니다.

웹 버전(claude.ai)에 연결하기

웹 버전은 HTTP 방식의 weegloo 서버만 연결합니다. 파일 업로드 서버(weegloo-upload)는 데스크톱 앱에서만 연결되므로, 파일 작업이 필요하면 아래 데스크톱 앱 안내를 따릅니다.

  1. claude.ai에 로그인한 뒤 커넥터 추가 화면을 엽니다.
  2. 서버 정보를 입력합니다. 이름에 weegloo, 서버 주소에 https://ai.weegloo.com/mcp를 넣습니다.
  3. 안내에 따라 로그인(인증)을 마칩니다.
  4. 입력창의 도구 아이콘을 눌러 weegloo 서버의 도구가 보이면 연결된 것입니다.

서버 주소 끝에 ?group= 값을 붙이면 쓸 수 있는 도구 묶음을 바꿀 수 있습니다. 예를 들어 모든 도구를 쓰려면 https://ai.weegloo.com/mcp?group=all을 넣습니다. 그룹별 차이는 MCP의 MCP 서버 그룹 표에서 다룹니다.

데스크톱 앱에 연결하기

데스크톱 앱은 두 서버를 따로 연결합니다. 리소스 작업용 weegloo 서버는 웹 버전과 같은 HTTP 방식으로, 파일 작업용 weegloo-upload 서버는 컴퓨터에서 직접 실행하는 방식으로 연결합니다.

서버연결 방식등록 위치
weeglooHTTP(원격)설정 > 커넥터
weegloo-upload컴퓨터에서 직접 실행설정 파일(claude_desktop_config.json)

weegloo-upload 서버를 실행하려면 Node.js 18 이상이 설치돼 있어야 합니다.

weegloo 서버 연결하기

weegloo 서버는 웹 버전과 같은 방법으로 연결합니다.

  1. 데스크톱 앱의 설정에서 커넥터(Connectors) 화면을 엽니다.
  2. 커넥터 추가 버튼을 누릅니다.
  3. 이름에 weegloo, 서버 주소에 https://ai.weegloo.com/mcp를 넣습니다.
  4. 안내에 따라 로그인(인증)을 마칩니다.

weegloo-upload 서버 연결하기

파일 작업용 weegloo-upload 서버는 설정 파일에 직접 적어 등록합니다.

  1. Claude 데스크톱 앱의 설정 파일을 엽니다. 운영체제별 위치는 다음과 같습니다.

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json

  2. 파일에 다음 내용을 넣습니다. 이미 다른 서버가 등록돼 있다면 mcpServers 안에 weegloo-upload 항목만 추가합니다.

    {
  "mcpServers": {
    "weegloo-upload": {
      "command": "npx",
      "args": ["-y", "weegloo-upload"],
      "env": {
        "UPLOAD_API_URL": "https://upload.weegloo.com/v1",
        "AUTH_BEARER_TOKEN": "<Personal Access Token>"
      }
    }
  }
}

  3. AUTH_BEARER_TOKEN의 값(<Personal Access Token> 자리)에 발급받은 Personal Access Token을 넣습니다.

  4. Claude 데스크톱 앱을 완전히 종료한 뒤 다시 엽니다. macOS는 Cmd+Q, Windows는 작업 표시줄 아이콘에서 종료해 앱을 완전히 닫습니다.

  5. 입력창의 도구 아이콘을 눌러 weegloo와 weegloo-upload 서버의 도구가 모두 보이면 연결된 것입니다.

npx weegloo@latest 설치 도구를 쓰면 위 설정 파일 작성을 자동으로 처리할 수 있습니다. 설치 도구 사용법은 MCP에서 다룹니다.

연결이 안 될 때

  • npx: command not found 오류: Node.js가 설치돼 있지 않거나 실행 경로에 잡히지 않은 상태입니다. Node.js 공식 사이트에서 LTS 버전을 설치합니다.
  • Windows에서 서버가 보이지 않을 때: 설정 파일에서 command를 cmd로, args를 ["/c", "npx", "-y", "weegloo-upload"]로 바꿔 다시 시도합니다.
  • 인증 오류: AUTH_BEARER_TOKEN에 넣은 Personal Access Token이 정확한지, 그리고 만료되지 않았는지 확인합니다.

다음으로 할 일