Codex 设置

最后更新：2026年7月10日

Codex 是一个在终端中运行的编码 agent。把 WEEGLOO MCP 服务器连接到它之后，Codex 就能直接创建、读取和修改 Content Type、Content、Media 等资源。连接方式与其他环境相同。先用安装工具一次性完成设置，然后在 Codex 中完成认证即可。

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

准备工作

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

终端
node --version # 显示 v18 及以上即可 npx --version # 显示版本号即可

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

终端
npm install -g npm@latest

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

终端
brew install node

如果没有 Homebrew，请先在 brew.sh 安装，或在 nodejs.org 直接下载 Node.js。

Codex 也需要已安装，并且可以在终端中通过 codex 命令运行。如果还没有，请参阅 Codex CLI 安装指南。

进行连接

选择安装位置，然后按照下面的指南进行操作。只想连接单个项目请选择 项目，想在所有项目中使用请选择 全局。

1

安装 MCP · Skills

复制安装命令，并在终端中运行它。

终端
$ npx weegloo@latest -y \ --agent codex \ --token wgl_••••••••••••
2

认证 MCP

请按以下顺序进行认证。

  1. 1.在终端中运行下面的命令，浏览器会打开 WEEGLOO 认证页面。
    终端
    codex mcp login weegloo
  2. 2.在打开的 WEEGLOO 认证页面中，用下方的 复制令牌 按钮复制令牌并粘贴，然后点击 连接服务器。 认证完成后，如果 agent 已在运行，请重启它。

直接查看配置文件

安装工具会自动生成并管理配置文件，因此用户无需自行查看。以下内容是为需要具体配置文件结构和路径的用户提供的参考资料。

weegloo 服务器以 HTTP 方式连接到 https://ai.weegloo.com/mcp，处理文件的 weegloo-upload 服务器通过 npx 运行，并使用 Personal Access Token 进行认证。以 全局 方式安装时，会注册到用户主目录的 ~/.codex/config.toml；以 项目 方式安装时，会注册到项目文件夹内的 .codex/config.toml。

[mcp_servers.weegloo]
url = "https://ai.weegloo.com/mcp"
 
[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>"

要更换服务器分组，请在 weegloo 服务器的 url 末尾附加 group 值。例如，要使用所有工具，就写成 https://ai.weegloo.com/mcp?group=all。各分组的工具构成请参阅 MCP 服务器分组。

以 项目 方式安装时，安装工具还会在用户主目录的 ~/.codex/config.toml 中追加一个条目。Codex 只在信任的项目中才会读取该文件夹内的 .codex/config.toml。如果没有这个条目，刚刚注册的 MCP 服务器就会被忽略，因此安装工具会把该项目标记为受信任。路径的位置会填入实际执行安装的项目文件夹路径。

[projects."/Users/jimin/projects/jeju-shop"]
trust_level = "trusted"

下一步

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