Setting Up Claude Code

Last updated: June 22, 2026

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. The connection works the same way as in other environments. You set everything up at once with the install tool, then complete authentication in Claude Code.

MCP itself, the server groups, and the file upload server are covered in MCP. This page covers only the steps to connect to Claude Code.

What You Need

  • Node.js 18 or later: Required to run the install tool and the file transfer server (weegloo-upload).
  • Personal Access Token: Used for authentication. How to issue one is covered in Issuing a Personal Access Token.
  • Claude Code: Available to run from your terminal with the claude command.

Connecting with the Install Tool

Move to the project folder you want to connect, then run the install tool from that folder. MCP settings are saved per folder, so the location where you run it is the project the settings apply to.

npx weegloo@latest

When you run it, it asks a series of questions. Choose the following for each item.

  1. Select plugin version (branch): The version of Skills and Rules. Choose latest.
  2. Select your IDE: Choose Claude Code.
  3. What would you like to install?: You can install the MCP server and Skills / Rules separately. For a first install, install everything.
  4. Enter your Weegloo Personal Access Token: Paste the Personal Access Token you issued earlier.
  5. Select the MCP server group: Normally, choose default. The differences between server groups are covered in MCP Server Groups.
  6. Where would you like to install ... configuration: To apply the settings to the current project only, choose Project. If Project installation is not supported by your Claude Code version, install with Global instead.

When the install finishes, an .mcp.json file and a .claude/ directory are created in the project folder, and the two MCP servers weegloo and weegloo-upload are registered.

√ 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!

Inspecting the Configuration File Yourself

The .mcp.json that the install tool creates looks like the following. 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.

Turning On the Servers in Claude Code

Run Claude Code from the project folder that contains the configuration file.

claude

On the first run, it asks whether to turn on the servers that were newly added to .mcp.json. Select the two servers and press Enter to turn them on.

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

The weegloo-upload server authenticates immediately with the Personal Access Token placed in the configuration file and reaches the connected state. The weegloo server is an HTTP connection that needs separate authentication, so it is shown in the needs authentication state.

Authenticating the weegloo Server

To authenticate the weegloo server, open the MCP server management screen. From the list of registered servers, choose weegloo.

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

When you choose weegloo, a status screen appears. Confirm that the connection address is correct as https://ai.weegloo.com/mcp, then choose Authenticate.

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

When you choose Authenticate, a login page opens in your browser. If the browser does not open automatically, enter the address shown in Claude Code directly into your browser's address bar. Entering the Personal Access Token you issued earlier completes the authentication.

Once authentication is done, the weegloo server's status changes to connected. From now on, when you make a request in natural language in Claude Code, you can work with WEEGLOO resources directly.

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.
  • 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.