Как добавить локальный MCP-сервер в Copilot CLI

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

Этот гайд решает конкретную задачу: добавить постоянный user-level MCP server, который запускается локальным процессом и общается по stdin/stdout. Он нужен администраторам и разработчикам, которые управляют Model Context Protocol в GitHub Copilot CLI и хотят доказуемо контролировать источники, инструменты и права. MCP server расширяет возможности агента, поэтому даже read-only интеграцию следует рассматривать как границу доверия.

Перед началом зафиксируйте пользователя, copilot version, рабочий каталог и цель изменения. Не добавляйте server «на будущее»: перечислите один сценарий, нужные tools и владельца. Сделайте baseline через list/get, чтобы после операции увидеть ровно ожидаемое изменение. Если конфигурация командная, оформляйте её через review, а секреты храните отдельно.

Проверенные факты и первоисточники

Не считайте текстовое сообщение агента доказательством. Подтверждение — это 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. Затем повторите один минимальный вызов.

Типичные ошибки

• Ставить непроверенный executable.
• Забывать разделитель --.
• Разрешать запись, когда нужно чтение.
• Путать stdout protocol с обычным логом.
• Не тестировать удаление.

Общая опасная ошибка — включить 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

Зачем нужен --?

Он отделяет аргументы copilot mcp add от команды локального server.

Куда пишется конфигурация?

В user-level ~/.copilot/mcp-config.json.

Как удалить server?

Командой copilot mcp remove для user-level записи.

Всегда ли будет статус sandboxed?

Нет, документация связывает его с запуском local server внутри sandbox и experimental mode.

Итог

MCP-настройка считается готовой не после появления server в списке, а после подтверждения минимального tool set, безопасной аутентификации, позитивного и негативного тестов. Храните несекретную карточку вместе с изменением. При обновлении CLI повторяйте инвентаризацию и перепроверяйте официальный reference: команды, defaults и доступность могут измениться.