Claude Code Setup | Weegloo Docs

Claude Code is a coding agent that runs in your terminal. Once you connect the WEEGLOO MCP server to it, Claude Code can directly create, read, and modify resources such as Content Type, Content, and Media. Along with the MCP server, the install tool also installs Skills and Rules so that Claude Code uses the WEEGLOO API the way it is meant to be used. Skills are guides that capture how to do a specific task well, and Rules are rules to follow across all tasks. You set everything up at once with the install tool, then complete MCP-connection authentication.

For details on the MCP server and on Skills and Rules, see the MCP and Skills and Rules pages respectively. This page covers only how to connect to Claude Code.

Prerequisites

Running the install commands below requires Node.js. First, use the following commands to check whether it is installed and whether the version is 18 or higher.

Terminal

node --version # v18 or higher is OK npx --version # OK if a version is printed

If Node.js is installed but npx is not, update npm to the latest version with the command below. Updating npm installs npx along with it.

Terminal

npm install -g npm@latest

If Node.js is not installed or its version is too old, install Node.js using the method that fits your operating system.

Terminal

brew install node

If you do not have Homebrew, install it first from brew.sh, or download Node.js directly from nodejs.org.

Terminal

winget install OpenJS.NodeJS.LTS

If winget is missing or not recognized, download the LTS installer from nodejs.org. After installing, you need to open a new terminal.

Distribution packages can be outdated, so we recommend installing with nvm, which works across many distributions.

Terminal

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.5/install.sh | bash source ~/.bashrc nvm install --lts

To download the installer directly, check nodejs.org.

Claude Code must also be installed so that you can run it from your terminal with the claude command. If you do not have it yet, see the Claude Code install guide.

Connecting

For a default install, copy the install command on this page and run it once in your terminal. To go through the install steps and choose each one yourself, open Custom install.

Install location

Install MCP and Skills

Copy the install command and run it in your terminal.

Terminal

$ npx weegloo@latest -y \ --agent claude \ --token <Personal Access Token>

Authenticate the MCP connection

Authenticate in the following order.

Run Claude Code in your terminal.

Terminal
claude
Enter /mcp to open the MCP server management screen.

Terminal
/mcp
Select weegloo from the list. It is shown with the needs authentication status.

Terminal
Manage MCP servers > weegloo · ∆ needs authentication weegloo-upload · √ connected
Check that the connection address is https://ai.weegloo.com/mcp and select Authenticate.

Terminal
Weegloo MCP Server Status: ∆ needs authentication URL: https://ai.weegloo.com/mcp > 1. Authenticate 2. Disable
When you select Authenticate, a WEEGLOO authentication page like the one below opens in your browser. Copy your token with the Copy token button, paste it, and click Connect Server. You are done once weegloo changes to connected.

Install MCP and Skills

Copy the install command and run it in your terminal. Be sure to run it inside the project folder you want to connect.

Terminal

$ npx weegloo@latest -y \ --agent claude \ --location project \ --token <Personal Access Token>

Authenticate the MCP connection

Authenticate in the following order.

Run Claude Code in your terminal. Be sure to run it inside the project folder you want to connect.

Terminal
claude
On first run, you may be asked whether to enable new MCP servers. In that case, check that weegloo and weegloo-upload are checked and press Enter to submit.

Terminal
New MCP servers found in .mcp.json Select any you wish to enable. > [√] weegloo [√] weegloo-upload
Enter /mcp to open the MCP server management screen.

Terminal
/mcp
Select weegloo from the list. It is shown with the needs authentication status.

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

If the servers do not appear in the list: If weegloo and weegloo-upload do not appear in the list, you may not have submitted on the activation screen in step 2, or they may be disabled. Quit Claude Code, enter the command below in your terminal, and run claude again. When the same screen as step 2 appears again, make sure weegloo and weegloo-upload are checked and press Enter to submit.
Terminal
claude mcp reset-project-choices
Check that the connection address is https://ai.weegloo.com/mcp and select Authenticate.

Terminal
Weegloo MCP Server Status: ∆ needs authentication URL: https://ai.weegloo.com/mcp > 1. Authenticate 2. Disable
When you select Authenticate, a WEEGLOO authentication page like the one below opens in your browser. Copy your token with the Copy token button, paste it, and click Connect Server. You are done once weegloo changes to connected.

