Счётчик Яндекс Метрики
Перейти к основному содержанию
Atomno labs

редактор Microsoft со встроенной поддержкой MCP

MCP-серверы для VS Code

18 серверов с российскими государственными данными для VS Code. Поддержка MCP встроена в редактор, расширения не нужны: серверы описываются в .vscode/mcp.json и уезжают в репозиторий вместе с проектом.

Что такое MCP-сервер в VS Code?

MCP-сервер в VS Code — источник инструментов для чата с агентом. Поддержка встроена в сам редактор: ставить стороннее расширение не нужно, готовые серверы ищутся прямо в разделе Extensions по запросу @mcp и устанавливаются кнопкой.

Настройки описываются в файле mcp.json, и адресов у него два. Рабочий лежит в папке проекта — .vscode/mcp.json; его коммитят в репозиторий, чтобы у всей команды был одинаковый набор инструментов. Личный открывается командой MCP: Open User Configuration и действует во всех проектах сразу.

Ключ верхнего уровня тут называется servers — не так, как у большинства клиентов. Рядом с ним живёт блок inputs: способ не хранить ключи в файле. Вместо значения пишется ссылка, а редактор спросит его при первом запуске сервера и сохранит отдельно.

Перед первым стартом VS Code спрашивает, доверяете ли вы серверу. На macOS и Linux сервер можно дополнительно запереть в песочнице с явным списком доступных папок и доменов.

Подключение через mcp.json

Файл можно написать руками, а можно поручить редактору: команда MCP: Add Server проведёт по шагам и спросит, куда записать — в проект или в личный профиль. Ниже готовый файл на два сервера, одному из них нужен ключ.

Где лежит mcp.json

Проектный <проект>/.vscode/mcp.json
Личный профиль палитра команд → MCP: Open User Configuration
Удалённая машина палитра команд → MCP: Open Remote User Configuration
Путь к файлу профиля в документации Microsoft не расписан по операционным системам — открывайте файл командой, редактор сам подставит нужную папку профиля
  1. 1

    Создайте файл в папке проекта

    Откройте палитру команд и выполните MCP: Add Server, выбрав целью Workspace. Редактор создаст .vscode/mcp.json и подставит подсказки по полям прямо при наборе. Тот же файл можно завести руками — схема одинаковая.

  2. 2

    Опишите серверы и вынесите ключ в inputs

    Два момента, на которых спотыкаются чаще всего: ключ верхнего уровня называется servers, а токен в файл не вписывается — вместо него ставится ссылка на элемент из inputs. Имена серверов Microsoft советует писать слитно в стиле camelCase, без пробелов и спецсимволов.

    .vscode/mcp.json

    {
      "inputs": [
        {
          "type": "promptString",
          "id": "fns-check-token",
          "description": "Токен Atomno для проверки контрагентов",
          "password": true
        }
      ],
      "servers": {
        "atomnoSeoAudit": {
          "type": "stdio",
          "command": "uvx",
          "args": ["atomno-mcp-seo-audit"]
        },
        "atomnoFnsCheck": {
          "type": "stdio",
          "command": "uvx",
          "args": ["atomno-mcp-fns-check"],
          "env": {
            "MCP_FNS_CHECK_TOKEN": "${input:fns-check-token}"
          }
        }
      }
    }
  3. 3

    Подтвердите доверие и проверьте инструменты

    При первом запуске редактор спросит, доверяете ли вы серверу: без ответа он не стартует. Дальше откройте чат и нажмите Configure Tools — там перечислены все инструменты сервера, лишние выключаются переключателем. Состояние серверов и их журналы — по команде MCP: List Servers.

Что спросить у агента

Агент видит открытый проект, поэтому запросы удобно привязывать к тому, что сейчас в редакторе:

  • «Прогони аудит по адресу из README и выпиши задачами всё, что мешает индексации.»
  • «Возьми ИНН из фикстуры к тестам и замени выдуманные реквизиты на настоящие.»
  • «Свободно ли название из package.json по реестру товарных знаков?»

С чего начать в VS Code

