Adicionando servidores MCP para CLI do GitHub Copilot

Estenda os recursos de Copilot conectando servidores MCP (Protocolo de Contexto do Modelo) para fornecer ferramentas e contexto adicionais.

Neste artigo

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). Você pode conectar servidores MCP a CLI do GitHub Copilot para fornecer Copilot acesso a ferramentas externas, fontes de dados e serviços. Para obter uma visão geral do MCP, consulte Sobre o Protocolo de Contexto de Modelo (MCP).

Adicionando um servidor MCP

Observação

O GitHub servidor MCP é integrado CLI do Copilot e já está disponível sem nenhuma configuração adicional. As etapas abaixo são para adicionar outros servidores MCP.

Se sua organização ou empresa tiver configurado uma URL do Registro e uma política de lista de permissões, essas configurações se aplicarão a CLI do Copilot. A URL do Registro configurada será exibida como uma fonte de descoberta e somente os servidores permitidos pela política de lista de permissões podem ser executados.

Você pode adicionar servidores MCP das seguintes maneiras:

Para obter instruções de instalação, ferramentas disponíveis e URLs para servidores MCP específicos, consulte o GitHub Registro MCP.

Usando o comando /mcp add

  1. No modo interativo, digite /mcp add. Um formulário de configuração é exibido. Use Tab para navegar entre campos.

  2. Ao lado do Nome do Servidor, insira um nome exclusivo para o servidor MCP. Esse é o nome que você usará para se referir ao servidor.

  3. Ao lado do Tipo de Servidor, selecione um tipo pressionando o número correspondente. Estão disponíveis os seguintes tipos:

    • Local ou STDIO: inicia um processo local e se comunica por entrada/saída padrão (stdin/stdout). Ambas as opções funcionam da mesma maneira. STDIO é o nome de tipo de protocolo MCP padrão, portanto, escolha-o se você quiser que sua configuração seja compatível com VS Code, o agente de nuvem Copilote outros clientes MCP.
    • HTTP ou SSE: conecta-se a um servidor MCP remoto. HTTP usa o transporte HTTP streamable. A SSE usa o HTTP legado com o transporte de eventos enviados pelo servidor, que é preterido na especificação do MCP, mas ainda é suportado para compatibilidade retroativa.

  4. Os campos restantes dependem do tipo de servidor selecionado:

    • Se você escolheu Local ou STDIO:

      • Próximo a Comando, insira o comando para iniciar o servidor, incluindo quaisquer argumentos. Por exemplo, npx @playwright/mcp@latest. Isso corresponde tanto às propriedades command quanto args no arquivo de configuração JSON.
      • Ao lado de Variáveis de Ambiente, opcionalmente especifique variáveis de ambiente de que o servidor precisa, como chaves de API ou tokens, como pares chave-valor JSON. Por exemplo, {"API_KEY": "YOUR-API-KEY"}. A PATH variável é herdada automaticamente do seu ambiente. Todas as outras variáveis de ambiente devem ser configuradas aqui.

    • Se você escolheu HTTP ou SSE:

      • Ao lado de URL, cole a URL do servidor remoto. Por exemplo, https://mcp.context7.com/mcp.
      • Ao lado de cabeçalhos HTTP, especifique opcionalmente cabeçalhos HTTP no formato JSON. Por exemplo, {"CONTEXT7_API_KEY": "YOUR-API-KEY"}.

  5. Ao lado das Ferramentas, especifique quais ferramentas do servidor devem estar disponíveis. Insira * para incluir todas as ferramentas ou forneça uma lista separada por vírgulas de nomes de ferramentas (sem aspas necessárias). O padrão é *.

  6. Pressione Ctrl+S para salvar a configuração. O servidor MCP é adicionado e está disponível imediatamente sem reiniciar a CLI.

Usando o subcomando copilot mcp add

Você pode adicionar servidores MCP do terminal usando o copilot mcp add subcomando, sem entrar no modo interativo. O servidor é adicionado à configuração do usuário em ~/.copilot/mcp-config.json.

Para servidores locais (stdio), forneça o comando após --:

Shell
copilot mcp add SERVER-NAME -- COMMAND [ARGS...]

Para servidores remotos (HTTP/SSE), especifique o transporte e forneça a URL:

Shell
copilot mcp add --transport http SERVER-NAME URL

Você também pode passar opções adicionais:

  • --env KEY=VALUE: defina variáveis de ambiente para o servidor. Repita para várias variáveis.
  • --header "HEADER: VALUE": defina cabeçalhos HTTP para servidores remotos. Repita para múltiplos cabeçalhos.
  • --transport TRANSPORT: defina o tipo de transporte (stdioouhttp``sse). O padrão é stdio.
  • --tools TOOLS: especifique quais ferramentas habilitar. Use * para todas as ferramentas (padrão), uma lista separada por vírgulas ou "" para nenhuma.
  • --timeout MS: defina um tempo limite em milissegundos.

