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

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

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

Примечание.

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

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

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

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

В интерактивном режиме введите /mcp add. Отображается форма конфигурации. Используйте вкладку для навигации между полями.
Рядом с именем сервера введите уникальное имя для MCP-сервера. Это имя, которое вы будете использовать для обозначения сервера.
```
       **Рядом с типом сервера** выберите тип, нажав соответствующее число. Доступны следующие типы:
```
* Локальный или STDIO: запускает локальный процесс и общается по стандартному входу/выводу (stdin/stdout). Оба варианта работают одинаково. STDIO — это стандартное название протокола MCP, поэтому выберите его, если хотите, чтобы ваша конфигурация была совместима с VS Code, Агент кодирования Copilot и другими клиентами MCP. * HTTP или SSE: подключается к удалённому MCP-серверу. HTTP использует потоковый HTTP-транспорт. SSE использует устаревший HTTP с транспортом Server-Sent Events, который устарел в спецификации MCP, но всё ещё поддерживается для обратной совместимости.
Оставшиеся поля зависят от выбранного типа сервера:
- Если вы выбрали локальную или 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"}`.
```
Рядом с разделом «Инструменты» укажите, какие инструменты с сервера должны быть доступны. Введите * , чтобы включить все инструменты, или предоставить список имён инструментов с разделёнными запятой (кавычки не требуются). Значение по умолчанию — *.
Нажмите 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": ["*"]
    }
  }
}

{
  "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 см. Расширение GitHub Copilot кодирующего агента с помощью протокола контекста модели (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-сервер и конкретные инструменты в запросе, чтобы убедиться, что они используются.

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

        [AUTOTITLE](/copilot/concepts/about-mcp)

        [AUTOTITLE](/copilot/how-tos/provide-context/use-mcp/extend-copilot-chat-with-mcp)

        [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/extend-coding-agent-with-mcp)