Паветта
Как подключить MCP-сервер к VS Code
VS Code подключает MCP-серверы к агенту Copilot. Новые серверы хранятся в ~/.copilot/mcp-config.json или в .mcp.json в корне проекта, оба файла с ключом mcpServers.
Где лежит конфиг
~/.copilot/mcp-config.json, или $COPILOT_HOME/mcp-config.json, если задана COPILOT_HOMEДля всех проектов (Copilot Global).mcp.json в корне рабочей папкиДля команды, в проекте.vscode/mcp.json или mcp.json профиля, ключ serversСтарый формат Local harnessКак добавить сервер
1
Через редактор настроек
Chat: Open Customizations → MCP Servers → Add Server (+). Выберите HTTP или Command (stdio), введите адрес или команду и ID сервера, затем Global → Copilot Global.
2
Из палитры команд
MCP: Add Server запускает тот же пошаговый мастер.
3
Из каталога
MCP: Browse MCP Servers открывает поиск готовых серверов.
4
Вручную в файле
В mcpServers задайте "type": "stdio" с command и args или "type": "http" с url и headers.
Как проверить и удалить
ПроверкаПопросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.
УдалениеChat: Open Customizations → MCP Servers → меню «…» у сервера → Disable или Uninstall. Если Uninstall нет, удалите из файла только запись сервера.
Переменные окруженияВ новом формате пишите ${NAME} или ${NAME:-default}. В .vscode/mcp.json переменные подставляются как ${env:NAME}.
Выбор инструментовПоле tools: ["*"] открывает все инструменты сервера, список имён оставляет только нужные.
Свой клиент OAuthДля сервера с заранее зарегистрированным клиентом укажите oauthClientId.
Вывод сервераMCP Servers → «…» → Show Output, или MCP: List Servers → сервер → Show Output.
Включение и выключениеПереключатель рядом с сервером выключает его в выбранной области, общий конфиг команды при этом не меняется.
Готовые конфиги для VS Code
Нажмите на сервер, чтобы раскрыть конфиг в формате VS Code.
Playwright MCPДаёт агенту настоящий браузер
{
"mcpServers": {
"playwright": {
"type": "stdio",
"command": "npx",
"args": ["@playwright/mcp@latest"]
}
}
}
GitHub MCPПодключает агента к GitHub
{
"mcpServers": {
"github": {
"type": "http",
"url": "https://api.githubcopilot.com/mcp/",
"headers": {
"Authorization": "Bearer <GitHub PAT>"
}
}
}
}
Context7 MCPПодтягивает в контекст агента свежую документацию и примеры кода…
{
"mcpServers": {
"context7": {
"type": "http",
"url": "https://mcp.context7.com/mcp",
"headers": {
"Authorization": "Bearer <ключ Context7>"
}
}
}
}
Figma MCPПодключает агента к макетам Figma
{
"mcpServers": {
"figma": {
"type": "stdio",
"command": "npx",
"args": ["-y", "figma-developer-mcp", "--stdio"],
"env": {
"FIGMA_API_KEY": "<ваш токен Figma>"
}
}
}
}
Chrome DevTools MCPДаёт агенту живой Chrome с инструментами DevTools
{
"mcpServers": {
"chrome-devtools": {
"type": "stdio",
"command": "npx",
"args": ["-y", "chrome-devtools-mcp@latest"]
}
}
}
Filesystem MCPОткрывает агенту доступ к файлам в папках, которые вы перечислили при…
{
"mcpServers": {
"filesystem": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/Users/username/Desktop",
"/path/to/other/allowed/dir"
]
}
}
}
Fetch MCPДаёт агенту читать веб-страницы
{
"mcpServers": {
"fetch": {
"type": "stdio",
"command": "uvx",
"args": ["mcp-server-fetch"]
}
}
}
Memory MCPДаёт агенту долгую память между чатами
{
"mcpServers": {
"memory": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-memory"],
"env": {
"MEMORY_FILE_PATH": "<полный путь>/memory.jsonl"
}
}
}
}
Supabase MCPПодключает агента к проектам Supabase
{
"mcpServers": {
"supabase": {
"type": "http",
"url": "https://mcp.supabase.com/mcp"
}
}
}
Notion MCPЛокальный сервер Notion поверх Notion API
{
"mcpServers": {
"notion": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@notionhq/notion-mcp-server"],
"env": {
"NOTION_TOKEN": "ntn_<токен интеграции>"
}
}
}
}
Blender MCPСвязывает агента с запущенным Blender
{
"mcpServers": {
"blender": {
"type": "stdio",
"command": "uvx",
"args": ["mcp-for-blender"]
}
}
}
1С MCPПоказывает агенту метаданные и содержимое базы 1С:Предприятие
{
"mcpServers": {
"1c": {
"type": "http",
"url": "http://<веб-сервер>/<имя публикации>/hs/mcp/",
"headers": {
"Authorization": "Basic <логин и пароль пользователя 1С>"
}
}
}
}Ограничения
!
Local harness с файлами .vscode/mcp.json устарел и будет удалён в феврале 2027 года.
!
В формате mcpServers нет envFile и запросов ${input:...}.
!
Форма для .mcp.json в корне проекта не принимает выражения ${...}: правьте их через Other Properties.
!
Copilot user-конфиг с вашего компьютера не переносится на удалённый хост и в Dev Container.
Если не работает
Сервер не появился или изменения не видны
Проверьте выбранный harness, рабочую папку и файл, в который записан сервер.
stdio-сервер не запускается
Проверьте команду, аргументы, установленную среду выполнения и PATH там, где работает агент.
Docker-сервер сразу завершается
Уберите из аргументов флаг -d: клиенту нужно соединение через stdio.
Запуск заблокирован доверием
Проверьте конфиг и Workspace Trust: в Restricted mode серверы из проекта не стартуют.
Сервер работает, инструменты не вызываются
Проверьте, что сервер включён и его инструменты выбраны в списке tools.
Частые вопросы
Куда в VS Code прописать MCP-сервер?
Для себя — в ~/.copilot/mcp-config.json через Global → Copilot Global. Для команды — в .mcp.json в корне проекта. В обоих файлах ключ mcpServers.
Старый .vscode/mcp.json ещё работает?
Он относится к Local harness, который устарел и будет удалён в феврале 2027 года. Подходящие записи VS Code передаёт Copilot, новые серверы лучше заводить в mcpServers.
Как передать токен без записи в файл?
Задайте переменную окружения и сошлитесь на неё как ${NAME} в env или в значении заголовка.
Как посмотреть ошибки сервера?
В MCP Servers откройте меню «…» у сервера и выберите Show Output.
Источники: code.visualstudio.com, code.visualstudio.com, code.visualstudio.com, code.visualstudio.com