VS Code MCP 工具怎样限制到当前工作区
如果你希望 MCP 服务器只服务当前项目,核心做法是:在工作区根目录创建 .mcp.json,把服务器写入顶层 mcpServers,再通过服务器的 tools 数组只列出需要的工具。不要把这类配置误放到个人配置中,也不要把“工作区信任”当成“工具调用审批”。
官方地址:https://code.visualstudio.com/docs/agents/reference/mcp-configuration
本文只讲工具授权范围与工作区配置,不讨论模型供应商。下面的界面图是原创操作示意图,不是 VS Code 截图,也不是实际运行结果。
一、先确定配置文件放在哪里
打开项目后,按 文件 → 打开文件夹 确认当前工作区根目录。然后在资源管理器最外层创建 .mcp.json。VS Code 当前文档把它作为工作区共享的便携式 MCP 配置,顶层键是 mcpServers。
如果你使用的是旧的编辑器管理格式,.vscode/mcp.json 使用的是 servers 顶层对象;它与 Copilot 原生读取的工作区根目录 .mcp.json 不是同一个格式。新项目优先采用根目录文件,避免“文件存在但当前会话看不到”的错觉。

二、写入一个最小的工作区 MCP 配置
在当前工作区根目录新建 .mcp.json,先用一个最小服务器确认配置来源正确。下面是便携式 Copilot 格式,JSON 本身不插入注释,字段含义放在代码块后说明。
{
"mcpServers": {
"projectTools": {
"type": "stdio",
"command": "node",
"args": ["./tools/mcp-server.js"],
"tools": ["readProjectFile", "searchProject"]
}
}
}
mcpServers是工作区根配置的顶层对象。projectTools是本项目内可识别的服务器名称,建议使用短且唯一的英文名。command与args只描述如何启动服务器;示例中的相对路径应当确实存在于当前项目。tools是允许交给当前会话的工具名集合,名称必须与服务器实际暴露的工具一致。
保存后,在命令面板执行 Chat: Open Customizations,进入 MCP Servers 查看服务器是否出现在当前工作区上下文。只配置文件不等于已经成功调用工具,后面还要看启用、信任和审批状态。
三、用 tools 列表限制工具,而不是只靠目录位置
把文件放在工作区,只能决定配置的归属范围;真正收窄工具集合,要在对应服务器对象里填写 tools。例如项目只需要读取和搜索,就不要写入能够修改文件、执行命令或访问外部服务的工具。
{
"mcpServers": {
"projectTools": {
"type": "stdio",
"command": "node",
"args": ["./tools/mcp-server.js"],
"tools": [
"readProjectFile",
"searchProject"
]
}
}
}
操作路径是 Chat: Open Customizations → MCP Servers → 选择 projectTools → Other Properties。在表单看不到 tools 时,直接打开来源 JSON 编辑;保存后重新打开服务器控制项。列表越小,当前服务器提供给会话的工具范围越清楚。

