Como estender o GitHub Copilot Chat com o MCP (Protocolo de Contexto do Modelo)

Saiba como usar o MCP (Protocolo de Contexto de Modelo) para estender o Copilot Chat.

Neste artigo

Introdução

O MCP (Protocolo de Contexto de Modelo) é um padrão aberto que define como os aplicativos compartilham contexto com os LLMs (modelos de linguagem grande). Para obter uma visão geral do MCP, consulte Sobre o Protocolo de Contexto de Modelo (MCP).

Para obter informações sobre servidores MCP disponíveis no momento, confira o repositório de servidores MCP.

Empresas e organizações podem optar por habilitar ou desabilitar o uso do MCP para membros de sua organização ou empresa. Confira Gerenciar políticas e recursos do GitHub Copilot em sua empresa. A política de MCP se aplica somente a usuários que têm uma assinatura do Copilot Business ou Copilot Enterprise de uma organização ou empresa que configura a política. O acesso do MCP do Copilot Free, o Copilot Pro ou o Copilot Pro+ não é regido por esta política.

Pré-requisitos

  • Acesso ao Copilot. Confira O que é o GitHub Copilot?.
  • Visual Studio Code versão 1.99 ou posterior. Para obter informações sobre como instalar o Visual Studio Code, confira a página de download do Visual Studio Code.
  • If you are a member of an organization or enterprise with a Copilot Business or Copilot Enterprise plan, the "MCP servers in Copilot" policy must be enabled in order to use MCP with Copilot.

Como configurar servidores MCP no Visual Studio Code

Os servidores MCP podem ser configurados manualmente em um arquivo de configuração ou por meio do Registro MCP do GitHub. O Registro MCP do GitHub fornece uma lista selecionada de servidores MCP que você pode adicionar facilmente à instância do Visual Studio Code.

Usando o Registro MCP do GitHub

Observação

O Registro MCP do GitHub está em versão prévia pública e pode mudar.

Somente os servidores MCP listados no Registro MCP do GitHub podem ser adicionados por meio do registro. Outros servidores podem ser configurados manualmente. Consulte Configurando servidores MCP manualmente.

  1. Visite o Registro MCP do GitHub.
  2. Na barra de pesquisa, pesquise o servidor MCP que deseja adicionar e clique nele na lista de correspondências.
  3. Na página do servidor MCP, leia a descrição para obter detalhes sobre os requisitos de instalação e outras informações importantes sobre o uso. Isso pode variar entre os servidores.
  4. Clique em Install server e selecione Install in VS Code.
  5. O Visual Studio Code será aberto na página do Marketplace do servidor. Clique em Install para adicionar o servidor MCP à sua instância do Visual Studio Code.
  6. Se mais configurações forem necessárias, siga as instruções na página do servidor MCP no Registro MCP do GitHub.
  7. Para verificar se o servidor MCP foi adicionado, no modo de agente do Copilot Chat, clique no ícone de ferramentas. Aparecerá uma lista de seleção mostrando todos os servidores MCP e as ferramentas associadas que estão disponíveis atualmente em sua instância do Visual Studio Code.

Configurando servidores MCP manualmente

Para configurar servidores MCP no Visual Studio Code, você precisa configurar um script de configuração que especifique os detalhes dos servidores MCP que você deseja usar. Você pode configurar servidores MCP para:

  • Um repositório específico. Isso permite que você compartilhe servidores de MCP com qualquer pessoa que abra o projeto no Visual Studio Code. Para fazer isso, crie um arquivo .vscode/mcp.json na raiz do repositório.

  • Sua instância pessoal do Visual Studio Code. Você será a única pessoa que terá acesso a servidores MCP configurados. Para fazer isso, adicione a configuração ao arquivo settings.json no Visual Studio Code. Os servidores de MCP configurados dessa forma ficarão disponíveis em todos os workspaces.

    Observação

    We recommend you use only one location per server. Adding the same server to both locations may cause conflicts and unexpected behavior.

As etapas abaixo mostram como configurar o servidor Fetch MCP em seu arquivo .vscode/mcp.json. O servidor Fetch MCP é um servidor MCP simples que fornece funcionalidades de busca de conteúdo na Web. Para obter mais informações sobre o servidor Fetch MCP, confira o diretório Fetch no repositório do servidor MCP.