Файл настроек уезжает в репозиторий вместе с проектом, поэтому в него стоит класть то, что пригодится каждому в команде, а не только вам.

18 серверов для VS Code

Любой сервер описывается в mcp.json одинаково, меняется только имя пакета в args. Если файл лежит в проекте, набор инструментов получит вся команда после ближайшего обновления кода.

ФНС / Налоги (3)

Финансы (2)

Юр. данные (6)

Недвижимость (2)

Госзакупки (1)

SEO / Маркетинг (2)

Бизнес-системы (2)

Фильтры по категории и лицензии — в общем каталоге.

Типовые ошибки в VS Code

Ошибки, которые встречаются именно в VS Code:

Написали mcpServers вместо servers

Ключ верхнего уровня в mcp.json называется servers. Блок с привычным по другим клиентам именем mcpServers редактор просто не увидит: ошибки не будет, инструментов тоже. Готовый сниппет из чужой инструкции почти всегда требует переименования этого ключа.

Токен вписали прямо в env

Файл .vscode/mcp.json лежит в репозитории — в этом его смысл. Ключ, записанный строкой, уедет в историю при первом же коммите. Заведите элемент в inputs с password: true и подставьте ссылку на него: значение редактор хранит отдельно от файла.

Пропустили вопрос о доверии

Перед первым стартом редактор спрашивает подтверждение. Пока оно не дано, сервер не запускается, а чат продолжает работать без его инструментов — выглядит как «настроил, но ничего не появилось». Сбросить прежние решения можно командой MCP: Reset Trust.

Ждут песочницу на Windows

Ограничение доступа к файлам и сети через sandboxEnabled работает только на macOS и Linux. На Windows этот ключ ничего не меняет: сервер запускается с обычными правами пользователя. Планировать защиту через песочницу для команды на Windows не стоит.

Список инструментов не обновился

Редактор запоминает перечень инструментов сервера. После обновления сервера новые инструменты могут не появиться: выполните MCP: Reset Cached Tools, а затем перезапустите сервер из списка MCP: List Servers.

Вопросы и ответы

Нужно ли ставить расширение для поддержки MCP? +
Нет, поддержка встроена в редактор. Готовые серверы ищутся в разделе Extensions по запросу @mcp: их можно поставить в личный профиль или сразу в текущий проект — во втором случае обновится файл .vscode/mcp.json.
Чем проектный файл отличается от файла профиля? +
Проектный .vscode/mcp.json коммитится в репозиторий, поэтому набор серверов одинаков у всей команды. Файл профиля открывается командой MCP: Open User Configuration и действует во всех ваших проектах. У каждого профиля редактора он свой.
Как передать токен, не записывая его в файл? +
Через блок inputs. Опишите элемент с типом promptString и признаком password, а в env поставьте ссылку на него по идентификатору. Редактор спросит значение при первом запуске сервера и сохранит его отдельно от настроек проекта.
Можно ли добавить сервер из командной строки? +
Да, у команды code есть ключ --add-mcp: настройка передаётся строкой JSON и попадает в личный профиль. Удобно, когда одинаковый набор нужно раскатать на несколько машин скриптом.
Сервер не запустился — где смотреть причину? +
Выполните MCP: List Servers, выберите сервер и откройте Show Output: в журнале видно ошибку старта. О проблеме редактор дополнительно сообщает значком прямо в окне чата.
Переносятся ли настройки между машинами? +
Да, если включена синхронизация настроек. В списке Settings Sync: Configure нужно отметить пункт MCP Servers — тогда серверы из личного профиля появятся на других ваших устройствах.

Официальная документация VS Code по MCP

Выше — каталог серверов и минимум, чтобы начать. Полная схема mcp.json, правила песочницы, настройка для контейнеров разработки и режим отладки серверов описаны у Microsoft.

Открыть документацию

Добавьте серверы в проект

Начните с аудита сайта: ключ ему не нужен, а после подтверждения доверия инструменты появятся в чате сразу же.

Atomno MCP не аффилирован с VS Code. Данные — из открытых государственных реестров; ответственность за соблюдение условий использования источников остаётся на пользователе.