# Claude Setup Claude Desktop includes the coding agent Claude Code as a **Code tab**. You connect and use the WEEGLOO MCP server through this Code tab. This connection lets the agent in the Code tab 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 the agent in the Code tab 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, and once you finish authentication with `claude`'s `/mcp`, you can use it right away in the Code tab. For details on the MCP server and on Skills and Rules, see the [MCP](/ai/tools/mcp.md) and [Skills and Rules](/ai/tools/skill-rules.md) pages respectively. This page covers only how to connect to the Code tab in Claude Desktop. :::note Claude Desktop's Code tab runs on Claude Code. WEEGLOO connects through the Code tab too, using the same MCP, Skills, and Rules settings as Claude Code. Claude Code must be installed so that you can run the `claude` command in your terminal. If you do not have it yet, see the [Claude Code install guide](https://code.claude.com/docs/quickstart#step-1-install-claude-code). ::: ## Prerequisites {#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. :::::tabs ::::tab{label="macOS"} ```terminal brew install node ``` :::note If you do not have Homebrew, install it first from [brew.sh](https://brew.sh), or download Node.js directly from [nodejs.org](https://nodejs.org). ::: :::: ::::tab{label="Windows"} ```terminal winget install OpenJS.NodeJS.LTS ``` :::note If winget is missing or not recognized, download the LTS installer from [nodejs.org](https://nodejs.org). After installing, you need to open a new terminal. ::: :::: ::::tab{label="Linux"} 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 ``` :::note To download the installer directly, check [nodejs.org](https://nodejs.org). ::: :::: ::::: ## Connecting {#connect} For a basic install, copy the install command on this page and run it once in your terminal. To choose each install step yourself, open **Custom Install**. ::::::::tabs :::::::tab{label="Basic Install"} ::::::tabs{variant=segmented caption="Install location"} :::::tab{label="Global"} ::::step{title="Install MCP and Skills"} Copy the install command and run it in your terminal. ```bash npx weegloo@latest -y --agent claude --token ``` :::: ::::step{title="Authenticate the MCP connection"} Authenticate in the following order. :::note This step requires the Claude Code CLI (`claude`). If you do not have it yet, install [Claude Code](https://code.claude.com/docs/quickstart#step-1-install-claude-code). ::: 1. Run Claude Code in your terminal. ```terminal claude ``` 2. Enter `/mcp` to open the MCP server management screen. ```terminal /mcp ``` 3. Select `weegloo` from the list. It shows a `needs authentication` status. ```terminal readonly Manage MCP servers > weegloo · ∆ needs authentication weegloo-upload · √ connected ``` 4. Check that the connection URL is `https://ai.weegloo.com/mcp` and select **Authenticate**. ```terminal readonly Weegloo MCP Server Status: ∆ needs authentication URL: https://ai.weegloo.com/mcp > 1. Authenticate 2. Disable ``` 5. When you select **Authenticate**, the WEEGLOO authentication page below opens in your browser. Copy your token with the **Copy token** button, paste it, and click **Connect Server**. Once `weegloo` changes to `connected`, you are done. ```weegloo-token ``` ![WEEGLOO authentication page](/install/authorize-en.png) :::: ::::: :::::tab{label="Project"} ::::step{title="Install MCP and Skills"} Copy the install command and run it in your terminal. **You must run it inside the project folder you want to connect.** ```bash npx weegloo@latest -y --agent claude --location project --token ``` :::: ::::step{title="Authenticate the MCP connection"} Authenticate in the following order. :::note This step requires the Claude Code CLI (`claude`). If you do not have it yet, install [Claude Code](https://code.claude.com/docs/quickstart#step-1-install-claude-code). ::: 1. Run Claude Code in your terminal. **You must run it inside the project folder you want to connect.** ```terminal claude ``` 2. On first run, it may ask whether to enable the new MCP servers. In that case, confirm that `weegloo` and `weegloo-upload` are checked and press `Enter` to submit. ```terminal readonly New MCP servers found in .mcp.json Select any you wish to enable. > [√] weegloo [√] weegloo-upload ``` 3. Enter `/mcp` to open the MCP server management screen. ```terminal /mcp ``` 4. Select `weegloo` from the list. It shows a `needs authentication` status. ```terminal readonly Manage MCP servers > weegloo · ∆ needs authentication weegloo-upload · √ connected ``` :::note **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 them on the enable 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 ``` ::: 5. Check that the connection URL is `https://ai.weegloo.com/mcp` and select **Authenticate**. ```terminal readonly Weegloo MCP Server Status: ∆ needs authentication URL: https://ai.weegloo.com/mcp > 1. Authenticate 2. Disable ``` 6. When you select **Authenticate**, the WEEGLOO authentication page below opens in your browser. Copy your token with the **Copy token** button, paste it, and click **Connect Server**. Once `weegloo` changes to `connected`, you are done. ```weegloo-token ``` ![WEEGLOO authentication page](/install/authorize-en.png) :::: ::::: :::::: ::::::: :::::::tab{label="Custom Install"} Run `npx weegloo` interactively and install by choosing each prompted item yourself. ::::::tabs{variant=segmented caption="Install location"} :::::tab{label="Global"} ::::step{title="Run the install tool"} Run the command below in your terminal and choose each prompted item in turn. Where it asks for the token, copy your token with the **Copy token** button below and paste it. ```weegloo-token ``` ```terminal npx weegloo@latest ``` ```terminal readonly ✔ 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! ``` :::: ::::step{title="Authenticate the MCP connection"} Authenticate in the following order. :::note This step requires the Claude Code CLI (`claude`). If you do not have it yet, install [Claude Code](https://code.claude.com/docs/quickstart#step-1-install-claude-code). ::: 1. Run Claude Code in your terminal. ```terminal claude ``` 2. Enter `/mcp` to open the MCP server management screen. ```terminal /mcp ``` 3. Select `weegloo` from the list. It shows a `needs authentication` status. ```terminal readonly Manage MCP servers > weegloo · ∆ needs authentication weegloo-upload · √ connected ``` 4. Check that the connection URL is `https://ai.weegloo.com/mcp` and select **Authenticate**. ```terminal readonly Weegloo MCP Server Status: ∆ needs authentication URL: https://ai.weegloo.com/mcp > 1. Authenticate 2. Disable ``` 5. When you select **Authenticate**, the WEEGLOO authentication page below opens in your browser. Copy your token with the **Copy token** button, paste it, and click **Connect Server**. Once `weegloo` changes to `connected`, you are done. ```weegloo-token ``` ![WEEGLOO authentication page](/install/authorize-en.png) :::: ::::: :::::tab{label="Project"} ::::step{title="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, copy your token with the **Copy token** button below and paste it. **Be sure to run it inside that project folder.** ```weegloo-token ``` ```terminal npx weegloo@latest ``` ```terminal readonly ✔ 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? Project … ✔ Installation complete! ``` :::: ::::step{title="Authenticate the MCP connection"} Authenticate in the following order. :::note This step requires the Claude Code CLI (`claude`). If you do not have it yet, install [Claude Code](https://code.claude.com/docs/quickstart#step-1-install-claude-code). ::: 1. Run Claude Code in your terminal. **You must run it inside the project folder you want to connect.** ```terminal claude ``` 2. On first run, it may ask whether to enable the new MCP servers. In that case, confirm that `weegloo` and `weegloo-upload` are checked and press `Enter` to submit. ```terminal readonly New MCP servers found in .mcp.json Select any you wish to enable. > [√] weegloo [√] weegloo-upload ``` 3. Enter `/mcp` to open the MCP server management screen. ```terminal /mcp ``` 4. Select `weegloo` from the list. It shows a `needs authentication` status. ```terminal readonly Manage MCP servers > weegloo · ∆ needs authentication weegloo-upload · √ connected ``` :::note **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 them on the enable 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 ``` ::: 5. Check that the connection URL is `https://ai.weegloo.com/mcp` and select **Authenticate**. ```terminal readonly Weegloo MCP Server Status: ∆ needs authentication URL: https://ai.weegloo.com/mcp > 1. Authenticate 2. Disable ``` 6. When you select **Authenticate**, the WEEGLOO authentication page below opens in your browser. Copy your token with the **Copy token** button, paste it, and click **Connect Server**. Once `weegloo` changes to `connected`, you are done. ```weegloo-token ``` ![WEEGLOO authentication page](/install/authorize-en.png) :::: ::::: :::::: ::::::: :::::::: ## MCP Server Configuration File {#mcp-config-file} :::note The Code tab uses Claude Code's MCP, Skills, and Rules settings as they are. So the servers you connect do not appear in Claude Desktop's connector, plugin, or MCP screens; they can be used only in the Code tab. To check the installed servers, run `claude` in your terminal and enter `/mcp`. The install tool also creates and manages the `.mcp.json` below automatically, so you rarely need to open it yourself. The configuration 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. ```json { "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": "" } } } } ``` 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](/ai/tools/mcp.md#mcp-server-groups). ## Skills {#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 {#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 {#what-to-do-next} - [MCP](/ai/tools/mcp.md): Covers the foundations of the connection, such as server groups and the file upload server. - [Skills and Rules](/ai/tools/skill-rules.md): Covers what the Skills and Rules that the install tool sets up alongside it are. - [Keeping up to date](/ai/tools/skill-rules.md#keeping-up-to-date): Covers how to keep the Skills and Rules you installed up to date. - [Migrating Static Pages with AI](/getting-started/quick-start/intro-7/intro-7-1.md): Follow the flow of migrating a real page into a content-based service with the MCP connection you set up.