VS Code 的 MCP 配置
通过服务器目录或配置文件接入 MCP,并区分兼容格式与 Agent Host。
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 的区别
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和企业配置。