让外部 AI 接入 AICoder
你的 AI 编程历史 —— 会话记录、代码片段、Token 用量、API 配置、项目记忆 —— 全都沉淀在 AICoder 里。
能不能让 Claude Code、Cursor 这些 AI 工具反过来读取这些数据，把 AICoder 当成它们的「上下文中心」？
AICoder 内置了一个 MCP 服务，一键接入主流 AI 客户端，让它们直接查询你在 AICoder 里积累的一切。
一键接入 10 家 AI 客户端
设置 → MCP 接入，为以下客户端一键写入配置（再次点击即可取消）：
| 客户端 | 接入位置 |
|---|---|
| Claude Code | 用户级 / 项目级 MCP 配置 |
| Codex | ~/.codex/config.toml |
| Cursor / Cline / Zed / OpenCode | 各自的 MCP 配置文件 |
| Grok / Kimi Code / CodeBuddy | 各自的 MCP 配置文件 |
| Pi | Pi 本身不带 MCP，接入时装一个桥接扩展 |
接入后，这些工具的 AI 在对话里提到「我之前那个会话」「上周 Token 花了多少」时，会自动向 AICoder 取数据，无需你手动翻找。
Claude Code 和 Codex 的卡片上还有「写规则」：写入后 AI 才知道什么时候该用智码的工具（网页走内置浏览器、找历史先查索引再读详情等），规则有更新时按钮显示为「写规则 ●」。Cursor 的卡片是「规则」，复制后粘到项目根目录的 AGENTS.md。「一键接入 AI 客户端」标题旁的问号可查看接入后可用的完整能力清单。
接入体检
「已接入」不等于「连得上」：配置还在，但可能早就用不了了。每家客户端的卡片都会做接入体检 —— 配置在但连不上时，不再显示绿色的「已接入」，而是黄色的「需重新接入」，下方逐条写出问题和该怎么办，旁边直接有「重新接入」按钮，不用先取消再接入。
| 常见问题 | 多半是因为 |
|---|---|
| 配置指向的程序不存在 | 重装过智码或换过安装目录 |
| 指向的不是当前这个实例 | 旧安装路径残留、开发版和正式版混用，或是别的多开实例 |
| 端口对不上 | 约定端口被别的程序占了，智码换了端口 |
| 令牌缺失或已失效 | 取消过接入、换过数据库，或是别的实例发的令牌 |
测试连接
设置 → MCP 接入最上方的「端点状态」显示智码 MCP 服务此刻的情况，后台每 60 秒自检一次：
| 显示 | 含义 |
|---|---|
| 端点在服务 | 正常 |
| 在服务 · 重绑 N 次 | 正常，但启动以来自动恢复过几次 |
| 回环不通 · 连续 N 次 | 服务在跑，但自检连续失败，外部客户端此刻多半连不上 |
| 端点未服务 | 服务当前没起来，智码正在自动重试 |
点旁边的「测试连接」做一次完整自检。它模拟外部客户端真的连进来走一遍，而不是只在程序内部问一声「在不在」：
| 检查什么 | 说明 |
|---|---|
| 服务在不在 | 没在服务时后面各项直接跳过 |
| 没带令牌的请求会不会被拒 | 证明门是真的锁着 |
| 两种接入方式都走得通 | 各自完整走一遍真实调用 |
| 连接信息和当前是否一致 | 不一致会自动按当前情况改正 |
结果逐项打勾 / 打叉并给出耗时；下方列出最近有哪些客户端调用过、24 小时内调用了多少次；还会顺手清理已关闭的多开实例留下的旧连接信息。
Claude Code 默认的接入方式与断线自愈
「一键接入 AI 客户端」右上角的「Claude Code 用 HTTP 通道」开关默认打开：Claude Code 直接连智码，断线后会自动重连，不用你手动敲 /mcp。关掉则改用另一种方式（多起一个转发程序），那个程序万一被关掉，这个会话里智码的工具会全部下线，而且不会自动恢复。
只有一种情况建议关掉：约定端口被别的程序占用、智码换了端口时，开着的方式会连不上（体检会提示端口对不上），另一种方式能自己找到新端口。开关开着但智码服务还没就绪时，会自动改用另一种方式，界面上写明当前实际生效的是哪种。其余客户端目前都走另一种方式。
不管哪种方式，智码主程序没运行时工具都用不了。主程序重启期间，AI 的调用会等它重新起来（最多约 40 秒），不会叫 AI 停下来让你手动重连。
开发版与多开实例
| 情况 | 说明 |
|---|---|
| 正式版与开发版 | 写进客户端配置的名字不同（正式版 aicoder、开发版 aicoder-dev），可以同时接在同一个 Claude Code 上，互不覆盖 |
| 多开实例 | Claude Code 和 Codex 的接入写在各实例自己的配置目录里：在哪个实例里点接入，就连到哪个实例 |
早期版本里，开发版 / 多开实例的接入每次启动会被主实例那份覆盖，v6.0.3 起已修复。如果卡片显示「需重新接入」，或体检提示指向的不是当前实例，到对应实例的设置 → MCP 接入里点一次「重新接入」即可。多开的用法见多账号隔离。
AI 能读取什么
接入后，外部 AI 可调用以下能力（大多只读，安全）：
| 类别 | 能力 |
|---|---|
| 会话 | 列出最近项目 / 会话，读取某次会话的完整对话正文，全文搜索历史会话，一键在 AICoder 主窗口打开会话 |
| 代码片段 | 列出 / 读取你保存的片段，也能让 AI 帮你存新片段 |
| Token 用量 | 查询 Token 统计与费用 Dashboard 摘要 |
| API 配置 | 列出配置档案（只返回名称 / 模型 / 地址，绝不含密钥），按需切换档案 |
| 项目记忆 | 读取 / 追加项目记忆条目 |
AI 还能指挥其它会话
除了读数据，接入的 AI 还能新开会话、派活、追加指令、等待结果 —— 这组能力让一个会话可以当「总控」，指挥其它会话分头干活并验收裁决。
| 工具 | 作用 |
|---|---|
start_agent_session | 新开一个会话并派活，返回会话 id |
send_to_session | 往已在跑的会话追加指令（驳回返工走这条） |
watch_session | 登记「被盯的会话跑完就叫醒我」，等待期间零消耗 |
get_session_status | 查一批会话此刻在干什么 |
control_session | 对停下来的会话直接按菜单键、发「继续」、打断或重启 |
handoff_session | 把派出去的会话交给你接手，或收回 |
这几个是改动型能力（会真的开 Tab 启动 CLI 并自动执行），完整用法见多 Agent 协同编排。
AI 能启动和重启项目任务
接入后，AI 可以直接用智码的任务系统把项目跑起来（在侧边栏的任务里运行），而不是自己在命令行里另起一份：
| 能力 | 说明 |
|---|---|
| 看有哪些任务 | 列出项目已登记的任务（前端、后端、构建等）和运行状态；还没登记过就扫描项目，推断可启动的命令候选 |
| 启动 | 按意图（如「启动后端」）匹配任务，唯一就直接启动，有多个或一个都没有时交给你选；在后台开任务标签，不会把你从当前标签拽走。已经在跑的不会重启，同一条命令或同一端口的不会重复建 |
| 重启并等它起好 | 停掉后按原命令重新拉起，端口不变，并等到服务真正起来才返回：已就绪 / 还在编译 / 命令已退出，附错误行和日志末尾 |
| 查状态 | 只看一眼，或一直等到就绪、命令结束或超时 |
| 停止 | 停掉任务并关掉它的标签 |
过时的任务可以原地换成新命令；命令引用的脚本已经不存在的坏任务会被认出来，不会去启动它。
典型用法：编排里改完后端代码，让子会话重启任务、等服务起好再测，不用自己另起进程、撞了端口再改端口。编排子会话为验收单独起的服务算临时任务，停掉后自动从列表移除，见多 Agent 协同编排。
AI 能自己重连断开的 MCP
Claude Code 用的本地 MCP 进程退出后，它不会自己重新拉起，工具会悄悄消失。接入智码后，AI 发现某个工具不见了或报连接已断，可以调 reconnect_mcp 让智码代为重连（默认重连它自己所在的会话）：
- 等这一轮答完、会话空闲才执行，避免打断正在进行的工具调用
- 重连完成后自动发一条消息叫醒它，接着干活
- 只适用于 Claude Code
也可以手动重连，或让智码在掉线时自动重连，见 MCP Server 管理。
快捷命令
在接入的客户端里手动输入斜杠命令，触发预设工作流：
| 命令 | 作用 |
|---|---|
/mcp__aicoder__resume-last | 接着上次的会话继续 |
/mcp__aicoder__cost-this-week | 本周 Token 花费 |
/mcp__aicoder__find-snippet | 查找代码片段 |
/mcp__aicoder__project-summary | 当前项目概况 |
/mcp__aicoder__recall-experience | 检索过往经验 |
/mcp__aicoder__distill-experience | 把某项目的历史会话提炼成项目记忆 |
/mcp__aicoder__switch-profile | 按名字切换 API 配置档案 |
/mcp__aicoder__spawn-agents | 拆解任务清单，并行开多个自主会话（副作用大，确认后才开） |
命令格式为 /mcp__aicoder__<名称>，只在你手动输入时触发，日常对话不会自动调用 —— Token 完全可控。
AICoder 助手
侧边栏的 入口一键打开「AICoder 助手」—— 一个预先接好 AICoder 数据、专门帮你管理和回顾 AI 编程历史的 Claude 会话。
问它「我这周在忙什么」「帮我找上次写的那个脚本」，它会直接查你的真实数据来回答。
安全设计
- 本地回环 — MCP 服务只监听本机
127.0.0.1，不对外网开放 - 不泄露密钥 — 任何接口都不返回 API Key / Token 等凭据字段
- 以只读为主 — 绝大多数能力是查询；少数写入（存片段、加记忆、切档案）有明确边界
- 每次调用留痕 — 所有调用记入本地审计日志
- 按作用域授权 — 一键接入时生成独立令牌，可限定外部 AI 只能访问指定的工作区
- 远程会话受限使用 — 远程主机上的 Claude Code 会话开起来时会自动经 SSH 加密通道接上这些工具，但只能访问该工作区的数据，不能读写本机其它项目、也不能在本机启动任务或新会话
两个方向别搞混
本页讲的是让外部 AI 读取 AICoder 的数据（AICoder 作为数据源）。如果你想反过来给 Claude Code 等工具配置它们要用的 MCP 服务器，那是 MCP Server 管理。