É possível usar as mesmas etapas para configurar servidores MCP em suas configurações pessoais do Visual Studio Code. Detalhes sobre como configurar outros servidores MCP estão disponíveis no repositório de servidores MCP.

Para obter informações sobre como configurar o servidor de MCP do GitHub, consulte Como usar o Servidor de MCP do GitHub.

  1. Adicione a seguinte configuração ao arquivo .vscode/mcp.json:

    JSON
    {
"inputs": [
  // The "inputs" section defines the inputs required for the MCP server configuration.
  {
    "type": "promptString"
  }
],
"servers": {
  // The "servers" section defines the MCP servers you want to use.
  "fetch": {
    "command": "uvx",
    "args": ["mcp-server-fetch"]
  }
 }
}

  2. Salve o arquivo .vscode/mcp.json.

  3. Um botão "Start" aparecerá no arquivo .vscode/mcp.json, na parte superior da lista de servidores. Clique no botão "Start" para iniciar os servidores MCP. Isso disparará a caixa de diálogo de entrada e descobrirá as ferramentas do servidor, que são armazenadas para sessões posteriores.

    Captura de tela da configuração do servidor MCP no Visual Studio Code. O botão "Start" está contornado em laranja escuro.

  4. Abra o Copilot Chat clicando no ícone na barra de título do Visual Studio Code.

  5. Na caixa do Copilot Chat, selecione Agent no menu pop-up.

    Captura de tela da caixa do Copilot Chat no Visual Studio Code. A opção "Agent" está destacada em laranja escuro.

  6. Para exibir sua lista de servidores MCP disponíveis, clique no ícone de ferramentas no canto superior esquerdo da caixa de chat. Isso abrirá a lista de servidores MCP, em que você poderá ver todos os servidores MCP e ferramentas associadas que estão disponíveis atualmente em sua instância do Visual Studio Code.

    • Opcionalmente, você pode definir conjuntos de ferramentas, grupos de ferramentas relacionadas que podem ser referenciadas no chat. Os conjuntos de ferramentas facilitam o agrupamento de ferramentas de MCP relacionadas e as habilitam ou desabilitam rapidamente. Para obter informações sobre como definir e usar um conjunto de ferramentas, consulte a documentação do VS Code.

Para obter mais informações sobre como configurar servidores MCP no Visual Studio Code, confira Usar servidores MCP no Visual Studio Code na documentação do Visual Studio Code.

Como usar servidores MCP no Copilot Chat

Depois de configurar seus servidores MCP, você poderá usá-los no Copilot Chat para acessar uma ampla gama de ferramentas e serviços. No exemplo abaixo, usaremos o servidor Fetch MCP para buscar detalhes sobre uma página da Web.

  1. Abra o Copilot Chat clicando no ícone na barra de título do Visual Studio Code.

  2. Na caixa do Copilot Chat, selecione Agent no menu pop-up.

  3. No arquivo com a configuração do MCP, verifique se o servidor MCP está em execução. Se ele não estiver em execução, clique no botão "Start" para iniciar o servidor MCP.

    Captura de tela da configuração do servidor MCP no Visual Studio Code. O status "Running" está contornado em laranja escuro.

  4. Peça ao Copilot Chat para buscar os detalhes de uma URL. Por exemplo:

    Fetch https://github.com/github/docs.

  5. Se o Copilot solicitar que você confirme se deseja continuar, clique em Continue.

  6. O Copilot buscará os detalhes da URL e os exibirá na caixa de chat.

Você também pode usar prompts e recursos do MCP no VS Code.

  • Os servidores de MCP podem definir solicitações pré-configuradas para interagir com suas ferramentas. Você pode acessar essas solicitações no chat com comandos de barra usando o formato /mcp.servername.promptname.
  • Os servidores de MCP fornecem recursos, que são qualquer tipo de dados que o servidor deseja disponibilizar. Por exemplo, o servidor de MCP do GitHub fornece conteúdo de repositório como um recurso. Para adicionar recursos de um servidor de MCP ao contexto do chat, clique em Adicionar Contexto... na caixa de chat e clique em Recursos do MCP.

Para obter mais informações sobre como usar servidores MCP no Visual Studio Code, confira Usar servidores MCP no Visual Studio Code na documentação do Visual Studio Code.

Como usar configurações de MCP existentes

