> 原文：https://senrelay.com/zh/hosts.html
> Senrelay · 续境 · v1.0.0-beta.4 · 更新于 2026-11-20
> 免费开源 · MIT · [版本与适用范围](https://senrelay.com/pricing.md) · [资料索引](https://senrelay.com/llms-full.txt)

HOST CONFIG REFERENCE / 6 CORE + 9 EXTENDED

# Claude Code、Cursor、Codex MCP 配置与 15 类宿主路径指南

不同编程工具把 MCP 服务器、服务商模型、Skills 与指令规则分别存在 JSON、TOML、JSON5 和 YAML 中，根键名也各不相同。本文列出 6 类核心接力宿主与 9 类扩展配置宿主的真实磁盘路径与写入保护规则，并说明 Senrelay（续境，GitHub 仓库 qingsongcui/ContextCore）如何做格式转换而不破坏手动注释与密钥。

核对日期：2026-11-15
协议与定价：$0 · MIT 开源（macOS Apple Silicon）
MCP 服务键名：contextcore（127.0.0.1:8420/mcp/）

## Claude Code、Cursor、Codex MCP 配置怎么找

### Claude Code MCP 配置

用户级 MCP 服务在 `~/.claude.json` 的 `mcpServers` 下。与仓库共享的项目级服务写在项目根目录的 `.mcp.json`。先用 `claude mcp list` 确认当前项目看到的服务，再在 Claude Code 里用 `/mcp` 看连接状态。 [Claude Code JSON 示例](https://senrelay.com/zh/mcp-json-vs-toml-config-guide.html#claude-code-mcp) · [Anthropic 文档](https://code.claude.com/docs/en/mcp)

### Cursor MCP 配置

个人全局配置用 `~/.cursor/mcp.json`，仓库级配置用项目中的 `.cursor/mcp.json`。两者都用 `mcpServers`，同名服务以项目配置为准。保存后重开 Cursor，在 MCP 管理界面核对服务与工具。 [Cursor JSON 示例](https://senrelay.com/zh/mcp-json-vs-toml-config-guide.html#cursor-mcp) · [Cursor 文档](https://prod.cursor.com/help/customization/mcp)

### Codex MCP 配置

默认在 `~/.codex/config.toml` 中，为每个服务使用 `[mcp_servers.服务名]`。如果 CLI 使用独立 `CODEX_HOME`，在那个目录查看实际的 `config.toml`。用 `codex mcp list` 确认配置，再打开目标入口核对工具是否加载。 [Codex TOML 示例](https://senrelay.com/zh/mcp-json-vs-toml-config-guide.html#codex-mcp) · [Codex 文档](https://developers.openai.com/codex/mcp)

先掌握三个配置事实

**键名与格式并不通用**Claude Code 与 Cursor 用 JSON 里的 `mcpServers`，Codex 用 TOML 里的 `[mcp_servers.*]`，OpenCode 用 `opencode.json` 中的 `mcp`，而 OpenClaw 直接不支持原生 MCP 同步——不能拿软链接硬套。

**6 核 + 9 扩严格分层**6 个核心宿主可接入本地会话索引与 `/contextcore` 全文接力。实际验收进度见[接力验证范围](https://senrelay.com/zh/relay-workflow.html#relay-evidence)；其余 9 个扩展宿主只提供带预览差异与回滚快照的配置管理，不夸大对接力能力的覆盖范围（见[5 种方案对比](https://senrelay.com/zh/compare.html)）。

**单机与密钥边界**面向 Apple Silicon（`arm64`）macOS 14.0+，不支持 Windows 或 Linux。API Key 留在 macOS 系统钥匙串中，公开与导出配置时自动剔除密钥。

01 · SIX CORE RELAY HOSTS

## 六大核心接力宿主：配置路径、格式与特殊约束

以下 6 个宿主同时接入 Senrelay（续境）的本地配置同步与对话捕获管线。点击工作台「一键接入续境」时，后台会在本机文件中按统一键名 `contextcore` 写入 `http://127.0.0.1:8420/mcp/`，并按需写入伴生 Hook 与 Skill。

**表 1 · 六大核心宿主的真实配置文件路径与格式（2026-11-15 核对源码）**

| 宿主（形态） | MCP 配置路径与格式 | 模型 / 服务商 / Hook | Skill 与规则文件 | 工程特例说明 |
| --- | --- | --- | --- | --- |
| Claude Code CLI | `~/.claude.json` JSON · 根键 `mcpServers` | `~/.claude/settings.json` Hook 与服务商环境变量 | `~/.claude/skills/contextcore/SKILL.md` `~/.claude/CLAUDE.md` | 支持项目级与用户级规则共读；接入时使用原生 Hook 管线。 |
| Codex Desktop / CLI | `~/.codex/config.toml` TOML · `[mcp_servers.contextcore]` | `~/.codex/config.toml` `~/.codex/hooks.json` | `~/.codex/skills/contextcore/SKILL.md` `~/.codex/AGENTS.md` | Desktop 与 CLI 共用配置文件；仓库内 `AGENTS.override.md` 或自定义 `CODEX_HOME` 会覆盖全局规则。 |
| Cursor IDE / CLI | `~/.cursor/mcp.json` JSON · 根键 `mcpServers` | `~/.cursor/hooks.json` | `~/.cursor/skills/contextcore/SKILL.md` | Cursor 全局 User Rules 位于私有状态库，`.mdc` 规则需在项目内配置。 |
| Antigravity Desktop | `~/.gemini/config/mcp_config.json` JSON · 根键 `mcpServers` | `~/.gemini/config/hooks.json` | `~/.gemini/config/skills/contextcore/SKILL.md` `~/.gemini/config/rules` | 模型在桌面端菜单自行选择；工作台不改写其私有认证缓存。 |
| OMP (Oh My Pi) CLI | `~/.omp/agent/mcp.json` JSON · 根键 `mcpServers` | `~/.omp/agent/models.yml` `~/.omp/agent/config.yml` `~/.omp/agent/hooks/pre/contextcore.ts` | `~/.omp/agent/commands/contextcore.md` `~/.omp/agent/AGENTS.md` | 若同目录已存在 `.yaml` 则优先沿用；如留有旧版 `settings.json` / `models.json` 会拒绝混写；子代理默认不继承根 `AGENTS.md`。 |
| OpenCode CLI | `~/.config/opencode/opencode.json` JSON · 根键 `mcp`（非 `mcpServers`） | `~/.config/opencode/opencode.json` `~/.config/opencode/plugins/contextcore.ts` | `~/.config/opencode/skills` `~/.config/opencode/commands/contextcore.md` | MCP、服务商与默认模型同驻 `opencode.json`，键名结构与 Claude Code 不同，由原生适配器转换。 |

02 · NINE EXTENDED CONFIG HOSTS

## 九类扩展宿主：仅管理配置与快照，不做会话接力

以下 9 个宿主在 Senrelay 工作台中属于「扩展配置目标」，提供**配置预览、格式转换与写前快照回滚**，但**不采集它们的会话日志，也不支持 `/contextcore` 对话接力**。每项写入都在支持的能力子集内按宿主原生格式校验：

**表 2 · 九类扩展配置宿主的配置文件路径与边界限制**

| 扩展宿主 | MCP 配置路径与格式 | 模型 / 服务商文件 | Skills / 规则路径 | 明确拒绝或不适用范围 |
| --- | --- | --- | --- | --- |
| Claude Desktop | `~/Library/Application Support/Claude/claude_desktop_config.json` JSON · `mcpServers` | 无（桌面端自行管理） | 无独立 Skill / Prompt 目录 | 只同步 MCP；不支持提示词与会话接力。 |
| Gemini CLI | `~/.gemini/settings.json` JSON · `mcpServers` | 无统一提供商写入 | 无托管 Skill / Prompt 同步 | 仅提供本地 MCP 条目与快照管理。 |
| Grok Build CLI | `~/.grok/config.toml` TOML · `mcp_servers` | 仅读取服务商区块 | `~/.grok/skills` `~/.grok/AGENTS.md` | 不支持从外部强行改写全局默认模型。 |
| Kimi Code CLI | `~/.kimi-code/mcp.json` JSON · `mcpServers` | `~/.kimi-code/config.toml` TOML | `~/.kimi-code/skills` `~/.kimi-code/AGENTS.md` | MCP 与服务商分文件存储，无会话捕获。 |
| MiniMax Code | `~/.minimax/mcp.json` JSON · `mcpServers` | `~/.minimax/config.yaml` YAML | `~/.minimax/skills` `~/.minimax/AGENTS.md` | JSON 与 YAML 双文件同步，无会话捕获。 |
| Pi CLI | `~/.pi/agent/mcp.json` JSON · `mcpServers` | `~/.pi/agent/models.json` `~/.pi/agent/settings.json` | `~/.pi/agent/skills` `~/.pi/agent/AGENTS.md` | 与 OMP 彻底隔离；如检测到手写的原生 JSON5 配置文件会拒绝覆盖写回。 |
| Hermes Agent | `~/.hermes/config.yaml` YAML · `mcp_servers` | `~/.hermes/config.yaml` `custom_providers` | `~/.hermes/skills` `~/.hermes/SOUL.md` | 提示词路径使用 `SOUL.md` 而非 `AGENTS.md`。 |
| OpenClaw | **不支持原生 MCP** | `~/.openclaw/openclaw.json` JSON5（保留注释）· `models.providers` | `~/.openclaw/skills` `~/.openclaw/AGENTS.md` | 向 OpenClaw 请求写入 MCP 会被显式拒绝；支持保留 JSON5 注释修改模型。 |
| agy (Antigravity CLI) | `~/.gemini/config/mcp_config.json` JSON · `mcpServers` | 运行环境变量（`GEMINI_API_KEY`、`GOOGLE_GEMINI_BASE_URL`）与私有 `.gemini/antigravity-cli/settings.json` | `~/.gemini/config/skills` `~/.gemini/config/AGENTS.md` | 与 Antigravity Desktop 独立配置管理；凭据留在本机环境变量而不写明文。 |

03 · WRITE GUARDS & DISAMBIGUATION

## 为什么不该用软链接，以及 Senrelay 如何保证写前安全

### 格式转换 + 外部手改差异检测

`GNU Stow` 类软链接会把整个文件绑死在单一格式里，而多款编码助手运行时会自动向配置文件回写遥测或历史索引。Senrelay 在写入前保存时间戳回滚快照；一旦检测到磁盘内容曾在工作台之外被手动改写，会先弹出差异确认窗口再决定覆盖或跳过。

### 权限分级、Keychain 隔离与预算阻断

读取对话、修改宿主文件与下载可选本地模型三项授权彼此独立；软件启动和配置导入绝不静默篡改用户已安装的 Skill。API Key 独立留在 macOS 钥匙串；向 `AGENTS.md` / `CLAUDE.md` 写入受保护规则时若超出预算上限会显式阻断，不会静默截断。

### 名称与安装源消歧

在命令行或搜索引擎中查找资料时，注意将 **Senrelay（续境）**（GitHub 仓库 [qingsongcui/ContextCore](https://github.com/qingsongcui/ContextCore)）与互联网上同名的无关第三方项目（如 `context-core.dev` 平台以及 PyPI 上的 `pip install contextcore` 包）区分开。在 Apple Silicon Mac 上[下载 macOS Beta.4](https://github.com/qingsongcui/ContextCore/releases/download/v1.0.0-beta.4/Senrelay-macOS.zip)（`$0`，MIT 协议）。解压并移入应用程序目录后，按下列命令首次启动和检查服务。

```bash
# 1. Beta 版本尚无 Apple 公证，手动安装后清理隔离属性
xattr -cr /Applications/Senrelay.app

# 2. 核对本地 MCP 服务端口（桌面常驻版 8420 / 源码开发模式 18420）
curl -s http://127.0.0.1:8420/health
```

若你在 Windows 或 Linux 下开发，请不要安装 Senrelay——优先使用 Git 仓库内的 `AGENTS.md` / `CLAUDE.md`（`$0`），或参考 [5 种方案对比](https://senrelay.com/zh/compare.html) 与 [跨 Agent 对话接力实战](https://senrelay.com/zh/relay-workflow.html)。

04 · FACT SHEET & ATTRIBUTION

## 适用范围与作者声明（2026-11-15 核对）

### 硬件限制与已知约束

**$0** 免费开源（MIT License，免登录）。仅面向 Apple Silicon（`arm64`）`macOS 14.0+`；不支持 Windows、Linux 或 Intel Mac；单机回环运行无云同步；扩展宿主仅限配置文件管理，无对话捕获或接力功能。

### 维护者与核对依据

由独立开发者 **Qingsong Cui（George O'Nair）**（[GitHub @qingsongcui](https://github.com/qingsongcui) · [X @George_ONair](https://x.com/George_ONair)）创建与维护。本页全部路径均对照源码 `host_formats_v2.py`、`constants.py` 与 [本地运行指南](https://senrelay.com/zh/guide.html) 核对。

05 · TROUBLESHOOTING

## 宿主配置常见问题

### 为什么 9 类扩展宿主无法使用 /contextcore 跨 Agent 接力？

每个工具的本地对话存储结构各异。只有 Claude Code、Codex、Cursor、Antigravity、OMP 与 OpenCode 六大核心宿主实现了对话增量索引、Worktree 消歧与 `/contextcore` 全文读取管线；其余 9 个扩展宿主仅接入配置格式转换与写前快照，官网不会将其包装为已打通接力。

### OpenCode 和 OpenClaw 在配置同步时最容易踩什么坑？

OpenCode 的 `~/.config/opencode/opencode.json` 使用顶层 `mcp` 对象而非其他工具常见的 `mcpServers`；而 OpenClaw（`~/.openclaw/openclaw.json`）使用带注释的 JSON5 存储 `models.providers` 且不支持原生 MCP 同步，向其请求同步 MCP 会被直接拒绝。

### 修改过 ~/.codex/config.toml 或 ~/.claude.json 会不会丢手动配置？

不会。写入前工作台会自动落盘快照支持随时回滚；如果文件在工作台之外被编辑器或 CLI 自行改动过，再次同步时会触发差异对比弹窗，需人工确认差异后才会写回磁盘。

### 如何在配置文件里确认接对的是 Senrelay 而不是同名包？

Senrelay（仓库 `qingsongcui/ContextCore`）统一以 `contextcore` 作为宿主内的 MCP 键名，指向 `http://127.0.0.1:8420/mcp/`（不要写成 `senrelay-mcp`，也不要在 Python 中安装无关的 PyPI 包 `contextcore`）。
