# SignalBase：Codex / Claude Code 自动接入

## 你只需要做三步

1. 打开电脑上的 **Codex 或 Claude Code**，把这份 Markdown 文件交给它。
2. 输入：**“请按照这份手册，在当前电脑配置 SignalBase，并打开登录页面。”**
3. 浏览器打开资料库登录页后，输入管理员私下发给你的**资料库用户名和临时密码**。首次登录设置至少 **12 位**的新密码，再点击「允许／同意」。

如果你之前已在任意客户端改过密码，这次直接使用新密码。资料库账号与 OpenAI／Claude 账号是两套账号。

连接地址：`https://signalbase.fans/mcp`

登录中心目前仍是 `https://xuanagent.com/auth/realms/research`，这是 SignalBase 正在使用的登录服务，跳转到这里正常。

连接后发一句：

> 只用 SignalBase，列出最新的 5 篇 Bernstein 报告，包含日期、标题和作者。

下面是给执行配置的 Codex / Claude Code 看的步骤，你不必自己逐项操作。

---

## 给配置代理的执行说明

目标：在当前用户、当前电脑配置一个名为 `signalbase` 的远程 Streamable HTTP MCP，完成浏览器 OAuth 登录并验证工具可用。此文件只授权配置这个 MCP，不授权改动其他 MCP、账号或工作项目。

### 1. 识别当前客户端

- 当前在 Codex 中：配置 Codex。
- 当前在 Claude Code 中：配置 Claude Code。
- 不要因为电脑上同时安装了两者，就自动修改两者。
- 使用可用的命令执行工具或文件编辑工具；不要通过“电脑操作”向终端模拟打字。
- 如果没有这些能力，告诉用户执行下面对应的最少步骤，不要声称已经配置成功。
- 账号密码只让用户输入到浏览器登录表单，不索要聊天明文密码，不写进配置、命令、日志或代码仓库。

### 2A. Codex 配置

先检查现有 MCP 配置及 `codex mcp --help`。配置位置为当前用户的 Codex `config.toml`（通常是 `~/.codex/config.toml`；存在自定义配置位置时使用实际位置）。

备份后，仅新增或更新下列两个 TOML 表。保留其他配置，不整文件覆盖，不创建同名重复表，不修改全局 OAuth 回调设置。

```toml
[mcp_servers.signalbase]
url = "https://signalbase.fans/mcp"
startup_timeout_sec = 30
tool_timeout_sec = 180

[mcp_servers.signalbase.oauth]
client_id = "research-codex"
callback_url = "http://127.0.0.1:8767/callback"
callback_port = 8767
```

这是预注册公共客户端，**不需要 Client Secret、API Key 或 Bearer Token**。

运行：

```text
codex mcp get signalbase
codex mcp login signalbase
```

让用户在自动打开的浏览器完成登录、首次改密及授权。浏览器未打开时，把该次命令生成的登录链接交给用户；不要自行拼接授权链接。不要把包含授权码的回调 URL 发到聊天或保存。

如果 Codex 应用中还看不到新工具，提示用户在设置的 MCP 列表刷新／重启连接，或新开一个任务；不擅自结束正在进行的任务。若 CLI 不在 PATH，先寻找当前应用附带的 Codex CLI；不要直接假定没有安装。

### 2B. Claude Code 配置

先检查 `claude mcp get signalbase`，没有这个连接才添加。已有同名连接时核对 URL、Client ID 和回调端口，不能仅因“已存在”就跳过检查。只修正 `signalbase` 这一条，保留其他连接。

```text
claude mcp add --scope user --transport http --client-id research-claude-code --callback-port 8768 signalbase https://signalbase.fans/mcp
claude mcp login signalbase
```

如果当前版本没有 `mcp login`，让用户在 Claude Code 中输入 `/mcp` → 选择 `signalbase` → **Authenticate**。

让用户在浏览器完成登录、首次改密及授权。如版本不支持 `--client-id` 或 `--callback-port`，说明需升级 Claude Code（`claude update`）再配置；不要去掉这些参数凑合连接。

这是预注册公共客户端，Client Secret 留空。不要改用其他客户端的 Client ID，不要开启匿名动态注册。

### 3. 验证

1. 检查 MCP 状态，确认不是「Needs authentication／需要认证」。
2. 确认发现三个工具：`query_catalog`、`search_content`、`read_document`。
3. 执行上面的“最新 5 篇 Bernstein 报告”验证问题。实际调用目录工具后，返回日期、标题、作者。
4. 报告配置和登录各自的结果。若当前任务无法动态加载工具，只能报告“配置已保存／登录已完成，工具调用待新任务验证”，不能冒充已测试。

### 常见情况

- **首次改密**：至少 12 位；四种客户端共用同一资料库密码。
- **换电脑**：在新电脑重新执行本手册、登录即可，本地授权凭证通常不会自动同步。
- **以前连接过 Research Library**：新建 `signalbase` 即可；先保留旧连接，查询时明确只使用 SignalBase。
- **回调端口占用**：Codex 使用 8767，Claude Code 使用 8768。报告占用情况，不结束未知进程、不随便换端口。
- **网页登录要求重新登录**：重新授权即可，不必删除并重建整个配置。会话闲置和总时长上限目前都是 12 小时，访问令牌短期自动续期。
- **连接失败**：提供客户端版本、时间和报错文字给管理员；不要附带密码、令牌或含授权码的回调链接。

## 官方参考

- [Codex MCP](https://developers.openai.com/codex/mcp)
- [Claude Code MCP](https://code.claude.com/docs/en/mcp)

手册日期：2026-09-14。配置以本文件的 SignalBase 地址和客户端参数为准。