VS Code 的 MCP 配置

通过服务器目录或配置文件接入 MCP，并区分兼容格式与 Agent Host。

This page has not been translated into English yet. The original Chinese version is shown below.

VS Code 可以从 MCP 服务器目录安装，也可以手动编辑配置。当前 VS Code 文档已补充 portable 配置和 Agent Host 行为；GitHub 的通用教程仍主要展示 .vscode/mcp.json。

从目录安装

在 Extensions 搜索 @mcp 加服务器名称，选择条目并点击 Install，按提示确认信任。GitHub MCP 可搜索 @mcp github。

运行 MCP: List Servers 检查服务器已配置，进入 Chat 的 Agent 模式，在工具选择器中确认实际可用工具。

范围	当前文档中的文件或入口	顶层服务器键
项目 portable	仓库根 `.mcp.json`	`mcpServers`
用户 portable	`$COPILOT_HOME/mcp-config.json`，未设置时 `~/.copilot/mcp-config.json`	`mcpServers`
项目 VS Code 兼容格式	`.vscode/mcp.json`	`servers`
VS Code 用户 profile	MCP: Open User Configuration 打开的 mcp.json	`servers`

当前 VS Code 文档建议新服务器优先 portable 位置，并将后两者保留为兼容选项。GitHub 教程仍提到个人 settings.json；新配置应通过当前 MCP: Add Server 或配置命令选择位置，避免猜测包装层。

以下是 .vscode/mcp.json 的 GitHub 远程服务器结构，完成保存后按界面提示启动和授权：

{
  "servers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    }
  }
}

同一服务器尽量只配置在一个位置，避免重复实例及冲突。通过 MCP: List Servers 检查实际来源和状态。

Agent Host 原生读取 portable 文件；VS Code 可转发兼容配置，但不会转发依赖 ${input:...} 交互输入的服务器。用户输入变量的 PAT 示例不能因此被当作所有会话通用。

GitHub 通用教程列出 chat.mcp.discovery.enabled: true 复用 Claude Desktop；当前 VS Code 文档允许选择发现来源。按当前设置界面操作，不把旧布尔示例视作全部版本的唯一格式。

GitHub 的 VS Code 教程说明，MCP prompts 可通过 /mcp.servername.promptname 调用；资源通过 Add Context... → MCP Resources 加入聊天。实际是否出现这些入口，还取决于服务器暴露的能力与当前会话支持。

需要 GitHub 专用认证或企业地址时，分别参阅GitHub MCP和企业配置。