# MCP 单一服务器化

将组级挂载的 `lian-jing-{group_id}`（每产品组一个 MCP 服务器）收敛为单一全局 `lian-jing` 服务器。

## 为什么

- **摩擦随项目数复利增长，与飞轮方向相反**：当前每新增一个产品组 = 多一次 `claude mcp add` + 多一个授权单元 + 每个会话多一份重复工具清单（现状 12 个组 × 28 工具 ≈ 300+ 工具注册）。炼境的目标是"管理项目越多 → agent 辅助越强"，客户端配置成本必须是 O(1)。
- **组级挂载没有真正的隔离价值**：2026-07-06 实测，任意组的服务器可对任意项目执行 `inject_mcp`（工具全部显式传 `project_id`），组这一层只是命名空间，不是权限边界。
- **消除 group_id 身份卡的存在必要**：单一服务器后 `liangjing.json` 只需 `project_id`，group_id 缺失/过期/移组同步这一整类问题从根上消失（而非修复）。

## 改造范围（侦察结论，待 /architect 细化）

- `mcp_server.rs`：`/mcp/group/{group_id}` 路由 → 新增全局 `/mcp` 路由；旧路由保留一段过渡期
- `mcp_tools.rs`：工具已全部显式传 `project_id`，改动小；`list_group_projects` 等组上下文工具改为显式传参或从 project 反查 `project_group_map`
- `mcp_inject.rs`：settings.json 注入条目 + `claude mcp add` 收敛为单个 `lian-jing`；`liangjing.json` 去掉 group_id 依赖
- **存量迁移**：清理 ~/.claude.json 中 12 个旧 `lian-jing-*` 注册；已注入项目 settings.json 批量刷新（复用 `reinject_all_mcp` 机制）
- 接入包模板 / `docs/ai-context/git-workflow.md` 中 `lian-jing-{group_id}` 引用同步改
- 用户全局 `~/.claude/CLAUDE.md` 炼境按钮规则段（引用 `lian-jing-{group_id}`）需同步

## 风险

- 迁移期新旧服务器并存，agent 可能困惑——需设计干净的切换顺序（先加新、批量迁移、后删旧）
- webhook 回调路径是否含 group_id 待核实（`mcp_webhook.rs`）
- 状态：concept，L 级——禁止直接写代码，先 `/architect` 输出设计文档，用户确认后 `/splitter` 拆 S/M 卡

## 任务卡

（待 /architect 设计确认后由 /splitter 生成）