dotsagent.io
Язык:Русский
Microsoft

Добавление MCP-серверов в VS Code (GitHub Copilot)

VS Code читает .vscode/mcp.json в рабочей области, mcp.json в профиле пользователя или новые переносимые файлы .mcp.json.

macOS
User profile mcp.json (open via 'MCP: Open User Configuration'); portable: ~/.copilot/mcp-config.json
Windows
User profile mcp.json (open via 'MCP: Open User Configuration'); portable: ~/.copilot/mcp-config.json
Linux
User profile mcp.json (open via 'MCP: Open User Configuration'); portable: ~/.copilot/mcp-config.json
Файл проекта
.vscode/mcp.json (key 'servers') or portable .mcp.json (key 'mcpServers')
Ключ верхнего уровня
servers
Формат
json
OAuth для удалённых серверов
Да

Пример конфигурации

В этом примере добавлены размещённый сервер GitHub и Playwright в качестве локального сервера — в формате, который ожидает этот клиент.

.vscode/mcp.json
{
  "servers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    },
    "playwright": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "@playwright/mcp@latest"
      ]
    }
  }
}
shell
code --add-mcp '{"name":"github","type":"http","url":"https://api.githubcopilot.com/mcp/"}'
code --add-mcp '{"name":"playwright","command":"npx","args":["@playwright/mcp@latest"]}'

Примечания и особенности

  • В .vscode/mcp.json используется ключ servers; в переносимых .mcp.json и ~/.copilot/mcp-config.json — mcpServers.
  • Массив inputs на верхнем уровне запрашивает секреты, поэтому ключи не хранятся в файле.
  • В мастере Add server файлы .vscode/mcp.json и профиль пользователя теперь помечены как устаревшие: вместо них рекомендуется использовать переносимые файлы. Оба варианта по-прежнему работают.
  • VS Code также обнаруживает серверы, уже настроенные для Claude Desktop, Copilot CLI, Cursor и Windsurf.
  • Команда code --add-mcp добавляет сервер из строки JSON.

Создать конфигурацию VS Code (GitHub Copilot) →

Другие клиенты

Источники

  1. code.visualstudio.com/docs/copilot/reference/mcp-configuration
  2. code.visualstudio.com/docs/copilot/customization/mcp-servers