Weegloo Docs - Claude Code 설정

Claude Code는 터미널에서 동작하는 코딩 에이전트입니다. 여기에 WEEGLOO MCP 서버를 연결하면, Claude Code가 Content Type·Content·Media 같은 리소스를 직접 만들고 읽고 수정할 수 있습니다. 연결 방식은 다른 환경과 같습니다. 설치 도구로 한 번에 설정한 다음, Claude Code에서 인증만 마치면 됩니다.

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

준비물

Node.js 18 이상: 설치 도구와 파일 전송용 서버(weegloo-upload)를 실행하는 데 필요합니다.
Personal Access Token: 인증에 씁니다. 발급 방법은 Personal Access Token 발급하기에서 다룹니다.
Claude Code: 터미널에 claude 명령으로 실행되는 상태.

설치 도구로 연결하기

연결할 프로젝트 폴더로 이동한 다음, 그 폴더에서 설치 도구를 실행합니다. MCP 설정은 폴더 단위로 저장되므로, 실행하는 위치가 곧 설정이 적용될 프로젝트입니다.

npx weegloo@latest

실행하면 차례로 묻습니다. 각 항목에서 다음과 같이 고릅니다.

Select plugin version (branch): Skills와 Rules의 버전입니다. latest를 고릅니다.
Select your IDE: Claude Code를 고릅니다.
What would you like to install?: MCP 서버와 Skills / Rules를 나눠 설치할 수 있습니다. 처음 설치한다면 모두 설치합니다.
Enter your Weegloo Personal Access Token: 미리 발급한 Personal Access Token을 붙여 넣습니다.
Select the MCP server group: 보통은 default를 고릅니다. 서버 그룹별 차이는 MCP 서버 그룹에서 다룹니다.
Where would you like to install ... configuration: 현재 프로젝트에만 적용하려면 Project를 고릅니다. Claude Code 버전에 따라 Project 설치가 지원되지 않으면 Global로 설치합니다.

설치가 끝나면 프로젝트 폴더에 .mcp.json과 .claude/ 디렉터리가 생기고, weegloo와 weegloo-upload 두 MCP 서버가 등록됩니다.

√ Select plugin version (branch): latest  (recommended)
√ Select your IDE: Claude Code
√ What would you like to install? Install MCP server, Install Skills and Rules
√ Enter your Weegloo Personal Access Token: ********
√ Select the MCP server group: default
√ Where would you like to install Claude Code configuration? Project
 
√   MCP servers configured   → ./.mcp.json
√   Skills installed         → ./.claude/skills
√   Rules installed          → ./.claude/rules
 
  ✔  Installation complete!

설정 파일 직접 확인하기

설치 도구가 만든 .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 서버 그룹을 참고하세요.

Claude Code에서 서버 켜기

설정 파일이 있는 프로젝트 폴더에서 Claude Code를 실행합니다.

claude

처음 실행하면 .mcp.json에 새로 추가된 서버를 켤지 묻습니다. 두 서버를 선택하고 Enter를 눌러 켭니다.

  2 new MCP servers found in .mcp.json
  Select any you wish to enable.
 
  > [√] weegloo
    [√] weegloo-upload

weegloo-upload 서버는 설정 파일에 넣은 Personal Access Token으로 바로 인증되어 connected 상태가 됩니다. weegloo 서버는 HTTP 연결이라 별도 인증이 필요해 needs authentication 상태로 표시됩니다.

weegloo 서버 인증하기

weegloo 서버를 인증하려면 MCP 서버 관리 화면으로 들어갑니다. 등록된 서버 목록에서 weegloo를 고릅니다.

  Manage MCP servers
 
  > weegloo · ∆ needs authentication
    weegloo-upload · √ connected · 1 tool

weegloo를 고르면 상태 화면이 나옵니다. 연결 주소가 https://ai.weegloo.com/mcp로 맞는지 확인하고 Authenticate를 고릅니다.

   Weegloo MCP Server
 
  Status:  ∆ needs authentication
  URL:     https://ai.weegloo.com/mcp
 
  > 1. Authenticate
    2. Disable

Authenticate를 고르면 브라우저에 로그인 페이지가 열립니다. 브라우저가 자동으로 열리지 않으면, Claude Code에 표시된 주소를 브라우저 주소창에 직접 입력합니다. 미리 발급한 Personal Access Token을 입력하면 인증이 끝납니다.

인증을 마치면 weegloo 서버 상태가 connected로 바뀝니다. 이제 Claude Code에서 자연어로 요청하면 WEEGLOO 리소스를 직접 다룰 수 있습니다.

다음으로 할 일

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