---
title: "连接 ReUI MCP"
summary: "服务地址为 https://mcp.reui.io。交互使用 OAuth，无头环境可通过 REUI_LICENSE_KEY 提供个人 token。"
category: mcp
level: starter
surfaces: [cli, app, ide]
tags: ["MCP", "ReUI", "OAuth", "HTTP", "bearer_token_env_var"]
canonical: /tips/reui-mcp-http/
---

# 连接 ReUI MCP

服务地址为 https://mcp.reui.io。交互使用 OAuth，无头环境可通过 REUI_LICENSE_KEY 提供个人 token。

ReUI 文档包含 Codex 的配置说明。远程入口是 `https://mcp.reui.io`，**没有** `/mcp` 后缀。Streamable HTTP。先 OAuth：

```bash
codex mcp add reui --url https://mcp.reui.io
codex mcp login reui
```

```toml
[mcp_servers.reui]
url = "https://mcp.reui.io"
enabled = true
```

浏览器会开 Sign in with ReUI。没有账号会在这一步建免费号。`codex mcp list` 应列出 `reui`。TUI 里 `/mcp` 看是否还要授权。

无头 / CI 才走个人 token。到 Account → MCP 建，样子是 `reui_pat_` 开头，只显示一次。官方 Codex 命令：

```bash
codex mcp add reui --url https://mcp.reui.io --bearer-token-env-var REUI_LICENSE_KEY
```

```toml
[mcp_servers.reui]
url = "https://mcp.reui.io"
bearer_token_env_var = "REUI_LICENSE_KEY"
enabled = true
```

`--bearer-token-env-var` 填变量**名**。Codex 从启动环境中读取 `REUI_LICENSE_KEY`。Codex 不读 `.env.local`。从 Dock 或开始菜单启动的桌面应用通常不会加载终端环境变量。从已经 export 的终端启动。

Bearer token 和 OAuth 请选择一种认证方式。配置了 `bearer_token_env_var` / `http_headers` / `env_http_headers` 时，每次请求都带该请求头，会盖掉已存的 OAuth。于是登录看起来成功，调用却一直 401。使用 OAuth 时，请移除手动配置的认证头。PAT 过期或被吊销时，需要到 Account → MCP 换新 token。401 响应体会写明是 OAuth 还是 PAT。

官方还写：安装器可能把 URL 写成 `https://mcp.reui.io/api/mcp`。以专节的 `codex mcp add reui --url https://mcp.reui.io` 为准。地址无需添加 `/mcp` 后缀。配置后用 `codex mcp get reui` 看 url。

`components.json` 中的 `${REUI_LICENSE_KEY}` 占位符仅适用于 shadcn CLI。那是 shadcn CLI 从 `.env.local` 展开的写法，Codex 的 TOML **不会**展开，服务器会收到字面量然后 401。Premium 组件才把许可证写进 `.env.local` 和 `@reui` registry 头，那是 shadcn 安装器用的，不是这条 MCP OAuth。

技能安装器官方是 `curl -fsSL https://mcp.reui.io/install | node -`，会在项目中安装 ReUI skill。

免费档大约每天 100 次工具调用；22 个组件和 `c-*` 示例不用许可证。装 premium 才要 Pro / Ultimate。先问「Use ReUI to scaffold an admin app」。工具灰掉就 `codex mcp login reui` 再新开会话。

网页 Cloud 不读取 `~/.codex/config.toml`。修改后重新打开会话。用 `codex mcp get reui` 看传输是 streamable_http。OAuth 路径的 Auth 应显示 OAuth。

## 来源

- [ReUI · Codex](https://reui.io/docs/codex)
- [ReUI · MCP Server](https://reui.io/docs/mcp)
- [ReUI · License Setup](https://reui.io/docs/license-setup)