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 ao CLI do GitHub Copilot para fornecer ao 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 servidor MCP do GitHub é integrado ao 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 padrão do tipo de protocolo MCP. Portanto, escolha esta opção se deseja que sua configuração seja compatível com VS Code, Agente de codificação do Copilot e 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 Server-Sent Events, 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 Como estender o agente de codificação do GitHub Copilot com o MCP (Model Context Protocol).

Gerenciando servidores MCP

Você pode gerenciar seus servidores MCP configurados usando os seguintes comandos /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 é utilizado pelo Copilot na 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 automaticamente utilizar as ferramentas que ele oferece 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/coding-agent/extend-coding-agent-with-mcp)