Claude 설정

최종 수정: 2026년 7월 10일

Claude Desktop에는 코딩 에이전트 Claude Code가 Code 탭으로 들어 있습니다. WEEGLOO MCP 서버는 이 Code 탭을 통해 연결해 사용합니다. 이 연결을 통해 Code 탭의 에이전트가 Content Type·Content·Media 같은 리소스를 직접 만들고 읽고 수정할 수 있습니다. 설치 도구로 한 번에 설정하고, claude의 /mcp로 인증을 마치면 Code 탭에서 바로 쓸 수 있습니다.

MCP 자체와 서버 그룹, 파일 업로드 서버에 대한 설명은 MCP에서 다룹니다. 이 페이지는 Claude Desktop의 Code 탭에 연결하는 단계만 다룹니다.

Claude Desktop의 Code 탭은 Claude Code로 동작합니다. WEEGLOO도 Code 탭을 통해, Claude Code와 동일한 MCP·Skills 설정으로 연결됩니다. 터미널에서 claude 명령을 실행할 수 있도록 Claude Code가 설치되어 있어야 합니다. 아직 없다면 Claude Code 설치 안내를 참고하세요.

사전 준비

아래 설치 명령을 실행하려면 Node.js가 필요합니다. 먼저 다음 명령으로 설치 여부와 버전이 18 이상인지 확인하세요.

터미널
node --version # v18 이상이면 OK npx --version # 버전이 출력되면 OK

Node.js는 설치되어 있지만 npx가 설치되어 있지 않은 경우, 아래 명령으로 npm을 최신 버전으로 업데이트하세요. npm을 업데이트하면 npx도 함께 설치됩니다.

터미널
npm install -g npm@latest

Node.js가 설치되어 있지 않거나 버전이 낮다면, 사용 중인 운영체제에 맞는 방법으로 Node.js를 설치하세요.

터미널
brew install node

Homebrew가 없다면 brew.sh에서 먼저 설치하거나, nodejs.org에서 Node.js를 직접 다운로드하세요.

연결하기

설치 위치를 고르고, 다음 가이드를 따라 진행해 주세요. 프로젝트 하나에만 연결하려면 프로젝트를, 모든 프로젝트에서 쓰려면 전역을 고릅니다.

1

MCP · Skills 설치하기

설치 명령을 복사해 터미널에서 실행하세요.

터미널
$ npx weegloo@latest -y \ --agent claude \ --token wgl_••••••••••••
2

MCP 인증 연결

아래 순서대로 인증하세요.

이 단계는 Claude Code CLI(claude)가 필요합니다. 아직 없다면 Claude Code를 설치해 주세요.
  1. 1.터미널에서 Claude Code를 실행합니다.
    터미널
    claude
  2. 2./mcp를 입력해 MCP 서버 관리 화면을 엽니다.
    터미널
    /mcp
  3. 3.목록에서 weegloo를 고릅니다. needs authentication 상태로 표시됩니다.
    터미널
    Manage MCP servers > weegloo · ∆ needs authentication weegloo-upload · √ connected
  4. 4.연결 주소가 https://ai.weegloo.com/mcp인지 확인하고 Authenticate를 선택합니다.
    터미널
    Weegloo MCP Server Status: ∆ needs authentication URL: https://ai.weegloo.com/mcp > 1. Authenticate 2. Disable
  5. 5.Authenticate를 선택하면 브라우저에 아래와 같은 WEEGLOO 인증 페이지가 열립니다. 토큰 복사 버튼으로 복사한 토큰을 붙여넣고 서버 연결을 누릅니다. weegloo가 connected로 바뀌면 완료입니다.

설정 파일 직접 확인하기

Code 탭은 Claude Code의 MCP·Skills 설정을 그대로 사용합니다. 그래서 연결한 서버는 Claude Desktop의 커넥터·플러그인·MCP 화면에는 나타나지 않고, Code 탭에서만 쓸 수 있습니다. 설치된 서버를 확인하려면 터미널에서 claude를 실행하고 /mcp를 입력하세요. 아래 .mcp.json도 설치 도구가 자동으로 생성하고 관리하므로 직접 열어 볼 일은 거의 없습니다. 아래 설정 내용은 구체적인 설정 파일 구조와 경로가 필요한 사용자를 위한 참고 자료입니다.

weegloo 서버는 HTTP 방식으로 https://ai.weegloo.com/mcp에 연결하고, 파일을 다루는 weegloo-upload 서버는 npx로 실행하며 인증에 Personal Access Token을 씁니다.

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

서버 그룹을 바꾸려면 weegloo 서버의 url 끝에 group 값을 붙입니다. 예를 들어 모든 도구를 쓰려면 https://ai.weegloo.com/mcp?group=all로 적습니다. 그룹별 도구 구성은 MCP 서버 그룹을 참고하세요.

다음으로 할 일

  • MCP: 서버 그룹·파일 업로드 서버 등 연결의 바탕이 되는 내용을 다룹니다.
  • Skills와 Rules: 설치 도구가 함께 설치하는 Skills와 Rules가 무엇인지 다룹니다.
  • AI로 정적 페이지 옮겨오기: 연결한 MCP로 실제 페이지를 콘텐츠 기반 서비스로 옮기는 흐름을 따라갑니다.