Xcode Setup | Weegloo Docs

Xcode can run coding agents such as Claude Code and Codex inside its own interface. Once you connect the WEEGLOO MCP server to it, the agent running inside Xcode 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, helping the agent use the WEEGLOO API as intended. Skills are guides for doing a specific task well, and Rules are rules to follow across all tasks. Below, choose the agent you want to use inside Xcode, 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 Xcode.

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 (opens in a new tab), or download Node.js directly from nodejs.org (opens in a new tab).

Terminal

winget install OpenJS.NodeJS.LTS

If winget is missing or not recognized, download the LTS installer from nodejs.org (opens in a new tab). 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 (opens in a new tab).

Xcode must also be installed. If you do not have it yet, you can get it from Download Xcode (opens in a new tab).

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. An Xcode connection is always installed into the current project, so run the install command inside the project folder you want to connect.

Coding tool

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 \ --host xcode \ --location project

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
The first time you run it, 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
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 shows as needs authentication.

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

If you do not see the servers 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
Confirm the connection URL 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. Check that the signed-in account is correct, then click Allow. Once weegloo changes to connected, you are done.

If you are not signed in to WEEGLOO in this browser, the sign-in screen opens first, and once you sign in, you return to the authentication page. If you have not yet agreed to the WEEGLOO Terms of Service, or the terms have changed, a checkbox for agreeing to the Terms of Service also appears. In that case, select the checkbox and then click Allow.

After installing, you need to open a new Xcode Agent session for the settings to take effect.

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 codex \ --host xcode \ --location project

Authenticate the MCP connection

Authenticate in the following order.

Running the command below in your terminal opens the WEEGLOO authentication page in your browser.

Terminal
codex mcp login weegloo
On the WEEGLOO authentication page that opens, check that the signed-in account is correct, then click Allow. An agent that was already running needs to be restarted after authentication completes for the changes to take effect.

If you are not signed in to WEEGLOO in this browser, the sign-in screen opens first, and once you sign in, you return to the authentication page. If you have not yet agreed to the WEEGLOO Terms of Service, or the terms have changed, a checkbox for agreeing to the Terms of Service also appears. In that case, select the checkbox and then click Allow.

After installing, you need to open a new Xcode Agent session for the settings to take effect.

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

Coding tool

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. Be sure to run it inside that project folder.

Terminal

npx weegloo@latest

Terminal

✔ Select your IDE: Claude Code ✔ What would you like to install? MCP server, Skills and Rules ✔ Select the MCP server group: default ✔ Where would you like to install the configuration? Project … ✔ Installation complete!

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
The first time you run it, 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
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 shows as needs authentication.

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

If you do not see the servers 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
Confirm the connection URL 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. Check that the signed-in account is correct, then click Allow. Once weegloo changes to connected, you are done.

If you are not signed in to WEEGLOO in this browser, the sign-in screen opens first, and once you sign in, you return to the authentication page. If you have not yet agreed to the WEEGLOO Terms of Service, or the terms have changed, a checkbox for agreeing to the Terms of Service also appears. In that case, select the checkbox and then click Allow.

After installing, you need to open a new Xcode Agent session for the settings to take effect.

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. Be sure to run it inside that project folder.

Terminal

npx weegloo@latest

Terminal

✔ Select your IDE: Codex ✔ What would you like to install? MCP server, Skills and Rules ✔ Select the MCP server group: default ✔ Where would you like to install the configuration? Project … ✔ Installation complete!

Authenticate the MCP connection

Authenticate in the following order.

Running the command below in your terminal opens the WEEGLOO authentication page in your browser.

Terminal
codex mcp login weegloo
On the WEEGLOO authentication page that opens, check that the signed-in account is correct, then click Allow. An agent that was already running needs to be restarted after authentication completes for the changes to take effect.

If you are not signed in to WEEGLOO in this browser, the sign-in screen opens first, and once you sign in, you return to the authentication page. If you have not yet agreed to the WEEGLOO Terms of Service, or the terms have changed, a checkbox for agreeing to the Terms of Service also appears. In that case, select the checkbox and then click Allow.

After installing, you need to open a new Xcode Agent session for the settings to take effect.

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 install tool registers the server in the configuration file of the agent you chose to use inside Xcode. An Xcode connection is always installed into the current project, so the file is created inside the project folder too. The file differs depending on the agent you chose.

Claude Code: .mcp.json in the project folder (the format is the same as in Claude Code Setup)
Codex: .codex/config.toml in the project folder (the format is the same as in Codex Setup)

There is one difference specific to using it inside Xcode. A PATH entry is added to the env of the weegloo-upload server, which handles files. Xcode runs agents with a minimal PATH, and without this entry it cannot find the npx needed to run the server. For Claude Code (.mcp.json), it looks like the following.

{
  "mcpServers": {
    "weegloo-upload": {
      "command": "npx",
      "args": ["-y", "weegloo-upload"],
      "env": {
        "PATH": "/Users/jiwoo/.nvm/versions/node/v22.14.0/bin:/usr/bin:/bin",
        "UPLOAD_API_URL": "https://upload.weegloo.com/v1"
      }
    }
  }
}

This PATH is hardcoded with the location of the Node that ran the install. If you move Node to a new version, this path no longer matches, so after upgrading, run the install tool again to refresh the value.

Skills and Rules

Skills and Rules also follow the approach of the agent you chose. For their detailed locations, see the Skills and Rules sections of Claude Code Setup and Codex Setup.

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 a Static Page with AI: Follow the flow of migrating a real page into a content-based service with the MCP connection you set up.