Run npx weegloo interactively and install by choosing the prompted items yourself.

Install location

Run the install tool

Run the command below in your terminal and choose each prompted item in turn. Where it asks for the token, use the Copy token button below to copy the token and paste it.

Terminal

npx weegloo@latest

Terminal

✔ Select your IDE: Claude Code ✔ What would you like to install? MCP server, Skills and Rules ✔ Enter your Weegloo Personal Access Token: **** ← the token you copied ✔ Select the MCP server group: default ✔ Where would you like to install the configuration? Global … ✔ Installation complete!

Authenticate the MCP connection

Authenticate in the following order.

Run Claude Code in your terminal.

Terminal
claude
Enter /mcp to open the MCP server management screen.

Terminal
/mcp
Select weegloo from the list. It is shown with the needs authentication status.

Terminal
Manage MCP servers > weegloo · ∆ needs authentication weegloo-upload · √ connected
Check that the connection address is https://ai.weegloo.com/mcp and select Authenticate.

Terminal
Weegloo MCP Server Status: ∆ needs authentication URL: https://ai.weegloo.com/mcp > 1. Authenticate 2. Disable
When you select Authenticate, a WEEGLOO authentication page like the one below opens in your browser. Copy your token with the Copy token button, paste it, and click Connect Server. You are done once weegloo changes to connected.

Run the install tool

Move to the project folder you want to connect, then run the command below in that folder and choose each prompted item in turn. Where it asks for the token, use the Copy token button below to copy the token and paste it. Be sure to run it inside that project folder.

Terminal

npx weegloo@latest

Terminal

Authenticate the MCP connection

Authenticate in the following order.

Run Claude Code in your terminal. Be sure to run it inside the project folder you want to connect.

Terminal
claude
On first run, you may be asked whether to enable new MCP servers. In that case, check that weegloo and weegloo-upload are checked and press Enter to submit.

Terminal
New MCP servers found in .mcp.json Select any you wish to enable. > [√] weegloo [√] weegloo-upload
Enter /mcp to open the MCP server management screen.

Terminal
/mcp
Select weegloo from the list. It is shown with the needs authentication status.

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

If the servers do not appear in the list: If weegloo and weegloo-upload do not appear in the list, you may not have submitted on the activation screen in step 2, or they may be disabled. Quit Claude Code, enter the command below in your terminal, and run claude again. When the same screen as step 2 appears again, make sure weegloo and weegloo-upload are checked and press Enter to submit.
Terminal
claude mcp reset-project-choices
Check that the connection address is https://ai.weegloo.com/mcp and select Authenticate.

Terminal
Weegloo MCP Server Status: ∆ needs authentication URL: https://ai.weegloo.com/mcp > 1. Authenticate 2. Disable
When you select Authenticate, a WEEGLOO authentication page like the one below opens in your browser. Copy your token with the Copy token button, paste it, and click Connect Server. You are done once weegloo changes to connected.

MCP Server Configuration File

The install tool automatically creates and manages the configuration file, so you do not need to check it yourself. The content below is reference material for users who need the concrete configuration file structure and paths.

The weegloo server connects to https://ai.weegloo.com/mcp over HTTP, while the weegloo-upload server, which handles files, runs via npx and uses a Personal Access Token for authentication.

{
  "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>"
      }
    }
  }
}

To change the server group, append a group value to the end of the weegloo server's url. For example, to use all tools, write it as https://ai.weegloo.com/mcp?group=all. For the tool composition of each group, refer to MCP Server Groups.

Skills

Claude Code supports Skills as a built-in feature. The install tool places each Skill as a single directory. A global install uses ~/.claude/skills/, and a project install uses .claude/skills/ in the project folder.

Rules

Claude Code supports Rules as a built-in feature. The install tool places each rule as a single .md file. A global install uses ~/.claude/rules/, and a project install uses .claude/rules/ in the project folder.

What to Do Next

MCP: Covers the foundations of the connection, such as server groups and the file upload server.
Skills and Rules: Covers what the Skills and Rules that the install tool sets up alongside it are.
Keeping up to date: Covers how to keep the Skills and Rules you installed up to date.
Migrating Static Pages with AI: Follow the flow of migrating a real page into a content-based service with the MCP connection you set up.