TNWS AI

Гайд · TNWS AI

Как подключить локальный Fetch MCP-сервер к Copilot Chat в VS Code

Copilot
7 мин—

Настройка локального Fetch MCP в .vscode/mcp.json: точная конфигурация uvx, запуск сервера, Agent mode, проверочный промпт и контроль разрешений.

Задача и применимость

Цель этого руководства — добавить в репозиторий локальный Fetch MCP-сервер, запустить его из .vscode/mcp.json и проверить управляемое получение веб-страницы через Copilot Chat. Материал рассчитан на разработчикам VS Code, которым нужен воспроизводимый MCP-инструмент на уровне проекта и прозрачное подтверждение каждого внешнего действия. Здесь важен не сам факт появления ответа Copilot, а воспроизводимый результат: понятная конфигурация, ограниченная область действия, контролируемое подтверждение и независимая проверка.

Актуальность интерфейса, имён команд и функций проверена 13 сентября 2026 года по официальной документации GitHub. Тарифы и числовые лимиты намеренно не приводятся: они не нужны для выполнения сценария и могут меняться. Если доступ выдан организацией, итоговое поведение также зависит от политики администратора.

Что подтверждает официальная документация

GitHub приводит Fetch как ручной пример: файл .vscode/mcp.json, сервер fetch, команда uvx, аргумент mcp-server-fetch, затем CodeLens-кнопка Start, режим Agent и подтверждение Continue. Проверено 13 сентября 2026 года.

Не переносите названия кнопок из старых скриншотов и не заменяйте команды похожими по смыслу. В автоматизируемом сценарии точное имя — часть контракта. Если интерфейс отличается от описанного, остановитесь и снова откройте источник по ссылке в конце статьи.

Результат, который считаем успешным

Успех проверяется наблюдаемыми признаками. Инструмент доступен в ожидаемой области; тестовая операция выполняется ровно один раз; пользователь понимает, какие данные читаются или изменяются; результат можно перепроверить вне ответа модели. Если хотя бы один признак отсутствует, не переходите к рабочему репозиторию.

Перед началом создайте безопасную тестовую область. Для локальной работы полезны чистый git status, небольшой репозиторий и отсутствие секретов в открытых файлах. Для операций GitHub заранее запишите правильные OWNER/REPO, ожидаемый тип действия и критерий отмены. Это превращает расплывчатую просьбу в проверяемую процедуру.

Готовый .vscode/mcp.json

Скопируйте заготовку и замените только явно обозначенные данные:

{
  "inputs": [{ "type": "promptString" }],
  "servers": {
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"]
    }
  }
}

Храните команду или профиль рядом с инструкцией команды, если это не персональный секрет. Токены, cookies и одноразовые коды нельзя помещать в Markdown, chat prompt, issue или git. Перед выполнением перечитайте шаблон как обычный код: какие процессы запускаются, какой ресурс указан и есть ли возможность записи.

Пошаговая настройка

  1. Создайте каталог .vscode в корне репозитория, если его ещё нет, и файл .vscode/mcp.json. Репозиторная конфигурация будет видна коллегам, которые откроют проект.

  2. Вставьте JSON из шаблона без комментариев. Убедитесь, что command равен uvx, а в args ровно mcp-server-fetch.

  3. Сохраните файл. Над списком серверов в редакторе должна появиться CodeLens-кнопка Start. Нажмите её; VS Code запустит сервер и обнаружит инструменты.

  4. Откройте Copilot Chat кнопкой Copilot в title bar. В dropdown чата выберите Agent.

  5. Нажмите значок tools в левом верхнем углу поля чата и убедитесь, что видны сервер fetch и его инструменты.

  6. Отправьте проверочный промпт. Когда Copilot запросит разрешение на вызов, проверьте URL и нажмите Continue только для ожидаемого адреса.

После каждого существенного шага фиксируйте простой факт: команда найдена, сервер запущен, профиль выбран, preview совпадает или публичная страница открылась. Не заменяйте такую проверку фразой модели «готово» — она описывает намерение, но не состояние системы.

Готовый промпт

Fetch https://github.com/github/docs. Верни только заголовок страницы, назначение репозитория и конечный URL после перенаправлений. Не переходи по другим ссылкам.

Промпт специально задаёт объект работы, границы и формат. В рабочем варианте добавьте критерий остановки: например, «ничего не создавай до подтверждения», «не меняй файлы» или «не выходи за изменённые функции». Для write-действий формулируйте preview и выполнение как два разных хода диалога.

Реалистичный пример входа и ожидаемого результата

Вход: Запрос содержит один публичный URL https://github.com/github/docs и запрет на обход дополнительных ссылок.

Ожидаемый результат: Copilot запрашивает подтверждение, вызывает Fetch после Continue и возвращает краткое описание репозитория GitHub Docs без чтения иных доменов.

