想在 VSCode 里装一个第三方 MCP 插件，市场解析失败、拉取直接 404。这种错很隐蔽，根因往往是一个多余的前缀。
报错现象
- 仓库地址解析失败
- 插件拉取返回 404
- 地址看起来「没问题」，但就是拉不到
原因分析
手动填写的第三方 MCP 插件仓库地址格式错误：带了多余的 file:// 本地协议前缀。
# 错误写法：带着本地协议前缀，市场识别不了
file://https://github.com/xxx/mcp-plugin
file:///C:/my-plugins/mcp-plugin
# 正确写法：标准 Git 仓库地址
https://github.com/xxx/mcp-plugin插件市场按 Git 仓库地址去拉取，file:// 前缀会干扰解析，导致找不到源、404。
解决步骤
- 删除协议前缀，改用标准 Git 仓库地址：
https://github.com/xxx/mcp-plugin.git- 如果地址正确仍拉不到，改用 npm 全局安装方式：
npm install -g @some-scope/mcp-plugin再在 MCP 配置里用 npx / 命令方式引用。
效果验证
- 仓库地址解析成功
- 插件拉取不再 404，正常加载启用
排错速查表
| 现象 | 处理 |
|---|---|
| 地址解析失败 | 删掉 file:// 前缀 |
| 拉取 404 | 确认是标准 Git 地址 |
| 仓库地址正确仍失败 | 改 npm 全局安装 |
核心经验：填 MCP 仓库地址只认
http(s)://开头。看到file://就打住，它是本地协议，不是给市场用的。