四、分别检查工作区信任、服务器启用和调用审批
配置写对后仍可能出现工具不可用。按以下路径逐项检查:
- 工作区信任:点击窗口底部的工作区信任提示,确认项目处于受信任状态。工作区根目录的
.mcp.json会继承 Workspace Trust,受限模式可能阻止服务器启动。 - 服务器状态:在 Chat: Open Customizations → MCP Servers 中确认
projectTools没有被禁用,也没有处于错误状态。 - 工具范围:展开服务器的 Tools 区域,确认只出现
readProjectFile与searchProject。 - 调用审批:当代理第一次调用工具时,检查确认框中的工具名称与参数,再选择允许一次或跳过。启用工具不会绕过审批策略。
这四步分别回答“能不能启动”“是否启用”“能用什么”“这一次是否批准”。修复其中一项,不会自动修复另外三项。
五、保存后怎样判断限制已经生效
在当前工作区发起一个需要读取项目文件的任务,观察工具选择器和调用确认框。可按下面的最小清单记录状态:
| 检查项 | 期望状态 | 不符合时先查什么 |
|---|---|---|
| 配置来源 | 工作区根目录 .mcp.json | 是否误编辑了全局文件或 .vscode/mcp.json |
| 顶层格式 | mcpServers | 是否把旧格式的 servers 直接复制过来 |
| 工具列表 | 只显示项目所需工具 | 服务器是否支持对应工具名,列表是否过宽 |
| 信任状态 | 工作区已信任 | 是否处于 Restricted Mode |
| 审批状态 | 确认框中的名称与参数符合预期 | 当前会话的审批策略与请求参数 |
六、常见问题:为什么工具仍然过多或完全不见
1. 把工作区文件写成了旧格式
根目录便携式配置使用 mcpServers;编辑器管理的 .vscode/mcp.json 才使用 servers。先确认文件位置,再确认顶层键,不要只看服务器名称是否相同。
2. 只写了服务器,没有填写 tools
服务器配置能启动,不代表工具范围已经按任务收窄。补上 tools 数组,并使用服务器实际暴露的工具名。若表单不显示该字段,使用 Other Properties 编辑来源 JSON。
3. 服务器运行了,但当前会话没有调用
检查服务器是否启用、当前会话选择的 harness 是否支持该配置,以及工具是否被工具选择器关闭。服务器“正在运行”只说明启动成功,不代表当前请求一定会调用它。
4. 配置里写入了密钥
不要把 token、密码或完整 Authorization 值提交到工作区文件。便携式配置可以使用环境变量引用,并在运行服务器的主机或容器中提供变量。
总结
限制 VS Code MCP 工具可以记成三层:用工作区根目录 .mcp.json 限定配置归属,用服务器对象里的 tools 限定工具集合,再用 Workspace Trust 和调用审批控制启动与每次使用。三层都检查清楚,当前项目才能得到可解释、可复查的 MCP 工具边界。
相关问题
工作区 .mcp.json 和 .vscode/mcp.json 能同时存在吗?
可以存在,但它们属于不同配置格式和管理路径。实际使用时应明确当前会话读取哪一种,避免同名服务器造成排查混乱。
把 tools 写成星号可以吗?
是否支持取决于当前 MCP 配置格式与服务器实现。若目标是最小权限,优先列出确实需要的工具名,不要用通配符扩大范围。
工作区信任能代替工具审批吗?
不能。信任决定服务器是否可以启动,审批决定具体调用是否允许,它们是独立控制点。
Inkscape Path Effects 怎样把对象轮廓转换为可编辑路径
- 上一篇
- Inkscape Path Effects 怎样把对象轮廓转换为可编辑路径
- 下一篇
- Inkscape 怎样把参考对象的宽度分别应用给多个对象
-
- 文章 · 软件教程 | 27分钟前 |
- Inkscape Path Effects 怎样把对象轮廓转换为可编辑路径
- 169浏览 收藏
-
- 文章 · 软件教程 | 31分钟前 |
- Blender Bake Action 怎样把约束动画转换成关键帧
- 212浏览 收藏
-
- 文章 · 软件教程 | 49分钟前 |
- Audacity 怎样把波形纵轴切换为分贝刻度
- 244浏览 收藏
-
- 文章 · 软件教程 | 1小时前 | vs code · 软件教程 · VS Code Remote SSH 远程终端 terminal.integrated.cwd 默认目录
- VS Code Remote SSH 怎样让新终端默认进入指定目录
- 275浏览 收藏
-
- 文章 · 软件教程 | 1天前 | 故障排查 · 软件教程 · 快捷键 Intellij IDEA 导出设置 导入设置 JetBrains IDE Keymap
- JetBrains IDE 怎样导出并迁移自定义快捷键
- 322浏览 收藏
-
- 文章 · 软件教程 | 1天前 |
- Docker 构建怎样安排层顺序提高缓存命中
- 332浏览 收藏
-
- 文章 · 软件教程 | 1天前 | css · vs code · CSS VS Code 颜色预览 editor.colorDecorators
- VS Code 怎样只关闭 CSS 文件中的颜色预览方块
- 100浏览 收藏
-
- 文章 · 软件教程 | 1天前 |
- GitHub Actions 怎样上传并保留构建产物
- 296浏览 收藏
-
- 文章 · 软件教程 | 1天前 | 开发环境 · vs code · VS Code uid GID devcontainer.json Dev Containers remoteUser containerUser
- VS Code Dev Containers 怎样避免容器内文件变成 root
- 258浏览 收藏
-
- 文章 · 软件教程 | 1天前 | vs code · 软件教程 · 编辑器 VS Code 代码折叠 Fold Level
- VS Code 怎样用折叠级别快速收起嵌套代码
- 152浏览 收藏
-
- 文章 · 软件教程 | 1天前 | vs code · 软件教程 · VS Code tasks.json 任务变量 inputs
- VS Code 任务怎样用输入变量减少重复命令
- 368浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1084次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1084次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1247次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1191次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1036次使用
-
- 用 go.work 同时开发两个模块并保持各自发布独立
- 2026-10-07 201浏览
-
- go work sync 统一多模块版本校准的操作清单
- 2026-11-12 338浏览
-
- Go go.work replace 为什么覆盖模块自身 replace
- 2026-10-26 394浏览
-
- Redis ACL SETUSER 的 reset 和追加规则有什么区别
- 2026-11-11 182浏览
-
- VS Code Dev Containers 实战:用容器搭建一致开发环境
- 2026-06-12 182浏览

