Cline 的 MCP Servers 面板里那个 GitHub MCP Server 一直挂着红点旁边不是写着 Disabled 就是干脆起不来点开日志又只有一行看不懂的 npx 报错——如果你正卡在这个界面先别急着重装 Cline 或者把 Node.js 卸了重装。这个红点大概率不是插件本身坏了而是 cline_mcp_settings.json 里的 command 和 args 还停留在 Mac 的写法上Mac 下 command: npx 能直接跑Windows 下 npx 是个 .cmd 包装脚本必须把 npx 挪进 args 数组外层 command 改成 cmd再补一个 /cMCP Server 才有机会变绿。这个时候可以打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建一把 API Key让走这把 Key 的 Codex 帮你逐行对照配置文件先把 Windows 写法改对再看 GitHub Token 的权限有没有给够。TaoToken 在这里只负责把模型调用接上MCP 配置文件仍旧由你自己在本地改。1. Cline 的 MCP 面板亮红点先分清是没连上还是被禁用1.1 红点、黄叹号、Disabled 不是一回事在 Cline 的 MCP Servers 面板里Installed 选项卡下面每个 MCP Server 旁边都有一小块状态。新手最容易把这些状态混成一类问题然后一通乱改改到最后连原本能跑的 Server 也起不来了。先把四种状态分开看灰色 DisabledServer 是被你自己关掉的配置本身可能完全正确。点一下开关从 Disabled 切到 Enable 就能恢复。绿色进程活着配置解析通过工具列表能正常拉出来。红点或黄叹号进程压根没起来或者起来了但握手失败。常见失败点就三处——command 找不到、args 参数顺序不对、env 里的 Token 无效。一直转圈不落状态多半是 npx 在下载包网络慢时会卡住或者包名写错在重试。看清状态之后动手能省掉一大半无效操作。红点先去看启动日志别一上来就改 JSONDisabled 就更简单先 Enable 再看。1.2 打开 cline_mcp_settings.json 看 command 那一行Cline 的图形界面看起来在帮你「安装」其实背后干的事就是往 cline_mcp_settings.json 里写一段 JSON。这个文件在 VSCode 里可以这样找到点 Cline 的 MCP Servers 图标切到 Installed 选项卡右上角有个 Configure MCP Server 按钮点开就是原始 JSON。打开之后先看顶层结构它一定是这样的{ mcpServers: { server-name: { command: ..., args: [], env: {}, disabled: false, autoApprove: [] } } }如果连这层外壳都不对比如把 mcpServers 写成了 mcp_servers或者多个 Server 之间漏了逗号Cline 会直接解析失败整个面板上所有 Server 全红。先确认 JSON 本身能被解析再去看单个 Server 的 command 和 args。2. Windows 下 npx 必须挪进 argscline_mcp_settings.json 的正确写法2.1 Mac 能跑的配置Windows 照抄就是红点原文里 GitHub MCP Server 的那段配置在 Mac 上可以直接用但 Windows 用户必须做三处改动这也是原文反复强调过的地方把原本写在 command: npx 里的 npx 挪进 args 数组把 command 的值改成 cmd在 args 数组最前面补一行 /c。原因不复杂。Windows 下 npx 不是一个可执行文件本体而是一个 .cmd 包装脚本直接让进程去 fork npx 会找不到可执行路径。写成 cmd /c npx ... 之后实际上是让 cmd.exe 帮你解析并启动 npx路径问题就绕过去了。这不是 Cline 的怪异设计而是 Windows 进程启动模型决定的。2.2 github-server 的完整可复制配置以原文的 GitHub MCP Server 为例改成 Windows 写法之后长这样{ mcpServers: { github: { command: cmd, args: [ /c, npx, -y, modelcontextprotocol/server-github ], env: { GITHUB_PERSONAL_ACCESS_TOKEN: YOUR_GITHUB_TOKEN }, disabled: false, autoApprove: [] } } }几个细节Server 的名字可以简化成 github不一定要用完整仓库路径那一长串-y 是让 npx 不要停下来问 yesenv 里的 GITHUB_PERSONAL_ACCESS_TOKEN 要用你自己的 GitHub Token不要留原文截图里那种脱敏占位。2.3 filesystem 与 timeWindows 路径和 Python 命令的差异filesystem 这个 Server 在 Windows 下除了同样的 cmd /c 处理之外路径还要注意两点filesystem: { command: cmd, args: [ /c, npx, -y, modelcontextprotocol/server-filesystem, C:\\Users\\Public\\Desktop ] }路径里单个反斜杠会被 JSON 当转义符吃掉所以 Windows 路径要写成双反斜杠另外允许访问的目录一定要显式列出来不要把整个盘符丢进去这也是原文在结尾专门提醒过的安全点。time 这个 Server 是 Python 写的命令不是 npx 而是 pythontime: { command: python, args: [ -m, mcp_server_time, --local-timezoneAsia/Shanghai ] }注意这里 command 就不要改成 cmd 了因为 python 本身在 Windows 上通常是可执行文件。装它之前先 pip install mcp-server-time否则红点依旧。3. 让 Codex 对着配置文件排查Key 从 TaoToken 拿3.1 给 Codex 配上 https://taotoken.net/api自己逐行对着 JSON 看有时候容易漏尤其是多个 Server 混在一起、逗号又多的时候。这时候可以让一个走 TaoToken 的 Codex 帮你做对照。先去 TaoToken 注册一个账号在控制台创建一把 API KeyKey 名随便起权限默认就行。Codex 的配置文件在 ~/.codex/config.toml写入下面这几行model YOUR_MODEL_ID model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEYmodel 这一项不要凭记忆填去 TaoToken 模型广场 看当前列表里有什么复制一个真实存在的模型 ID。base_url 只写 https://taotoken.net/api末尾不要加 /v1加了会 404。然后在 shell 里导出环境变量export TAOTOKEN_API_KEYYOUR_API_KEYWindows PowerShell 下换成$env:TAOTOKEN_API_KEY YOUR_API_KEY3.2 把配置文件贴进对话让 Codex 逐项对照Codex 能跑起来之后把 cline_mcp_settings.json 的内容粘贴到对话里问它三个问题就够了Windows 下每个 Server 的 npx 是不是都在 args 里command 是不是 cmdargs 里有没有 /cenv 里的 Token 占位符有没有替换成真实值多个 Server 之间的逗号和括号有没有漏Codex 不会去读你硬盘上的文件它只对着你贴进去的这一段文本做检查改文件的动作仍旧是你自己在 VSCode 里完成。这一点要记清楚模型给的是修改建议落盘的是你。原始文章里提到 Cline 也可以弹一个 AI 对话窗口帮你生成配置思路是一样的只是把「生成」换成了「对照排查」。4. GitHub Token 权限没给足红点也不会消4.1 Fine-grained token 该勾哪几个权限配置写法全对但红点依旧另一个高频原因在 GitHub Token 本身。原文用的就是 fine-grained personal access token而不是传统的 classic token。签发时选 All repositories 或指定仓库然后在 Repository permissions 里至少勾这几项权限项建议级别用途ContentsRead and write读文件、推文件AdministrationRead and write创建仓库、管理仓库设置CodespacesRead and write涉及开发环境相关操作MetadataRead默认强制基础信息只把 Contents 给 Read 的话搜索仓库能过一到 create_repository 就会 403表现就是红点加调用失败。所以排障时不能只盯着 JSON把 Token 的权限表也调出来看一眼。4.2 Token 过期与 env 字段写错的表现Token 有两个容易忽略的坑。第一是有效期创建的时候没设置 expiration 或者设得太短过几天 JSON 里什么都没动Server 忽然全红。第二是 env 字段名写错比如把 GITHUB_PERSONAL_ACCESS_TOKEN 写成了 GITHUB_TOKEN命令能启动但调用工具时参数为空日志里能看到 401 或 403 之类的提示。碰到这两种情况处理方式都是在 GitHub 侧重新签发或修正 Token然后回到 cline_mcp_settings.json 里把 env 的值换掉保存回 MCP 面板点一下刷新。5. 保存后让 MCP Server 变绿刷新、重启与一次最小验证5.1 Installed 选项卡看状态必要时重启 Cline改完 JSON 保存之后回到 Cline 的 MCP Servers → Installed 选项卡。有时候状态不会自动更新需要点一下右上角的 Refresh还是红的话就整窗口重载Developer: Reload Window。npx 第一次下载包会慢最多等十几秒再判断。如果重启后依旧是红点点开 Server 名字旁边的日志箭头日志里通常会给出非常明确的一行——command not found说明 command 写错Cannot find module说明包名写错或没装Unexpected token说明 JSON 本身有语法错。日志比在界面上瞎猜高效得多。5.2 用 search_repositories 做一次最小验证最省事的验证方式是问一句自然语言比如「列出我 GitHub 账号下的仓库」看 Cline 会不会自动选中 github MCP 里的 search_repositories 工具。第一次会弹一个 Approve 对话框点允许。如果工具被调起来并且返回了仓库列表说明三件事都对了Windows 的 command/args 写法、GitHub Token 的权限、MCP Server 进程的启动链路。如果返回 403那就退回去看 Token 权限如果 Cline 根本没选到这个工具那说明 Server 还没变成绿色回到 5.1 那步重来。6. 绿了点之后去控制台对一下这次 Codex 调用配置能跑通之后值得顺手做一件事打开 TaoToken 模型对话 用同一把 Key 发一条测试消息确认 Codex 那一侧的模型 ID 和 Base URL 填对了顺便看看这次排障过程中的调用有没有正常记上账。如果打算把 Codex 常驻在本地做代码解释和配置对照可以打开 Coding Plan 看一下套餐是否够用Key 的入口在 控制台 API Keys需要重新签发或改名都在这里。Cline 侧 MCP 配置文件的具体写法可以对照 Claude Code 接入文档 里的环境变量格式——虽然名字是 Claude Code但其中 Base URL 和 env 变量的填写方式在 Codex 侧同样受用。最后补一句提醒MCP Server 本质上是本地跑的一个进程它有权限读你允许的目录、调你授权的 API。给 filesystem 配目录时一定要显式限制不要把整个用户目录丢进去也不要让 Server 拿一个权限过大的 Token。红点排掉只是第一步权限收窄才是长期能安心用的前提。
