在 VS Code Copilot Chat 中配置 MCP

在 VS Code Copilot Chat 中配置 MCP

基础概念

如果你平时主要在 IDE 里写代码，那 VS Code 的 MCP 支持很适合你。它的核心价值不是“又多了一个能配 MCP 的客户端”，而是：让 GitHub Copilot 的 Agent 模式直接长出外部工具手脚。你不用离开编辑器，就能让 Copilot 去读 GitHub、跑浏览器、查数据库、打开内部文档，甚至把 MCP 提供的资源和提示词模板直接塞进当前对话。

按 VS Code 官方发布时间线来看，MCP server 支持从 2025 年 3 月发布的 VS Code 1.99 开始提供，到 2025 年 6 月发布的 VS Code 1.102 转为 General Availability（GA）。也就是说，这已经不是一个只能“试试看”的实验角落，而是 VS Code 官方正式支持的集成能力。

和 Claude Desktop 那种“桌面聊天 + 本地工具”模式不一样，VS Code 的优势在于它把 MCP 和 IDE 工作流绑得很紧：

• 工具可以直接被 Copilot Agent 选中并调用
• 资源可以通过 Add Context > MCP Resources 加进上下文
• Prompt 模板会以斜杠命令的形式出现
• 配置既可以做成个人级，也可以做成工作区级，适合团队共享

核心要素

从配置到调用的完整流程

到底该配在哪一层

基础用法

第一步：确认前置条件

最少要满足这几件事：

1. VS Code 版本不低于 1.99
2. 已登录并可使用 GitHub Copilot
3. 聊天窗口可切到 Agent 模式
4. 如果是企业托管账号，管理员没有禁用 chat.agent.enabled 或 chat.mcp.access

可以先在终端确认 VS Code 版本：

code --version

第二步：在工作区写一个最小配置

最常见的做法，是在当前项目根目录创建 .vscode/mcp.json。下面这个示例同时接了一个远程 GitHub MCP Server 和一个本地 Playwright Server：

{
  "servers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp"
    },
    "playwright": {
      "command": "npx",
      "args": [
        "-y",
        "@microsoft/mcp-server-playwright"
      ]
    }
  }
}

这段配置翻译成人话就是：

• github 走 http，适合那种已经托管好的远程 MCP 服务
• playwright 走本地命令启动，VS Code 会帮你执行 npx -y @microsoft/mcp-server-playwright
• servers 下面每一项就是一个独立的 MCP Server，Copilot 会把它们暴露出来的能力汇总给 Agent

如果你不想手写 JSON，也可以直接用 VS Code CLI 添加：

code --add-mcp '{"name":"playwright","command":"npx","args":["-y","@microsoft/mcp-server-playwright"]}'

第三步：启动并确认信任

配置写完后，VS Code 会发现这些 Server。你可以通过下面几种方式管理它们：

• 命令面板里运行 MCP: List Servers
• 打开 mcp.json，直接用文件顶部的操作入口启停
• 在 Extensions 视图里看 MCP 分类

如果这是工作区级 Server，第一次启用时通常会弹出信任确认。这里的意思不是“这个协议危不危险”，而是“你是否允许这个仓库里的配置在本机启动外部程序或访问外部服务”。

一个细节要记住：如果 Server 是你直接在 mcp.json 里手动写的，VS Code 不一定再额外弹一次 trust 提示，所以配置来源一定要自己把关。

第四步：在聊天里实际调用

一旦 Server 正常启动，Copilot Chat 就能消费它暴露出的能力：

• Tools：直接给 Agent 调用
• Resources：通过 Add Context > MCP Resources 加进对话上下文
• Prompts：作为斜杠命令显示在聊天里

最小体验方式：

你：审查一下我当前仓库最近打开的 PR，并用浏览器打开登录页做一次冒烟测试。
Copilot：先调用 GitHub MCP 工具读取 PR，再调用 Playwright MCP 工具打开页面并执行检查。

如果你不想让 Agent 自己挑工具，也可以在输入框里键入 #，明确点名某个 MCP Tool。

第五步：共享给团队

VS Code 这套做法最大的实际价值，是能把 MCP 配置当项目配置一起带走。常见做法有两种：

• 把 .vscode/mcp.json 提交进仓库，让团队成员拿到相同的 Server 列表
• 如果你的项目本来就用 Dev Container，把 MCP 配置写进 devcontainer.json，这样进入容器就自动具备同一套工具环境

同类工具对比

“在 VS Code 里配 MCP”不是唯一方案。你可以把它和另外两条常见路线放在一起看：

核心区别：

• VS Code Copilot Chat + MCP：最适合“我想马上让 IDE 里的 Agent 接上外部工具”，几乎零代码。
• VS Code 原生 AI 扩展 / Language Model API：适合你需要更深的 VS Code API 集成，比如命令面板、面板 UI、扩展发布。
• Claude Code + MCP：适合你的主战场是终端，不是编辑器窗口。

常见误区

优劣势分析

思考题

参考资料

1. VS Code 官方文档：MCP servers — https://code.visualstudio.com/docs/copilot/chat/mcp-servers（查询日期 2026-04-11）
2. VS Code 官方文档：Model Context Protocol — https://code.visualstudio.com/api/extension-guides/ai/mcp（查询日期 2026-04-11）
3. VS Code 官方文档：Copilot settings reference — https://code.visualstudio.com/docs/copilot/reference/copilot-settings（查询日期 2026-04-11）
4. VS Code 1.99 发布说明 — https://code.visualstudio.com/updates/v1_99（查询日期 2026-04-11）
5. VS Code 1.102 发布说明 — https://code.visualstudio.com/updates/v1_102（查询日期 2026-04-11）
6. Anthropic 官方文档：MCP in Claude Code — https://docs.anthropic.com/en/docs/claude-code/mcp（查询日期 2026-04-11）