Проверьте результат по первичному артефакту: git diff, списку MCP tools, URL GitHub, состоянию issue или локальным тестам. Если модель уверенно сообщает неподтверждённую версию, право доступа или факт выполнения, считайте это незавершённым шагом. Правильный результат допускает внешнюю проверку.

Как разобрать ответ и принять решение

Сначала отделите факты от рекомендаций. Факт должен иметь опору: путь к файлу, параметр вызова, номер issue, URL, diff или результат команды. Рекомендация может быть полезной, но не должна автоматически расширять задачу. Особенно внимательно проверяйте новые зависимости, изменения прав и команды, которые отправляют данные во внешний сервис.

Затем сравните ответ с исходными границами. Если просили read-only анализ, любое предложение немедленно изменить файл — повод отменить действие. Если разрешили один объект, убедитесь, что tool call не содержит пакетной операции. Если сценарий использует подтверждение, читайте имя инструмента и аргументы, а не только текст кнопки.

Наконец, повторите минимальную проверку без помощи модели. Для локального сценария это обычно git status, git diff и проектные тесты. Для GitHub — открытие прямого URL и сравнение title, body, labels или review comments. Такая тройная сверка обнаруживает частично выполненные операции и ошибки области действия.

Типовые ошибки и диагностика

  • Если Start не появляется, сначала проверьте валидность JSON и расположение .vscode/mcp.json.
  • Если сервер не виден, откройте Command Palette и выполните MCP: List Servers.
  • Репозиторный MCP-файл — исполняемая конфигурация. Перед доверием проверяйте command, args и изменения в pull request.

При сбое не повторяйте write-запрос вслепую: сначала проверьте, не был ли объект уже создан. Для локальной команды сначала выясните фактический путь исполняемого файла. Для MCP посмотрите список серверов, выбранный режим Agent, перечень tools и параметры подтверждения. Для custom agent откройте сам .agent.md и проверьте frontmatter.

Безопасность и командная эксплуатация

Принцип минимальных полномочий здесь практичен: включайте только необходимые tools, открывайте только нужный workspace и не передавайте секреты через prompt. Репозиторные конфигурации MCP и custom agents должны проходить code review, потому что они управляют командами и поведением агента. Персональные профили тоже нужно периодически перечитывать: они действуют в нескольких проектах и легко устаревают.

Разделяйте подготовку и изменение. На первом ходе агент собирает данные и показывает preview, на втором пользователь проверяет целевой ресурс, а на третьем разрешает ровно одно действие. После действия выполняется независимая проверка. Эта последовательность немного длиннее, зато оставляет понятный журнал решений и упрощает откат.

Чек-лист финальной проверки

  • Использован точный официальный путь, команда или пункт меню, актуальный на 13 сентября 2026 года.
  • Область действия соответствует задаче: пользователь, workspace, репозиторий или один pull request.
  • В шаблоне нет токенов, персональных данных, внутренних URL и случайных секретов.
  • Перед write-действием проверены preview, имя tool и его аргументы.
  • Операция выполнена не более одного раза и не создала дубль.
  • Результат подтверждён через git diff, список серверов, тесты или прямой URL.
  • Неожиданные рекомендации не расширили исходную задачу.
  • Изменения конфигурации готовы к обычному code review команды.

FAQ

Почему конфигурация хранится в .vscode/mcp.json?

Так GitHub документирует MCP на уровне конкретного репозитория. Персональную конфигурацию можно разместить в VS Code settings.json, но это другой уровень области действия.

Что делает Start?

Запускает указанные MCP-серверы, инициирует ввод при необходимости и обнаруживает инструменты для последующих сессий.

Зачем выбирать Agent?

Именно в agent mode Copilot Chat использует доступные инструменты и может вызвать MCP-сервер для выполнения запроса.

Можно ли автоматически подтверждать вызовы?

Для первой и чувствительной настройки лучше проверять каждый вызов. Подтверждение позволяет заметить неожиданную команду или URL до действия.

Официальные первоисточники

Источники и изменяемые детали проверены 13 сентября 2026 года. Перед повторением процедуры после заметного обновления GitHub Copilot или VS Code откройте ссылки снова и сравните имена команд, меню и требования.

Читайте также

ГайдыCopilot13 сентября 2026

Как архивировать остановленную сессию Copilot cloud agent

Пошаговое архивирование stopped-сессии Copilot cloud agent без потери pushed commits и с предварительной проверкой pull request.

6 мин 
ГайдыCopilot13 сентября 2026

Как найти прошлую сессию Copilot по естественному запросу

Поиск синхронизированных Copilot-сессий по смыслу: условия remoteExport, точные запросы, проверка владельца и восстановление контекста.

6 мин 
ГайдыCopilot13 сентября 2026

Как безопасно настроить allowed-tools в GitHub Copilot Agent Skill

Практическая настройка allowed-tools для Agent Skill: минимальные разрешения, shell-риски, проверка скрипта и негативный тест.

6 мин 

Подбор

Какую нейросеть выбрать

Пройти опрос

Комментарии

Пока тихо. Скажите первое слово