Codex 配置

介绍如何在 Codex 中连接 WEEGLOO MCP 服务器。连接后，Codex 就能直接查询、创建和修改 WEEGLOO 的资源。完整流程以及服务器分组、文件上传服务器在 MCP 中介绍。本页只说明 Codex 相关的连接步骤。

准备事项

在连接之前，需要准备以下内容。

• Codex：需要已安装 Codex。
• Node.js 18 及以上：运行安装工具和文件传输服务器（weegloo-upload）需要它。可以在 Node.js 下载 处获取。
• Personal Access Token：用于认证。Personal Access Token 是账户以自身权限调用 API 时使用的钥匙。申请方法在 申请 Personal Access Token 中介绍。

用安装工具连接

使用安装工具后，MCP 服务器会自动注册到 Codex 配置文件中。在项目文件夹中执行以下命令。

npx weegloo@latest

执行后会依次询问。每个问题的含义如下。

1. Select plugin version (branch)：选择 Skills 和 Rules 的版本。一般选择 latest。
2. Select your IDE：选择 Codex。
3. What would you like to install?：可以分别安装 MCP 服务器和 Skills / Rules。如果是首次安装，请全部安装。
4. Enter your Weegloo Personal Access Token：输入事先申请好的 Personal Access Token。
5. Select the MCP server group：如果是常规用途，请选择 default。服务器分组的种类在 MCP 中介绍。
6. Where would you like to install Codex configuration：只对当前项目生效请选择 Project，对所有项目生效请选择 Global。根据 Codex 版本，可能不支持 Project 安装，这时请用 Global 安装。

安装完成后，配置工具会把 MCP 服务器注册到 Codex 配置文件（config.toml）中。用 Global 安装时注册到 ~/.codex/config.toml，用 Project 安装时注册到项目的 Codex 配置文件中。

登录 MCP 服务器

weegloo 服务器以 HTTP 方式连接，除安装外还需要单独登录一次。安装工具会接着执行这个登录步骤。如果没有自动执行，请直接执行以下命令。

codex mcp login weegloo

执行后会在浏览器中打开认证页面。完成认证后，weegloo 服务器的连接就完成了。文件传输用的 weegloo-upload 服务器使用配置文件中填入的 Personal Access Token 进行认证，因此不需要这个登录步骤。

直接编辑配置文件

也可以不使用安装工具，直接编辑 Codex 配置文件（config.toml）。weegloo 服务器以 HTTP 方式连接。

[mcp_servers.weegloo]
url = "https://ai.weegloo.com/mcp"

要指定服务器分组，请在地址末尾追加 group 值。例如，要使用全部工具，可以写成下面这样。

[mcp_servers.weegloo]
url = "https://ai.weegloo.com/mcp?group=all"

文件传输用的 weegloo-upload 服务器通过命令运行，认证使用 Personal Access Token。在 token 的位置填入已申请的 Personal Access Token。

[mcp_servers.weegloo-upload]
command = "npx"
args = ["-y", "weegloo-upload"]
 
[mcp_servers.weegloo-upload.env]
UPLOAD_API_URL = "https://upload.weegloo.com/v1"
AUTH_BEARER_TOKEN = "<Personal Access Token>"

如果直接编辑了配置文件，请重启 Codex。之后 weegloo 服务器按上面的 登录 MCP 服务器 步骤登录一次。

接下来要做的事

• MCP：介绍服务器分组、文件上传服务器等连接的整体全貌。
• Skills 和 Rules：介绍安装工具可以一并安装的 Skills 和 Rules。
• 用 AI 迁移静态页面：跟随用连接好的 MCP 把实际页面迁移到基于内容的服务中的流程。