Exemplos

Adicione um servidor stdio local:

Shell
copilot mcp add context7 -- npx -y @upstash/context7-mcp

Adicione um servidor local com variáveis de ambiente:

Shell
copilot mcp add github -e GITHUB_PERSONAL_ACCESS_TOKEN=YOUR_GITHUB_PAT -- docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server

Adicione um servidor HTTP remoto:

Shell
copilot mcp add --transport http notion \
  https://mcp.notion.com/mcp

Adicione um servidor remoto com um cabeçalho de autorização:

Shell
copilot mcp add --transport http \
  --header "Authorization: Bearer YOUR-TOKEN" \
  stripe https://mcp.stripe.com

Editando o arquivo de configuração

Você também pode adicionar servidores MCP editando o arquivo de configuração em ~/.copilot/mcp-config.json. Isso é útil se você quiser compartilhar configurações ou adicionar vários servidores ao mesmo tempo.

O exemplo a seguir mostra um arquivo de configuração com um servidor local e um servidor HTTP remoto:

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": ["*"]
    }
  }
}

Para obter mais informações sobre a configuração do servidor MCP, consulte Configurar servidores MCP para seu repositório.

Pesquisando e instalando no registro

Observação

No momento, o /mcp search comando é um recurso experimental. Para usá-lo, comece CLI do Copilot com a opção --experimental de linha de comando ou insira /experimental on durante uma sessão.

Você pode descobrir e instalar servidores MCP diretamente do GitHub Registro MCP usando o /mcp search comando no modo interativo. Isso permite que você navegue pelos servidores disponíveis, exiba seus detalhes e instale-os sem preencher manualmente o formulário de configuração.

Se sua organização tiver configurado uma URL personalizada do Registro MCP, /mcp search conecte-se a esse registro em vez do registro padrão GitHub .

  1. No modo interativo, insira /mcp search para procurar os principais servidores por estrelas ou /mcp search QUERY procurar um servidor específico. Por exemplo:

    /mcp search context7

  2. Uma lista navegável por teclado de servidores correspondentes é exibida. Use as teclas de direção para procurar os resultados.

  3. Selecione um servidor para abrir seu formulário de configuração. O formulário é preenchido previamente com a configuração do servidor do registro. Preencha todos os campos necessários, como chaves de API ou tokens.

  4. Pressione Ctrl+S para salvar. O servidor é adicionado ao seu mcp-config.json e iniciado imediatamente.

Gerenciando servidores MCP

Você pode gerenciar seus servidores MCP configurados usando os /mcp comandos no modo interativo ou os copilot mcp subcomandos do terminal.

Usar comandos /mcp no modo interativo

  • Listar servidores MCP configurados: Use o comando /mcp show. Isso exibe todos os servidores MCP configurados e seu status atual.

  • Exibir detalhes sobre um servidor específico: Use o comando /mcp show SERVER-NAME. Isso exibe o status do servidor especificado e a lista de ferramentas que ele fornece.

  • Edite a configuração de um servidor: Use o comando /mcp edit SERVER-NAME.

  • Excluir um servidor: Use o comando /mcp delete SERVER-NAME.

  • Desabilitar um servidor: Use o comando /mcp disable SERVER-NAME. Um servidor desabilitado permanece configurado, mas não é usado por Copilot para a sessão atual.

  • Habilite um servidor desabilitado anteriormente: Use o comando /mcp enable SERVER-NAME.

Usando os subcomandos copilot mcp no terminal

Você também pode gerenciar servidores MCP do terminal sem entrar no modo interativo.

  • Listar todos os servidores configurados:

    Shell
    copilot mcp list

    Lista servidores de todas as fontes de configuração (usuário, workspace e plug-in). Adicionar --json para saída JSON.

  • Exibir detalhes do servidor:

    Shell
    copilot mcp get SERVER-NAME

    Mostra o tipo, o status e as ferramentas disponíveis de um servidor. Adicionar --json para saída JSON.

  • Remova um servidor:

    Shell
    copilot mcp remove SERVER-NAME

    Remove o servidor da configuração do usuário.

Usando servidores MCP

Depois de adicionar um servidor MCP, Copilot pode usar automaticamente as ferramentas fornecidas quando forem relevantes para o seu prompt. Você também pode referenciar diretamente um servidor MCP e ferramentas específicas em um prompt para garantir que eles sejam usados.

Leitura adicional