Xcode 设置

Xcode 可以在自己的界面中运行 Claude Code、Codex 等编码 agent。把 WEEGLOO MCP 服务器连接到它之后，在 Xcode 中运行的 agent 就能直接创建、读取和修改 Content Type、Content、Media 等资源。请在下面选择要在 Xcode 中使用的 agent，用安装工具一次性完成设置，然后完成认证即可。

关于 MCP 本身、服务器分组以及文件上传服务器的说明，请参阅 MCP。本页只讲连接到 Xcode 的步骤。

准备工作

要运行下面的安装命令，需要 Node.js。请先用以下命令确认是否已安装，以及版本是否为 18 及以上。

如果已安装 Node.js 但没有 npx，请用下面的命令把 npm 更新到最新版本。更新 npm 会一并安装 npx。

如果尚未安装 Node.js 或版本过低，请按照所用操作系统对应的方法安装 Node.js。

Xcode 也需要已安装。如果还没有，可以在 Xcode 下载 处获取。

进行连接

请选择要在 Xcode 中使用的 agent，然后按照下面的指南进行操作。Xcode 的连接总是安装到当前项目，因此请在要连接的项目文件夹内运行安装命令。

在 Xcode 中使用的智能体Claude Code

1

安装 MCP · Skills

复制安装命令，并在终端中运行它。请务必在你要连接的项目文件夹内运行。

终端

$ npx weegloo@latest -y \ --agent claude \ --host xcode \ --token wgl_••••••••••••

复制命令

2

认证 MCP

请按以下顺序进行认证。

1. 1.在终端中运行 Claude Code。请务必在你要连接的项目文件夹内运行。
   终端

   claude
2. 2.首次运行时，可能会询问要启用哪些新的 MCP 服务器。如果出现，请确认 weegloo 和 weegloo-upload 已勾选，然后按 Enter 提交。
   终端

   New MCP servers found in .mcp.json Select any you wish to enable. > [√] weegloo [√] weegloo-upload
3. 3.输入 /mcp 打开 MCP 服务器管理界面。
   终端

   /mcp
4. 4.在列表中选择 weegloo，它会显示为 needs authentication。
   终端

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

   如果列表中没有这些服务器

   如果列表中看不到 weegloo 和 weegloo-upload，可能是在第 2 步的启用界面没有提交，或它们处于禁用状态。请退出 Claude Code，在终端中输入下面的命令，然后再次运行 claude。当再次出现与第 2 步相同的界面时，确认 weegloo 和 weegloo-upload 已勾选，然后按 Enter 提交。

   终端

   claude mcp reset-project-choices
5. 5.确认地址为 https://ai.weegloo.com/mcp，然后选择 Authenticate。
   终端

   Weegloo MCP Server Status: ∆ needs authentication URL: https://ai.weegloo.com/mcp > 1. Authenticate 2. Disable
6. 6.选择 Authenticate 后，浏览器会打开如下所示的 WEEGLOO 认证页面。用 复制令牌 按钮复制令牌并粘贴，然后点击 连接服务器。当 weegloo 变为 connected 即完成。

复制令牌

安装后新开一个 Xcode Agent 会话才会加载配置。

直接查看配置文件

安装工具会把服务器注册到你选择在 Xcode 中使用的 agent 的配置文件中。Xcode 的连接总是安装到当前项目，因此文件也会创建在项目文件夹内。文件因所选 agent 而异。

• Claude Code：项目文件夹中的 .mcp.json（格式与 Claude Code 设置 相同）
• Codex：项目文件夹中的 .codex/config.toml（格式与 Codex 配置 相同）

只有在 Xcode 中使用时，有一处不同：处理文件的 weegloo-upload 服务器的 env 中会额外包含一个 PATH 项。因为 Xcode 以最小的 PATH 运行 agent，如果没有这一项，就找不到运行服务器所需的 npx。以 Claude Code（.mcp.json）为例，大致如下所示。

{
  "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",
        "AUTH_BEARER_TOKEN": "<Personal Access Token>"
      }
    }
  }
}

这个 PATH 中会原样写入运行安装时所用 Node 的位置。把 Node 升级到新版本后，这个路径就会失效，因此升级之后请重新运行安装工具来更新该值。

下一步

• MCP：介绍服务器分组、文件上传服务器等作为连接基础的内容。
• Skills 与 Rules：介绍安装工具一并安装的 Skills 和 Rules 是什么。
• 用 AI 迁移静态页面：跟随流程，用已连接的 MCP 把实际页面迁移为基于内容的服务。