Adicionando servidores MCP para CLI do GitHub Copilot

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.

Você pode adicionar servidores MCP usando o comando interativo /mcp add dentro da CLI ou editando o arquivo de configuração diretamente.

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`

No modo interativo, digite /mcp add. Um formulário de configuração é exibido. Use Tab para navegar entre campos.
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.

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. <!-- markdownlint-disable-line GHD046 -->

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"}.
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 é *.
Pressione Ctrl+S para salvar a configuração. O servidor MCP é adicionado e está disponível imediatamente sem reiniciar a CLI.

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

{
  "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 Estendendo o agente de nuvem do GitHub Copilot com o Protocolo de Contexto de Modelo (MCP).

Gerenciando servidores MCP

Você pode gerenciar seus servidores MCP configurados usando os comandos a seguir /mcp em CLI do Copilot.

        **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 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

        [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/cloud-agent/extend-cloud-agent-with-mcp)