HOST CONFIG REFERENCE / 6 CORE + 9 EXTENDED

15 个 AI 编程助手的 MCP、Skills 与规则文件路径指南

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

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

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

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

不同编程工具把 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 用 JSON 里的 mcpServers，Codex 用 TOML 里的 [mcp_servers.*]，OpenCode 用 opencode.json 中的 mcp，而 OpenClaw 直接不支持原生 MCP 同步——不能拿软链接硬套。

6 核 + 9 扩严格分层6 个核心宿主具备本地会话捕获与 /contextcore 全文接力；其余 9 个扩展宿主只提供带预览差异与回滚快照的配置管理，不夸大对接力能力的覆盖范围（见5 种方案对比）。

单机与密钥边界面向 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）与互联网上同名的无关第三方项目（如 context-core.dev 平台以及 PyPI 上的 pip install contextcore 包）区分开。在 Apple Silicon macOS 上应使用 Homebrew 安装或前往 GitHub Releases 获取 v1.0.0-beta.2（定价 $0，MIT 协议），首次启动后在终端清理一次隔离属性：

# 1. 通过 Homebrew 安装（Apple Silicon macOS 14.0+）
brew install --cask qingsongcui/tap/senrelay

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

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

若你在 Windows 或 Linux 下开发，请不要安装 Senrelay——优先使用 Git 仓库内的 AGENTS.md / CLAUDE.md（$0），或参考 5 种方案对比与跨 Agent 对话接力实战。

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 · X @George_ONair）创建与维护。本页全部路径均对照源码 host_formats_v2.py、constants.py 与本地运行指南核对。

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）。