Se você já tiver uma configuração de MCP no Claude Desktop, poderá usar essa configuração no Visual Studio Code para acessar os mesmos servidores MCP. Para fazer isso, adicione a seguinte configuração ao arquivo settings.json no Visual Studio Code:

JSON
"chat.mcp.discovery.enabled": true

O Visual Studio Code localizará automaticamente sua configuração existente e a usará em sua instância do Visual Studio Code.

Pré-requisitos

  • Acesso ao Copilot. Confira O que é o GitHub Copilot?.
  • Visual Studio versão 17.14 ou posterior. Para obter mais informações sobre como instalar o Visual Studio, confira a página de downloads do Visual Studio.
  • Inicie a sessão do GitHub no Visual Studio.
  • If you are a member of an organization or enterprise with a Copilot Business or Copilot Enterprise plan, the "MCP servers in Copilot" policy must be enabled in order to use MCP with Copilot.

Como configurar servidores MCP no Visual Studio

  1. Na barra de menus do Visual Studio, clique em Exibir e depois em GitHub Copilot Chat.

  2. Na parte inferior do painel de chat, selecione Agent na lista suspensa de modo.

  3. Na janela Copilot Chat, clique no ícone de ferramentas e no ícone de adição na janela do seletor de ferramentas.

  4. Na janela pop-up "Configure MCP server", preencha os campos, incluindo a ID do servidor, o tipo e os campos adicionais necessários para a configuração específica do servidor MCP.

    O Visual Studio dá suporte a servidores remotos e locais. Os servidores remotos, definidos com uma URL e credenciais, são hospedados externamente para facilitar a configuração e o compartilhamento, enquanto os servidores locais, definidos com invocação de linha de comando, são executados em seu computador local e podem acessar recursos locais. Veja as configurações de exemplo abaixo usando o servidor MCP do GitHub como exemplo.

  5. Clique em Save (Salvar).

  6. Se você estiver usando um servidor remoto com autenticação OAuth, no arquivo, mcp.json clique em Auth no CodeLens acima do servidor para autenticar no servidor. Uma janela pop-up ou nova será exibida, permitindo que você se autentique com sua conta. O servidor só poderá acessar os escopos que você aprova e que as políticas da sua organização permitem.

  7. Na janela Copilot Chat, clique no ícone de ferramentas. Agora você deve ver ferramentas adicionais do servidor MCP que você configurou.

Exemplo de configuração de servidor remoto com OAuth

  1. Para "Server ID", digite github.

  2. Para "Type", selecione "HTTP/SSE" na lista suspensa.

  3. Para "URL", digite https://api.githubcopilot.com/mcp/.

  4. Depois de clicar em Salve, a configuração no arquivo mcp.json deverá ter esta aparência:

    JSON
        {
      "servers": {
        "github": {
          "url": "https://api.githubcopilot.com/mcp/"
        }
      }
    }

  5. No arquivo mcp.json, clique em Auth no CodeLens acima do servidor para autenticar no servidor. Um pop-up será exibido permitindo que você se autentique com sua conta do GitHub.

Exemplo de configuração do servidor local

  1. Para "Server ID", digite github.

  2. Para "Type", selecione "stdio" na lista suspensa.

  3. Para "Command (with optional arguments)", digite docker "run", "-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/github/github-mcp-server"

  4. Adicione uma variável de ambiente "GITHUB_PERSONAL_ACCESS_TOKEN" definida para seu personal access token.

  5. Depois de clicar em Salve, a configuração no arquivo mcp.json deverá ter esta aparência:

    JSON
        {
      "servers": {
        "github": {
          "type": "stdio",
          "command": "docker",
          "args": [
            "run", "-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN",
            "ghcr.io/github/github-mcp-server"
          ],
          "env": {
            "GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_PAT"
          }
        }
      }
    }

Para obter mais informações sobre como configurar servidores MCP no Visual Studio, confira Usar servidores MCP no Visual Studio (versão prévia) na documentação do Visual Studio.

