Гайд · TNWS AI
Как передать env локальному MCP-серверу Copilot CLI
Использование --env KEY=VALUE для local MCP server: repeatable-параметры, секреты, PATH и проверка дочернего процесса.
Задача и применимость
Этот гайд решает конкретную задачу: передать локальному stdio server необходимые environment variables, не добавляя их в репозиторный файл или аргументы tool. Он нужен администраторам и разработчикам, которые управляют Model Context Protocol в GitHub Copilot CLI и хотят доказуемо контролировать источники, инструменты и права. MCP server расширяет возможности агента, поэтому даже read-only интеграцию следует рассматривать как границу доверия.
Перед началом зафиксируйте пользователя, copilot version, рабочий каталог и цель изменения. Не добавляйте server «на будущее»: перечислите один сценарий, нужные tools и владельца. Сделайте baseline через list/get, чтобы после операции увидеть ровно ожидаемое изменение. Если конфигурация командная, оформляйте её через review, а секреты храните отдельно.
Проверенные факты и первоисточники
Проверено 13 сентября 2026 года. Опция --env KEY=VALUE repeatable. В интерактивной форме env можно вводить как comma-separated пары или JSON object. $PATH включается по умолчанию и не требует отдельного перечисления.
Точные команды сверены с официальной Copilot CLI command reference и инструкцией GitHub по добавлению MCP servers. Изменяемые цены, тарифы и модели не используются. Указанные default или availability относятся к дате проверки; перед будущим изменением откройте источники заново.
Важно различать user, workspace, plugin и session configuration. Одинаковое имя может разрешаться по приоритету источников, а команда удаления может работать только для одного уровня. Поэтому в журнале изменения храните не только server name, но и source, transport, enabled status и список tools.
До изменения нарисуйте короткую цепочку данных: кто инициирует запрос, какой tool вызывается, куда уходит input и где сохраняется output. Отдельно отметьте, может ли server выполнять запись. Эта схема нужна не для формальности: по ней легко увидеть, что «чтение документации» на деле включает отправку фрагмента закрытого репозитория внешнему endpoint. Если маршрут данных неясен, не подключайте интеграцию до ответа владельца сервиса.
Также определите критерий остановки. При неожиданном tool, неизвестном source, ошибке TLS, запросе лишнего scope или появлении секрета в логе завершите session, отключите server и отзовите test credential. Не продолжайте эксперимент расширением прав: сначала устраните конкретную причину и снова начните с read-only проверки.
Модель угроз перед подключением
Проверьте четыре направления. Первое — происхождение executable или remote endpoint. Второе — данные, которые tools читают и меняют. Третье — credentials и место их появления в history/logs. Четвёртое — инструкции самого MCP server, способные влиять на поведение агента.
Для первой проверки используйте отдельный test credential с минимальным scope, безопасный read-only tool и объект без персональных данных. Не используйте production delete/update/create как негативный тест. Если нужен отказ, применяйте несуществующий тестовый ID, disabled state, исключённый tool либо недействительный временный credential.
Пошаговые действия
- Определите, какие переменные действительно нужны child process.
- Для секрета создайте отдельный краткоживущий credential.
- Добавьте local server, повторяя
--envдля каждой пары. - Не помещайте реальное значение в tracked shell script или screenshot.
- Проверьте get без
--show-secretsи убедитесь в наличии структуры env. - Выполните read-only tool, которому нужен credential.
- Проверьте server-side audit log и отсутствие token в stdout/stderr.
- После теста отзовите credential и удалите server либо обновите безопасным значением.
После каждого изменения снова запускайте list/get и открывайте новую CLI session, если проверяется persistence. Старый процесс мог загрузить конфигурацию до изменения. Для remote server сопоставляйте client result с server-side audit log; для local process дополнительно проверяйте command path и отсутствие секретов в stdout/stderr.
Готовый шаблон для копирования
Заполните карточку в change request:
Server: internal-search
Transport: stdio
Env names: API_BASE, API_TOKEN
Secret source: <vault/CI secret>
PATH вручную не добавляем
Read-only test: search
Логи проверены на утечку: да
Credential rotation: <дата/действие>
Дата проверки официальной документации: 13.09.2026
Источник: https://docs.github.com/en/copilot/reference/copilot-cli-reference/cli-command-reference
Готовый prompt для внутреннего помощника:
Подготовь безопасный план изменения MCP в GitHub Copilot CLI.
Используй только факты из заполненной карточки. Не придумывай status,
tools, transport, token, exit code или успешный результат.
Раздели ответ на: baseline, точную команду, позитивный read-only тест,
негативный тест без изменения данных, критерии успеха, очистку и откат.
Любой отсутствующий факт пометь «нужно проверить вручную».
<вставьте карточку>
Реалистичный пример входа и результата
Вход. Локальный process требует API_BASE и краткоживущий API_TOKEN для search, но не должен видеть deployment keys.
Ожидаемый результат. Server запускается с двумя нужными variables, search работает, token не печатается. PATH не дублируется, а credential после теста отзывается.
Не считайте текстовое сообщение агента доказательством. Подтверждение — это list/get, JSON-поле, отсутствие tool в новой session, успешный безопасный вызов, явный отказ или audit event. Сохраните только несекретные признаки: timestamp, server name, tool name, status и request ID.
Позитивный и негативный тест
Позитивный тест отвечает на вопрос: работает ли минимально разрешённая возможность? Используйте read-only tool и заранее известный объект. Запишите expected output без закрытого содержимого. Проверьте exit code и фактический status.
Негативный тест отвечает на вопрос: действительно ли граница закрыта? Меняйте только одно условие. Например, отключите server, обратитесь к исключённому tool или используйте invalid test credential. Если меняются одновременно transport, name и permissions, причина результата становится неясной.
Если тест завис, не повышайте timeout и права вслепую. Сначала разделите discovery, соединение, authentication и конкретный tool call. Проверьте DNS/TLS для remote transport, executable/args для stdio, enabled status и tool filter. Затем повторите один минимальный вызов.
Типичные ошибки
- Хранить token в репозитории.
- Передавать все variables родительского shell.
- Дублировать PATH без причины.
- Показывать secrets через диагностическую опцию.
Общая опасная ошибка — включить all tools или вывести secrets ради быстрой диагностики. Это расширяет последствия prompt injection и оставляет credentials в логах. Используйте least privilege, краткоживущие токены, redaction и отдельный audit trail. После эксперимента удаляйте временные конфигурации и отзывайте credentials у issuer.
Чек-лист финальной проверки
- Свежий каталог публикаций проверен; title и slug уникальны.
- Команда сверена с официальной документацией на 13.09.2026.
- Server source, transport, name и enabled status записаны.
- Разрешён только минимальный набор tools.
- Секреты отсутствуют в prompt, history, screenshots и shared logs.
- Позитивный read-only тест выполнен.
- Негативный тест не изменяет production data.
- Проверены list/get и новая CLI session.
- Для remote вызова сопоставлен server audit log.
- Откат и отзыв credentials выполнены или документированы.
FAQ
Можно ли повторять --env?
Да, опция repeatable.
Нужно ли передавать PATH?
Нет, документация говорит, что PATH включается по умолчанию.
Как вводится env в интерактивной форме?
Comma-separated KEY=VALUE или JSON object.
Удаляет ли server token у issuer?
Нет, credential нужно отзывать отдельно.
Итог
MCP-настройка считается готовой не после появления server в списке, а после подтверждения минимального tool set, безопасной аутентификации, позитивного и негативного тестов. Храните несекретную карточку вместе с изменением. При обновлении CLI повторяйте инвентаризацию и перепроверяйте официальный reference: команды, defaults и доступность могут измениться.
Читайте также
Как добавить HTTP MCP-сервер в Copilot CLI
Подключение remote MCP server через copilot mcp add --transport http: URL, headers, проверка tools и безопасная диагностика.
Как добавить локальный MCP-сервер в Copilot CLI
Подключение локального stdio MCP server через copilot mcp add: команда после --, проверка tools, sandbox status и безопасный откат.
Как настроить timeout MCP-сервера в Copilot CLI
Настройка --timeout для MCP tool discovery и вызовов: измеримый тест, диагностика задержки и отказ без выдуманных значений.
Комментарии
Пока тихо. Скажите первое слово