Appearance
MCP(Model Context Protocol)让 Copilot Chat 接入外部系统——数据库、Web 服务、自定义工具。配置方式是在项目或用户级别的 JSON 文件中定义 MCP 服务器,Copilot 的 Agent 模式会自动感知并调用可用的 MCP 工具。本页提供各 IDE 的具体配置示例。
GitHub Copilot Chat 接入 MCP 服务器:扩展 AI 能力的完整配置指南
什么是 MCP
MCP(Model Context Protocol)是一套开放协议,让 AI 应用可以从外部系统读取数据和调用工具。通过 MCP,Copilot Chat 可以:
- 查询你的数据库(读取 schema、执行查询)
- 访问 Web 服务(抓取页面、调用 API)
- 使用本地工具(运行脚本、访问文件系统)
- 连接企业内部服务(Jira、Confluence 等)
企业用户注意:Copilot Business / Enterprise 用户的 MCP 使用受"MCP servers in Copilot"策略控制,需要管理员在企业或组织设置中开启此功能。
VS Code 配置
前提条件
- VS Code 1.99 或更新版本
- 需要在 Agent 模式下使用 MCP 工具
方式一:通过 GitHub MCP Registry 安装
如果要安装的 MCP 服务器已在 GitHub MCP Registry 中注册:
- 打开 VS Code 扩展面板
- 在搜索框输入
@mcp 服务器名称 - 选择对应的 MCP 服务器并安装
- 系统提示时选择"信任此服务器"
- 用命令面板运行 MCP: List Servers 验证安装成功
方式二:手动配置 JSON
项目级配置(只影响当前项目):
在项目根目录创建 .vscode/mcp.json:
json
{
"inputs": [
{
"type": "promptString",
"id": "api-key",
"description": "Your API Key"
}
],
"servers": {
"fetch": {
"command": "uvx",
"args": ["mcp-server-fetch"]
},
"memory": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-memory"]
}
}
}用户级配置(对所有项目生效):
在 VS Code 的 settings.json 中配置 mcp.servers,或者开启自动发现:
json
{
"chat.mcp.discovery.enabled": true
}在 Chat 中使用 MCP 工具
- 打开 Copilot Chat,切换到 Agent 模式
- 确认目标 MCP 服务器正在运行(点击工具图标查看列表)
- 直接用自然语言请求:
Fetch https://github.com/github/docs 并总结主要内容MCP Prompt 也可以通过 slash commands 调用:
/mcp.servername.promptnameJetBrains 配置
远程 MCP 服务器(通过 URL 连接):
json
{
"servers": {
"github": {
"url": "https://api.githubcopilot.com/mcp/",
"requestInit": {
"headers": {
"Authorization": "Bearer YOUR_PAT_HERE"
}
}
}
}
}本地 MCP 服务器(通过命令启动):
json
{
"servers": {
"memory": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-memory"]
}
}
}在 JetBrains 的 Copilot Chat 面板中,通过 MCP 图标进入配置管理界面,也可以从 Registry 直接安装。
Visual Studio(17.14+)配置
通过 Chat 面板配置:
- 打开 Copilot Chat,切换到 Agent 模式
- 点击工具图标 → Add a server
- 输入配置
远程服务器示例:
json
{
"servers": {
"github": {
"url": "https://api.githubcopilot.com/mcp/"
}
}
}本地 Docker 服务器示例:
json
{
"servers": {
"github-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run", "-i", "--rm",
"-e", "GITHUB_PERSONAL_ACCESS_TOKEN",
"ghcr.io/github/github-mcp-server"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_PAT"
}
}
}
}Eclipse 配置
和 JetBrains 类似,支持注册表安装和手动 JSON 配置两种方式:
json
{
"servers": {
"github": {
"url": "https://api.githubcopilot.com/mcp/",
"requestInit": {
"headers": {
"Authorization": "Bearer YOUR_PAT_HERE"
}
}
}
}
}常用 MCP 服务器推荐
| 服务器 | 用途 | 安装命令 |
|---|---|---|
@modelcontextprotocol/server-memory | 跨会话记忆 | npx -y @modelcontextprotocol/server-memory |
mcp-server-fetch | 抓取 Web 页面 | uvx mcp-server-fetch |
github-mcp-server | GitHub API 操作 | Docker 运行 ghcr.io/github/github-mcp-server |
更多 MCP 服务器见 GitHub MCP Registry 和 MCP 官方服务器列表。
常见问题
Q: 配置了 MCP 服务器但 Agent 模式看不到工具,怎么排查?
A: 1) 确认 MCP 服务器进程正在运行;2) VS Code 用户检查 .vscode/mcp.json 语法是否正确;3) 在命令面板运行 MCP: List Servers 查看状态;4) 检查企业/组织的 MCP 策略是否已开启。
Q: MCP 只能在 Agent 模式用吗?
A: 是的,MCP 工具目前只在 Copilot Chat 的 Agent 模式下可用,Ask 模式和 Plan 模式不会调用 MCP 工具。
Q: 这和 Claude Code 的 MCP 配置有什么区别?
A: 功能目标相同(扩展 AI 可访问的工具集),但配置格式和位置不同。Claude Code 用 .claude/settings.json 或 settings.local.json 配置 MCP,而 Copilot 用 .vscode/mcp.json(VS Code)或 IDE 内的配置面板。MCP 协议本身是通用的,同一个 MCP 服务器通常两个工具都能连接。