Добавление MCP-серверов для GitHub Copilot CLI

Расширить Copilotвозможности , подключив серверы протокола Model Context Protocol (MCP) для предоставления дополнительных инструментов и контекста.

В этой статье

Протокол контекста модели (MCP) — это открытый стандарт, определяющий, как приложения используют контекст с большими языковыми моделями (LLM). Вы можете подключить MCP-серверы, GitHub Copilot CLI чтобы получить Copilot доступ к внешним инструментам, источникам данных и сервисам. Общие сведения о MCP см. в разделе О протоколе контекста модели (MCP).

Добавление сервера MCP

Примечание.

MCP-сервер встроен и GitHub уже доступен без дополнительной Второй пилот CLI конфигурации. Ниже приведены шаги для добавления других MCP-серверов.

Вы можете добавить MCP-серверы с помощью интерактивной /mcp add команды внутри CLI или напрямую редактировать конфигурационный файл.

Инструкции по установке, доступные инструменты и URL-адреса для конкретных серверов MCP см. GitHub Реестр MCP.

Использование /mcp add команды

  1. В интерактивном режиме введите /mcp add. Отображается форма конфигурации. Используйте вкладку для навигации между полями.

  2. Рядом с именем сервера введите уникальное имя для MCP-сервера. Это имя, которое вы будете использовать для обозначения сервера.

  3.        **Рядом с типом сервера** выберите тип, нажав соответствующее число. Доступны следующие типы:
    • Локальный или STDIO: запускает локальный процесс и общается по стандартному входу/выводу (stdin/stdout). Оба варианта работают одинаково. STDIO — это стандартное название протокола MCP, поэтому выберите его, если хотите, чтобы ваша конфигурация была совместима с VS Code, и Copilot облачный агентдругими MCP-клиентами.
    • HTTP или SSE: подключается к удалённому MCP-серверу. HTTP использует потоковый HTTP-транспорт. SSE использует устаревший HTTP с транспортом Server-Sent Events, который устарел в спецификации MCP, но всё ещё поддерживается для обратной совместимости.

  4. Оставшиеся поля зависят от выбранного типа сервера:

    • Если вы выбрали локальную или STDIO:

      • Рядом с командой введите команду для запуска сервера, включая любые аргументы. Например: npx @playwright/mcp@latest. Это соответствует свойствам и command``args в конфигурационном файле JSON.
      • Рядом с переменными среды, по желанию, указывайте переменные среды, необходимые серверу, такие как ключи API или токёны, в виде пар ключ-значение JSON. Например: {"API_KEY": "YOUR-API-KEY"}. Переменная PATH автоматически наследуется от вашей среды. Все остальные переменные среды должны быть настроены здесь.

    • Если вы выбрали HTTP или SSE:

      • Рядом с URL вставьте URL удалённого сервера. Например: https://mcp.context7.com/mcp.
      • Рядом с HTTP-заголовками, по желанию, указывайте HTTP-заголовки как JSON. Например: {"CONTEXT7_API_KEY": "YOUR-API-KEY"}.

  5. Рядом с разделом «Инструменты» укажите, какие инструменты с сервера должны быть доступны. Введите * , чтобы включить все инструменты, или предоставить список имён инструментов с разделёнными запятой (кавычки не требуются). Значение по умолчанию — *.

  6. Нажмите Ctrl+S , чтобы сохранить конфигурацию. MCP-сервер добавляется и доступен сразу без перезапуска CLI.

Редактирование конфигурационного файла

Вы также можете добавить MCP-серверы, отредактировав конфигурационный файл по ~/.copilot/mcp-config.jsonадресу . Это полезно, если вы хотите делиться конфигурациями или добавлять несколько серверов одновременно.

Следующий пример показывает конфигурационный файл с локальным сервером и удалённым HTTP-сервером:

JSON
{
  "mcpServers": {
    "playwright": {
      "type": "local",
      "command": "npx",
      "args": ["@playwright/mcp@latest"],
      "env": {},
      "tools": ["*"]
    },
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "CONTEXT7_API_KEY": "YOUR-API-KEY"
      },
      "tools": ["*"]
    }
  }
}

Для получения дополнительной информации о конфигурации сервера MCP см. Соединяйте агенты с внешними инструментами.

Управление серверами MCP

Вы можете управлять настроенными MCP-серверами с помощью следующих /mcp команд в Второй пилот CLI.

  • Список настроенных MCP-серверов: Используй команду /mcp show. Он отображает все настроенные MCP-серверы и их текущий статус.

  • Подробнее о конкретном сервере: Используй команду /mcp show SERVER-NAME. Он отображает статус указанного сервера и список предоставляемых им инструментов.

  • Редактировать конфигурацию сервера: Используй команду /mcp edit SERVER-NAME.

  • Удалить сервер: Используй команду /mcp delete SERVER-NAME.

  • Отключите сервер: Используй команду /mcp disable SERVER-NAME. Отключённый сервер остаётся настроенным, но не используется Copilot для текущей сессии.

  • Включите ранее отключённый сервер: Используй команду /mcp enable SERVER-NAME.

Использование серверов MCP

После добавления MCP-сервера можно Copilot автоматически использовать предоставленные инструменты по актуальности для вашего запроса. Вы также можете напрямую ссылаться на MCP-сервер и конкретные инструменты в запросе, чтобы убедиться, что они используются.

Дополнительные материалы