# Get started WEEGLOO is a platform that turns the screens you create into a real service. Without having to learn how to use a content studio or any communication format, you just tell the AI agent you already use in plain language, and it takes care of everything needed behind the screen, from members and data to publishing and deployment. Underneath it all is a content management system (CMS) that can handle even large-scale services, so you can put any kind of service on top of it. Connect it, and one line is all it takes. ## 1. Prerequisites {#prerequisites} You need Node.js to run the installation commands below. First, use these commands to check whether it is installed and whether the version is 18 or later. ```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 as well. ```terminal npm install -g npm@latest ``` If Node.js is not installed, or if the version is too old, install Node.js using the method for 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 not installed or not recognized, download the LTS installer from [nodejs.org](https://nodejs.org). After installation, open a new terminal. ::: :::: ::::tab{label="Linux"} Distribution packages may 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). ::: :::: ::::: ## 2. Connect your AI agent {#connect} Select the coding tool you use. 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{variant=select sync=tool caption="Coding tool"} :::::::::tab{label="Claude Desktop" icon=claude-desktop} ::::::::tabs{sync=mode-claude-desktop} :::::::tab{label="Basic install" value=basic} ::::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 opens in your browser. Copy your token with the **Copy token** button below, paste it, and click **Connect Server**. Once `weegloo` changes to `connected`, you are done. ```weegloo-token ``` ![](/install/authorize-en.png) :::: ::::::: :::::::tab{label="Custom install" value=custom} Run `npx weegloo` interactively and install by choosing each prompted item yourself. ::::::tabs{variant=segmented caption="Install location" sync=location-claude-desktop} :::::tab{label="Global" value=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 opens in your browser. Copy your token with the **Copy token** button below, paste it, and click **Connect Server**. Once `weegloo` changes to `connected`, you are done. ```weegloo-token ``` ![](/install/authorize-en.png) :::: ::::: :::::tab{label="Project" value=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 opens in your browser. Copy your token with the **Copy token** button below, paste it, and click **Connect Server**. Once `weegloo` changes to `connected`, you are done. ```weegloo-token ``` ![](/install/authorize-en.png) :::: ::::: :::::: ::::::: :::::::: ::::::::: :::::::::tab{label="Claude Code" icon=claude-code} ::::::::tabs{sync=mode-claude-code} :::::::tab{label="Basic install" value=basic} ::::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. 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 opens in your browser. Copy your token with the **Copy token** button below, paste it, and click **Connect Server**. Once `weegloo` changes to `connected`, you are done. ```weegloo-token ``` ![](/install/authorize-en.png) :::: ::::::: :::::::tab{label="Custom install" value=custom} Run `npx weegloo` interactively and install by choosing each prompted item yourself. ::::::tabs{variant=segmented caption="Install location" sync=location-claude-code} :::::tab{label="Global" value=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. 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 opens in your browser. Copy your token with the **Copy token** button below, paste it, and click **Connect Server**. Once `weegloo` changes to `connected`, you are done. ```weegloo-token ``` ![](/install/authorize-en.png) :::: ::::: :::::tab{label="Project" value=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. 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 opens in your browser. Copy your token with the **Copy token** button below, paste it, and click **Connect Server**. Once `weegloo` changes to `connected`, you are done. ```weegloo-token ``` ![](/install/authorize-en.png) :::: ::::: :::::: ::::::: :::::::: ::::::::: :::::::::tab{label="Codex" icon=codex} ::::::::tabs{sync=mode-codex} :::::::tab{label="Basic install" value=basic} ::::step{title="Install MCP and Skills"} Copy the install command and run it in your terminal. ```bash npx weegloo@latest -y --agent codex --token ``` :::: ::::step{title="Authenticate the MCP connection"} Authenticate in the following order. 1. Running the command below in your terminal opens the WEEGLOO authentication page in your browser. ```terminal codex mcp login weegloo ``` 2. On the WEEGLOO authentication page that opens, copy your token with the **Copy token** button below, paste it, and click **Connect Server**. **An agent that was already running needs to be restarted after authentication completes for the changes to take effect.** ```weegloo-token ``` ![](/install/authorize-en.png) :::: ::::::: :::::::tab{label="Custom install" value=custom} Run `npx weegloo` interactively and install by choosing each prompted item yourself. ::::::tabs{variant=segmented caption="Install location" sync=location-codex} :::::tab{label="Global" value=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: Codex ✔ 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. 1. Running the command below in your terminal opens the WEEGLOO authentication page in your browser. ```terminal codex mcp login weegloo ``` 2. On the WEEGLOO authentication page that opens, copy your token with the **Copy token** button below, paste it, and click **Connect Server**. **An agent that was already running needs to be restarted after authentication completes for the changes to take effect.** ```weegloo-token ``` ![](/install/authorize-en.png) :::: ::::: :::::tab{label="Project" value=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: Codex ✔ 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. 1. Running the command below in your terminal opens the WEEGLOO authentication page in your browser. ```terminal codex mcp login weegloo ``` 2. On the WEEGLOO authentication page that opens, copy your token with the **Copy token** button below, paste it, and click **Connect Server**. **An agent that was already running needs to be restarted after authentication completes for the changes to take effect.** ```weegloo-token ``` ![](/install/authorize-en.png) :::: ::::: :::::: ::::::: :::::::: ::::::::: :::::::::tab{label="Cursor" icon=cursor} ::::::::tabs{sync=mode-cursor} :::::::tab{label="Basic install" value=basic} ::::step{title="Install MCP and Skills"} Copy the install command and run it in your terminal. ```bash npx weegloo@latest -y --agent cursor --token ``` :::: ::::step{title="Authenticate the MCP connection"} Authenticate in the following order. 1. Click the gear icon at the bottom left of Cursor to open Settings. ![](/install/cursor/settings.png) 2. In the left settings menu, select **Tools & MCPs** to open the **Home** tab. Click **Connect** to the right of `weegloo`. ![](/install/cursor/global-connect.png) 3. The WEEGLOO authentication page opens in your browser. Copy your token with the **Copy token** button, paste it, and click **Connect Server**. ```weegloo-token ``` ![](/install/authorize-en.png) 4. You can confirm the connection succeeded by the green dots lit next to `weegloo` and `weegloo-upload`. ![](/install/cursor/global-connected.png) :::: ::::::: :::::::tab{label="Custom install" value=custom} Run `npx weegloo` interactively and install by choosing each prompted item yourself. ::::::tabs{variant=segmented caption="Install location" sync=location-cursor} :::::tab{label="Global" value=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: Cursor ✔ 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. 1. Click the gear icon at the bottom left of Cursor to open Settings. ![](/install/cursor/settings.png) 2. In the left settings menu, select **Tools & MCPs** to open the **Home** tab. Click **Connect** to the right of `weegloo`. ![](/install/cursor/global-connect.png) 3. The WEEGLOO authentication page opens in your browser. Copy your token with the **Copy token** button, paste it, and click **Connect Server**. ```weegloo-token ``` ![](/install/authorize-en.png) 4. You can confirm the connection succeeded by the green dots lit next to `weegloo` and `weegloo-upload`. ![](/install/cursor/global-connected.png) :::: ::::: :::::tab{label="Project" value=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: Cursor ✔ 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. 1. Click the gear icon at the bottom left of Cursor to open Settings. ![](/install/cursor/settings.png) 2. In the left settings menu, select **Tools & MCPs**, then in the top tabs select the tab named after your current project. ![](/install/cursor/local-tab.png) 3. Turn on both the `weegloo` and `weegloo-upload` toggles in the **Installed** list. ![](/install/cursor/local-enable.png) 4. When `weegloo` changes to **Needs authentication**, click **Connect** on the right. `weegloo-upload` connects automatically. ![](/install/cursor/local-connect.png) 5. The WEEGLOO authentication page opens in your browser. Copy your token with the **Copy token** button, paste it, and click **Connect Server**. ```weegloo-token ``` ![](/install/authorize-en.png) 6. You can confirm the connection succeeded by the green dots lit next to `weegloo` and `weegloo-upload`. ![](/install/cursor/local-finished.png) :::: ::::: :::::: ::::::: :::::::: ::::::::: :::::::::tab{label="Antigravity" icon=antigravity} :::note{variant="warning" title="MCP authentication can be unstable in Antigravity"} The `weegloo` MCP server uses a standard stateful HTTP MCP connection, but Antigravity's support for stateful MCP connections is not yet stable, so authentication may fail or need to be retried. If you want a more stable setup flow, we recommend using Claude Code, Codex, or Cursor. ::: ::::::::tabs{sync=mode-antigravity} :::::::tab{label="Basic install" value=basic} ::::step{title="Install MCP and Skills"} Copy the install command and run it in your terminal. ```bash npx weegloo@latest -y --agent antigravity --token ``` :::: ::::step{title="Authenticate the MCP connection"} Authenticate in the following order. 1. Run Antigravity with `agy`. ```terminal agy ``` 2. Enter `/mcp` at the prompt. ```terminal /mcp ``` 3. Select `weegloo`. ```terminal readonly MCP Servers Plugins (~/.gemini/config/plugins) > ✗ weegloo error: calling "initialize": sending "initialize": Unauthorized [Auth Needed] ✓ weegloo-upload Tools: CreateUpload Keyboard: ↑/↓ Navigate enter Actions ``` 4. Select **Authenticate**. ```terminal readonly MCP Servers Plugins (~/.gemini/config/plugins) > ✗ weegloo error: calling "initialize": sending "initialize": Unauthorized [Auth Needed] Restart Disable [Authenticate] ✓ weegloo-upload Tools: CreateUpload Keyboard: ←/→ Navigate enter Actions ``` 5. In the token input field on the authentication page that opens, paste the token below. ```weegloo-token ``` ![](/install/authorize-en.png) 6. Copy the `Code` shown on the Google Antigravity page, return to Antigravity, paste it, and press `Enter`. ![](/install/antigravity/code.png) :::note{variant="warning" title="If it shows as an authentication failure"} If the message `Authentication failed: no pending auth state for server weegloo` appears, it may be a temporary problem on the Antigravity side. This is mostly seen in versions below `1.0.16` but can also occur in the latest versions, and you can reconnect with the steps below. 1. Press `Esc` to return to the `MCP Servers` screen. 2. Press `Esc` once more to return to the prompt input screen. 3. Enter `/mcp` again and it connects after going through the `initializing` step. ::: :::: ::::::: :::::::tab{label="Custom install" value=custom} Run `npx weegloo` interactively and install by choosing each prompted item yourself. ::::::tabs{variant=segmented caption="Install location" sync=location-antigravity} :::::tab{label="Global" value=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: Antigravity CLI ✔ 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. 1. Run Antigravity with `agy`. ```terminal agy ``` 2. Enter `/mcp` at the prompt. ```terminal /mcp ``` 3. Select `weegloo`. ```terminal readonly MCP Servers Plugins (~/.gemini/config/plugins) > ✗ weegloo error: calling "initialize": sending "initialize": Unauthorized [Auth Needed] ✓ weegloo-upload Tools: CreateUpload Keyboard: ↑/↓ Navigate enter Actions ``` 4. Select **Authenticate**. ```terminal readonly MCP Servers Plugins (~/.gemini/config/plugins) > ✗ weegloo error: calling "initialize": sending "initialize": Unauthorized [Auth Needed] Restart Disable [Authenticate] ✓ weegloo-upload Tools: CreateUpload Keyboard: ←/→ Navigate enter Actions ``` 5. In the token input field on the authentication page that opens, paste the token below. ```weegloo-token ``` ![](/install/authorize-en.png) 6. Copy the `Code` shown on the Google Antigravity page, return to Antigravity, paste it, and press `Enter`. ![](/install/antigravity/code.png) :::note{variant="warning" title="If it shows as an authentication failure"} If the message `Authentication failed: no pending auth state for server weegloo` appears, it may be a temporary problem on the Antigravity side. This is mostly seen in versions below `1.0.16` but can also occur in the latest versions, and you can reconnect with the steps below. 1. Press `Esc` to return to the `MCP Servers` screen. 2. Press `Esc` once more to return to the prompt input screen. 3. Enter `/mcp` again and it connects after going through the `initializing` step. ::: :::: ::::: :::::tab{label="Project" value=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: Antigravity CLI ✔ 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. 1. Run Antigravity with `agy`. ```terminal agy ``` 2. Enter `/mcp` at the prompt. ```terminal /mcp ``` 3. Select `weegloo`. ```terminal readonly MCP Servers Plugins (~/.gemini/config/plugins) > ✗ weegloo error: calling "initialize": sending "initialize": Unauthorized [Auth Needed] ✓ weegloo-upload Tools: CreateUpload Keyboard: ↑/↓ Navigate enter Actions ``` 4. Select **Authenticate**. ```terminal readonly MCP Servers Plugins (~/.gemini/config/plugins) > ✗ weegloo error: calling "initialize": sending "initialize": Unauthorized [Auth Needed] Restart Disable [Authenticate] ✓ weegloo-upload Tools: CreateUpload Keyboard: ←/→ Navigate enter Actions ``` 5. In the token input field on the authentication page that opens, paste the token below. ```weegloo-token ``` ![](/install/authorize-en.png) 6. Copy the `Code` shown on the Google Antigravity page, return to Antigravity, paste it, and press `Enter`. ![](/install/antigravity/code.png) :::note{variant="warning" title="If it shows as an authentication failure"} If the message `Authentication failed: no pending auth state for server weegloo` appears, it may be a temporary problem on the Antigravity side. This is mostly seen in versions below `1.0.16` but can also occur in the latest versions, and you can reconnect with the steps below. 1. Press `Esc` to return to the `MCP Servers` screen. 2. Press `Esc` once more to return to the prompt input screen. 3. Enter `/mcp` again and it connects after going through the `initializing` step. ::: :::: ::::: :::::: ::::::: :::::::: ::::::::: :::::::::tab{label="Android Studio" icon=android-studio} :::note{variant="warning" title="Using Android Studio for Weegloo integration is strongly discouraged"} Android Studio's built-in AI agent (Gemini) can be used for UI work. However, for code work like Weegloo integration it is very unstable due to AI performance issues, so we strongly recommend using another AI agent such as Claude Code or Codex. Confirmed in `2026.1.1 Patch 2` and earlier versions. ::: ::::::::tabs{sync=mode-android-studio} :::::::tab{label="Basic install" value=basic} ::::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 androidstudio --token ``` :::: ::::step{title="Authenticate the MCP connection"} Once installation finishes, you need to enable the MCP server in Android Studio. 1. Go to `Settings → Tools → AI → MCP Servers`, then click the **JSON View** tab. ![](/install/android-studio/find-json-view-tab.png) 2. Check **Enable MCP Servers**. ![](/install/android-studio/enable-mcp-servers.png) 3. Confirm that `weegloo` and `weegloo-upload` are present in the configuration. ![](/install/android-studio/check-weegloo-mcps.png) 4. Click **Apply** to apply the settings. You can confirm the connection succeeded by the notification that you are connected to `weegloo` and `weegloo-upload`. ![](/install/android-studio/success.png) :::: ::::::: :::::::tab{label="Custom install" value=custom} Run `npx weegloo` interactively and install by choosing each prompted item yourself. ::::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: Android Studio ✔ 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"} Once installation finishes, you need to enable the MCP server in Android Studio. 1. Go to `Settings → Tools → AI → MCP Servers`, then click the **JSON View** tab. ![](/install/android-studio/find-json-view-tab.png) 2. Check **Enable MCP Servers**. ![](/install/android-studio/enable-mcp-servers.png) 3. Confirm that `weegloo` and `weegloo-upload` are present in the configuration. ![](/install/android-studio/check-weegloo-mcps.png) 4. Click **Apply** to apply the settings. You can confirm the connection succeeded by the notification that you are connected to `weegloo` and `weegloo-upload`. ![](/install/android-studio/success.png) :::: ::::::: :::::::: ::::::::: :::::::::tab{label="Xcode" sublabel="Claude Code / Codex" icon=xcode} ::::::::tabs{variant=select sync=xcode-agent caption="Agent to use in Xcode"} :::::::tab{label="Claude Code" icon=claude-code} ::::::tabs{sync=mode-xcode-claude-code} :::::tab{label="Basic install" value=basic} ::::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 --host xcode --location project --token ``` :::: ::::step{title="Authenticate the MCP connection"} Authenticate in the following order. 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 opens in your browser. Copy your token with the **Copy token** button below, paste it, and click **Connect Server**. Once `weegloo` changes to `connected`, you are done. ```weegloo-token ``` ![](/install/authorize-en.png) :::note After installation, you need to open a new Xcode Agent session for the settings to take effect. ::: :::: ::::: :::::tab{label="Custom install" value=custom} Run `npx weegloo` interactively and install by choosing each prompted item yourself. ::::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. 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 opens in your browser. Copy your token with the **Copy token** button below, paste it, and click **Connect Server**. Once `weegloo` changes to `connected`, you are done. ```weegloo-token ``` ![](/install/authorize-en.png) :::note After installation, you need to open a new Xcode Agent session for the settings to take effect. ::: :::: ::::: :::::: ::::::: :::::::tab{label="Codex" icon=codex} ::::::tabs{sync=mode-xcode-codex} :::::tab{label="Basic install" value=basic} ::::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 codex --host xcode --location project --token ``` :::: ::::step{title="Authenticate the MCP connection"} Authenticate in the following order. 1. Running the command below in your terminal opens the WEEGLOO authentication page in your browser. ```terminal codex mcp login weegloo ``` 2. On the WEEGLOO authentication page that opens, copy your token with the **Copy token** button below, paste it, and click **Connect Server**. **An agent that was already running needs to be restarted after authentication completes for the changes to take effect.** ```weegloo-token ``` ![](/install/authorize-en.png) :::note After installation, you need to open a new Xcode Agent session for the settings to take effect. ::: :::: ::::: :::::tab{label="Custom install" value=custom} Run `npx weegloo` interactively and install by choosing each prompted item yourself. ::::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: Codex ✔ 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. 1. Running the command below in your terminal opens the WEEGLOO authentication page in your browser. ```terminal codex mcp login weegloo ``` 2. On the WEEGLOO authentication page that opens, copy your token with the **Copy token** button below, paste it, and click **Connect Server**. **An agent that was already running needs to be restarted after authentication completes for the changes to take effect.** ```weegloo-token ``` ![](/install/authorize-en.png) :::note After installation, you need to open a new Xcode Agent session for the settings to take effect. ::: :::: ::::: :::::: ::::::: :::::::: ::::::::: :::::::::: ## 3. One line is all it takes {#tell-your-ai} You do not even have to describe what you are building. This one line is enough. > Integrate this with WEEGLOO. The agent looks at the screens you built and works out for itself what kind of service it is. Then it completes the features you need, such as members, permissions, and search. If it is a web service, it even handles deployment for you. ![Get started demo](https://youtu.be/X-Dl0umOCJs) ## What comes next {#what-to-do-next} - [Integrate with one sentence](/ai/build/integrate.md): covers in detail the flow of building all the features you need at once with the single phrase "Integrate this with WEEGLOO". - [Store your data and pull it back out](/ai/build/data.md): an example of asking for features one at a time, such as data, search, and members. - [What is WEEGLOO?](/ai/what-is-weegloo.md): covers what WEEGLOO is and why you would use it. - [Before You Start](/getting-started/before-you-start.md): covers the full blueprint for when you work by hand in the content studio. - [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.