Pré-requisitos

  • Acesso ao Copilot. Confira O que é o GitHub Copilot?.

  • Um IDE da JetBrains compatível. O GitHub Copilot é compatível com as seguintes IDEs:

    • IntelliJ IDEA (Ultimate, Community, Educational)
    • Android Studio
    • AppCode
    • CLion
    • Code With Me Guest
    • DataGrip
    • DataSpell
    • GoLand
    • JetBrains Client
    • MPS
    • PhpStorm
    • PyCharm (Professional, Community, Educational)
    • Rider
    • RubyMine
    • RustRover
    • WebStorm
    • Lado do escritor

    Consulte o localizador de ferramentas JetBrains IDEs para fazer o download.

  • If you are a member of an organization or enterprise with a Copilot Business or Copilot Enterprise plan, the "MCP servers in Copilot" policy must be enabled in order to use MCP with Copilot.

Como configurar servidores MCP em IDEs do JetBrains

  1. In the lower right corner, click .
  2. From the menu, select "Open Chat", make sure you are in Agent mode, then click the tools icon (called "Configure your MCP server") at the bottom of the chat window.
  3. Click Add MCP Tools.
  4. No arquivo mcp.json, defina seus servidores MCP. Os IDEs do JetBrains dão suporte a servidores remotos e locais. Os servidores remotos são hospedados externamente para facilitar a configuração e o compartilhamento, enquanto os servidores locais são executados em seu computador local e podem acessar recursos locais.

Você pode usar as seguintes configurações como exemplos:

Exemplo de configuração de servidor remoto com PAT

JSON
{
    "servers": {
        "github": {
            "url": "https://api.githubcopilot.com/mcp/",
            "requestInit": {
                "headers": {
                    "Authorization": "Bearer YOUR_PAT_HERE"
                }
            }
        }
    }
  }

Exemplo de configuração do servidor local

JSON
{
  "servers": {
    "memory": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-memory"
      ]
    }
  }
}

Pré-requisitos

Como configurar servidores MCP no Xcode

  1. Open the GitHub Copilot for Xcode extension and go to "Settings".
    • Alternatively, in an active Xcode workspace, you can find the settings by clicking Editor in the menu bar, selecting GitHub Copilot, then clicking Open GitHub Copilot for Xcode Settings.
  2. Select the MCP tab, then click Edit Config.
  3. Defina seus servidores MCP editando mcp.json. O Xcode dá suporte a servidores remotos e locais. Os servidores remotos são hospedados externamente para facilitar a configuração e o compartilhamento, enquanto os servidores locais são executados em seu computador local e podem acessar recursos locais.

Você pode usar as seguintes configurações como exemplos:

Exemplo de configuração de servidor remoto com PAT

JSON
{
    "servers": {
        "github": {
            "url": "https://api.githubcopilot.com/mcp/",
            "requestInit": {
                "headers": {
                    "Authorization": "Bearer YOUR_PAT_HERE"
                }
            }
        }
    }
  }

Exemplo de configuração do servidor local

JSON
{
  "servers": {
    "memory": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-memory"
      ]
    }
  }
}

Pré-requisitos

Como configurar servidores MCP no Eclipse

  1. Click the Copilot icon () in the status bar at the bottom of Eclipse.
  2. From the menu, select Open Chat and, in the chat window, click the "Configure Tools..." icon.
    • Alternatively, you can select Edit preferences, then in the left pane, expand GitHub Copilot and click MCP.
  3. Em "Server Configurations", defina seus servidores MCP. O Eclipse dá suporte a servidores remotos e locais. Os servidores remotos são hospedados externamente para facilitar a configuração e o compartilhamento, enquanto os servidores locais são executados em seu computador local e podem acessar recursos locais.

Você pode usar as seguintes configurações como exemplos:

Exemplo de configuração de servidor remoto com PAT

JSON
{
    "servers": {
        "github": {
            "url": "https://api.githubcopilot.com/mcp/",
            "requestInit": {
                "headers": {
                    "Authorization": "Bearer YOUR_PAT_HERE"
                }
            }
        }
    }
  }

Exemplo de configuração do servidor local

JSON
{
  "servers": {
    "memory": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-memory"
      ]
    }
  }
}

Como criar um servidor MCP

É possível criar um servidor MCP para atender às suas necessidades específicas e integrá-lo ao Copilot Chat. Por exemplo, você pode criar um servidor MCP que se conecta a um banco de dados ou a um serviço Web e, em seguida, usar esse servidor no Copilot Chat para executar tarefas nesse banco de dados ou serviço Web.

Para obter mais informações sobre como criar e configurar seus próprios servidores MCP, confira a documentação oficial do MCP.

Leitura adicional