Reasonix Code 手动注册 CodeGraph MCP卡人的往往不是codegraph serve --mcp这句命令而是顺序CodeGraph 不在自动配置列表里得手动add_mcp_server工具挂上之后TaoToken 提供的模型通道还得先通。注册和建 Key 都放在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 上完成接口侧填进工具的 Base URL 用 https://taotoken.net/api末尾不带/v1。这篇按手动注册 MCP 条目、补模型通道、用 trace 验证、排障、对账这条线走一遍把容易混的官网地址和接口地址分开写清楚避免把给人点的落地页塞进工具的 API 配置里。原文给出的路径是Reasonix 不在 CodeGraph 安装器的自动配置名单中需要手动add_mcp_server配置namecodegraph、transportstdio、commandcodegraph、args[serve, --mcp]重启后用codegraph_codegraph_status验证索引状态。这一段本身不难难在工具注册好之后Reasonix 里还得有一条可用的模型通道Agent 才能去调codegraph_context、codegraph_trace、codegraph_explore去追changeSyncProduct到sendNonPendingActivityProductSyncMessage这类链路。下面就从这里接着往下写。1. CodeGraph 装完了Reasonix 的工具列表里为什么还是空的1.1 不在自动配置列表里是安装器没覆盖到这个客户端CodeGraph 安装器一般会探测一批常见的 MCP 客户端帮你在对应配置文件里写好条目。但 Reasonix Code 不在它的探测范围内脚本跑完不会替你做这一步。表现很直观终端里codegraph命令能跑Reasonix Code 的工具列表里却一个codegraph_开头的工具都看不到。这不是版本装漏了也不是权限问题而是这个客户端的注册路径需要你手动接上。先排除 CLI 侧的问题。开一个终端确认命令本身没问题codegraph --version codegraph serve --mcp第二条会挂住等你输入这是正常现象它在标准输入上等 MCP 握手。按 CtrlC 退出就行。能跑到这一步说明可执行文件和子命令都没问题缺的只是 Reasonix 侧的注册条目。如果codegraph --version就报 command not found先回到 CodeGraph 官方安装文档把 CLI 装好别急着往下改配置否则后面command字段再怎么调都拉不起来。1.2 手动注册之前先分清 CodeGraph 和模型各管什么这件事建议在动手前想清楚。CodeGraph 负责的是本地侧扫源码、在仓库根下建一份本地 SQLite 图谱、把结构化结果通过codegraph_context、codegraph_trace、codegraph_explore这些工具返回。它不做推理也不负责把调用链讲成人话。把changeSyncProduct到sendNonPendingActivityProductSyncMessage中间的节点串起来、判断哪一层做了过滤、给出下一步去看哪个文件这些是模型干的活。分工清楚了操作顺序也就清楚了第一步注册 MCP让工具能被列出和调用第二步配模型通道让 Agent 有脑子去挑工具、读结果。只做第一步会出现工具能看到、Agent 不动的尴尬只做第二步会有模型但没有任何本地图谱可查。两块都通才算真的能用。2. 手动 add_mcp_servercodegraph、stdio、serve --mcp 怎么落到 Reasonix2.1 command 填 codegraph 之前先确认子进程能找到它因为transport用的是 stdioReasonix Code 启动时会 fork 一个子进程用command加args把它拉起来双方通过标准输入输出交换 JSON-RPC 消息不开端口也不涉及网络监听。这意味着command必须是子进程环境里能解析到的东西。问题常出在这里你在终端里codegraph好使是因为 shell 的 PATH 里有 nvm、asdf 或自定义 bin 目录GUI 客户端继承的 PATH 往往更干净找不到那个可执行文件。报错通常长这样spawn codegraph ENOENT或者子进程瞬间退出、工具调用超时。判断方法很简单先在终端跑which codegraph把完整路径拿到然后command直接写这个绝对路径。2.2 四个字段一个都不能少原文给的四项落到配置里是下面这样字段值作用namecodegraph工具名前缀决定工具名是codegraph_codegraph_status而不是别的transportstdio走标准输入输出不开端口commandcodegraph被 Reasonix 拉起的可执行文件args[serve, --mcp]让 codegraph 以 MCP 模式启动服务按字段对照写出来大致是{ name: codegraph, transport: stdio, command: codegraph, args: [serve, --mcp] }具体是写进配置文件还是填在 MCP 管理界面的表单里按你手上 Reasonix Code 版本的入口来字段名保持这四个。args的顺序也别调换serve在前、--mcp在后前一个是子命令后一个是模式开关。name这一项如果改了工具名的前缀也会跟着变后面排查的时候记得对一下。2.3 重启之后先看 codegraph_codegraph_status别急着 trace保存配置重启 Reasonix Code。打开工具列表应该能看到codegraph_codegraph_status、codegraph_context、codegraph_trace、codegraph_explore这几个。接下来第一件事是调codegraph_codegraph_status不要直接上 trace。status 的返回值里重点看三样扫描到的文件数、抽取出的符号数、最近一次建图时间。如果文件数是 0 或者明显偏少说明这个仓库还没建过图或者建图只覆盖了一部分。trace 结果完全依赖索引索引是空的时候返回的链路也是空的你会误以为是 MCP 没配好。先把建图跑完再回头看状态是否有变化。3. MCP 挂上了模型通道还是空的Key 和 Base URL 怎么填3.1 先到 TaoToken 创建 Key顺手记下模型 ID工具列表没问题之后回到 Reasonix Code 的模型侧。打开 TaoToken 注册登录进控制台创建一把 API Key复制出来放好本文后面统一用YOUR_API_KEY代替。同一处的模型广场可以看你账号当前可用的模型 ID 有哪些把准备用的那个记下来。别凭印象写模型名。模型列表会变写一个当前不存在或者名字拼错的 ID表现通常不是干脆的报错而是请求发出去回不来排查起来反而绕。以模型广场当时列表为准是最省事的方式。3.2 Base URL 填 https://taotoken.net/api末尾不要带 /v1回到 Reasonix Code 的模型 / API 配置需要填三项配置项值Base URL / API Endpointhttps://taotoken.net/apiAPI KeyYOUR_API_KEY模型 ID以模型广场当时列表为准有两个错法要提前避开。第一个是把 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 填进 Base URL那是给人点的落地页不是接口地址客户端拿它拼请求路径多半会收到 HTML 或者 404。第二个是在 https://taotoken.net/api 后面又补一段/v1这里的 Base URL 末尾不带/v1客户端自己会拼后面的路径多写一层通常会变成 404。Key 从 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 控制台创建粘贴的时候注意别把两端空格带进去这类肉眼看不出的问题最耗时间。3.3 保存后先发一条普通对话确认通道本身是通的不要一上来就拿 trace 试。先在 Reasonix Code 里发一条不涉及工具调用的普通问题比如让它解释一段你贴进去的函数。有正常回复说明 Key、Base URL、模型 ID 这三项都对上了。没回复再回去查这三项比对着工具调用日志猜要快得多。这一步过了再回去碰codegraph_*系列。把通道验证和工具验证分开出问题的时候能立刻判断是哪一侧的事不至于两边一起改。4. 跑一次 codegraph_trace同时验证工具侧和模型侧4.1 三个 codegraph 工具各自解决什么问题codegraph_context给一个符号或文件名返回它的定义位置、所属文件、相关引用适合先了解一个点。codegraph_trace给起点和终点返回调用链上的中间节点适合追一条已知方向但不知道经过谁的路径。codegraph_explore围绕某个模块或符号做邻域探索适合还没想好具体要找什么的时候。原文提到的例子是changeSyncProduct到sendNonPendingActivityProductSyncMessage。从一个业务入口一路走到某个非待处理活动商品同步消息的发送中间大概率隔了几层封装和条件判断这种场景用 trace 最合适用 context 会只看到起点周围看不到全貌。4.2 一次 trace 要同时看两样返回在对话里让 Agent 调codegraph_trace起点写changeSyncProduct终点写sendNonPendingActivityProductSyncMessage。重点看两个层次。第一层是工具返回。正常情况下应该是一串中间节点每个节点带文件位置和符号名能看出从入口到目标经过了哪些方法。如果返回空数组或者只给了起点和终点、中间是断的那多半是索引没覆盖到这条链路回第 2.3 节重新确认建图状态。第二层是模型层。工具返回之后模型要把这串节点组织成一段说明指出关键跳转在哪、哪一层做了过滤、哪个文件值得展开看。如果只看到工具原始返回、对话里没有任何解释或者直接提示模型请求失败那就是通道侧还没通回第三章检查。两层都过这次 MCP 注册才算是真的完成。只看工具返回就下结论很容易在真正用的时候才发现 Agent 讲不出东西。4.3 .codegraph/ 是本地产物加进 .gitignore建图之后仓库根目录会多出一个.codegraph/里面是本地 SQLite 和其他中间产物。它会随仓库规模增长而且换个人重建就行没有进版本库的必要。在.gitignore里加一行.codegraph/团队里如果每个人都建自己的索引各建各的别把索引提交上去互相覆盖。索引文件冲突解决起来很麻烦而且没有意义。5. 排障MCP 在但 trace 不返回或者解释不出来5.1 工具列出来但一调就失败现象是codegraph_codegraph_status出现在了工具列表但一点开就报 spawn 失败或者 ENOENT。原因基本只有一个command用的codegraph不在子进程的 PATH 里。解决办法就是第 2.1 节说的换成绝对路径。改完重启客户端再试。5.2 对话报 401 或 404401 一般是 Key 的问题没填、填错、复制时带了空格或者用的是别处生成的 Key。回 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 控制台重新建一把粘贴时注意首尾。404 一般是 Base URL 的问题末尾多了/v1或者把官网落地页填进了接口地址。确认线上填的是 https://taotoken.net/api不带/v1也不带任何查询参数。模型名报不存在则是 ID 写错了回模型广场对一遍。这三种是最常见的。其他错误码先看 Reasonix Code 的请求日志确认请求实际发到了哪个地址再判断。5.3 索引过期仓库改了很多trace 还停在老结构如果最近重构过目录、批量改过类名而codegraph_codegraph_status里的建图时间还是几天前先重建索引再 trace。大仓首次建图慢进度条不动不一定是卡死可以看 status 里的文件计数是否在涨。索引没跟上源码trace 出来的链路会把已经不存在的调用关系当成真的这种结果比没有结果更误导。6. 配完之后把这次调用和 Key 对一遍6.1 用同一把 Key 在模型对话里发一条测试消息配置保存并重启后可以先用 TaoToken 模型对话 拿同一把 Key 发一条测试消息确认模型 ID 和 Base URL 没填错。这一步和 3.3 节的普通对话是一回事只是换了个入口好处是能快速区分是 Key 的问题还是是 Reasonix 侧配置的问题。如果这边通、那边不通问题基本就在客户端的配置项上。6.2 长期跑 trace 的话看 Coding Plan 和 API Keys如果你准备把 CodeGraph 加进日常流程每天都让 Agent 追几条链路可以看 Coding Plan 的套餐是否够用。Key 统一在 控制台 API Keys 创建和管理同一把 Key 也能接到其他支持自定义 Base URL 的工具上Claude Code 的字段对照见 接入文档。手动注册 MCP 这件事真正花时间的往往不是填那四个字段而是想清楚 CodeGraph 和模型各自该干什么。字段填完只是让工具能被调起来模型通道通了才让工具的结果变成能读的结论。两件事分开验证出问题的时候会少很多来回。