{"meta":{"title":"Adicionando servidores MCP para GitHub Copilot CLI","intro":"Estenda os recursos de Copilot conectando servidores MCP (Protocolo de Contexto do Modelo) para fornecer ferramentas e contexto adicionais.","product":"GitHub Copilot","breadcrumbs":[{"href":"/pt/copilot","title":"GitHub Copilot"},{"href":"/pt/copilot/how-tos","title":"Instruções"},{"href":"/pt/copilot/how-tos/copilot-cli","title":"Copilot CLI"},{"href":"/pt/copilot/how-tos/copilot-cli/customize-copilot","title":"Personalizar Copilot CLI"},{"href":"/pt/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers","title":"Adicionar um servidor de MCP"}],"documentType":"article"},"body":"# Adicionando servidores MCP para GitHub Copilot CLI\n\nEstenda os recursos de Copilot conectando servidores MCP (Protocolo de Contexto do Modelo) para fornecer ferramentas e contexto adicionais.\n\nO 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 GitHub Copilot CLI 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)](/pt/copilot/concepts/context/mcp).\n\n## Adicionando um servidor MCP\n\n> \\[!NOTE]\n> O GitHub servidor MCP é integrado Copilot CLI e já está disponível sem nenhuma configuração adicional. As etapas abaixo são para adicionar outros servidores MCP.\n\nSe 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 Copilot CLI. 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.\n\nVocê pode adicionar servidores MCP das seguintes maneiras:\n\n* [Usando o `/mcp add` comando](#using-the-mcp-add-command)\n* [Usando o subcomando `copilot mcp add`](#using-the-copilot-mcp-add-subcommand)\n* [Editando o arquivo de configuração](#editing-the-configuration-file)\n* [Adicionando servidores MCP por repositório](#adding-per-repository-mcp-servers)\n* [Buscando e instalando no registro (experimental)](#searching-and-installing-from-the-registry)\n\nPara obter instruções de instalação, ferramentas disponíveis e URLs para servidores MCP específicos, consulte o [GitHub Registro MCP](https://github.com/mcp).\n\n### Usando o comando `/mcp add`\n\n1. No modo interativo, digite `/mcp add`. Um formulário de configuração é exibido. Use <kbd>Tab</kbd> para navegar entre campos.\n\n2. 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.\n\n3. Ao lado **do Tipo de Servidor**, selecione um tipo pressionando o número correspondente. Estão disponíveis os seguintes tipos:\n\n   * **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.\n     **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 Copilot cloud agente outros clientes MCP.\n   * **HTTP** ou **SSE**: conecta-se a um servidor MCP remoto.\n     **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 -->\n\n4. Os campos restantes dependem do tipo de servidor selecionado:\n\n   * Se você escolheu **Local** ou **STDIO**:\n\n     * 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.\n     * 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.\n\n   * Se você escolheu **HTTP** ou **SSE**:\n\n     * Ao lado de **URL**, cole a URL do servidor remoto. Por exemplo, `https://mcp.context7.com/mcp`.\n     * Ao lado de **cabeçalhos HTTP**, especifique opcionalmente cabeçalhos HTTP no formato JSON. Por exemplo, `{\"CONTEXT7_API_KEY\": \"YOUR-API-KEY\"}`.\n\n5. 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 é `*`.\n\n6. Pressione <kbd>Ctrl</kbd>+<kbd>S</kbd> para salvar a configuração. O servidor MCP é adicionado e está disponível imediatamente sem reiniciar a CLI.\n\n### Usando o subcomando `copilot mcp add`\n\nVocê 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`.\n\nPara servidores locais (stdio), forneça o comando após `--`:\n\n```shell copy\ncopilot mcp add SERVER-NAME -- COMMAND [ARGS...]\n```\n\nPara servidores remotos (HTTP/SSE), especifique o transporte e forneça a URL:\n\n```shell copy\ncopilot mcp add --transport http SERVER-NAME URL\n```\n\nVocê também pode passar opções adicionais:\n\n* `--env KEY=VALUE`: defina variáveis de ambiente para o servidor. Repita para várias variáveis.\n* `--header \"HEADER: VALUE\"`: defina cabeçalhos HTTP para servidores remotos. Repita para múltiplos cabeçalhos.\n* `--transport TRANSPORT`: defina o tipo de transporte (`stdio`ou`http``sse`). O padrão é `stdio`.\n* `--tools TOOLS`: especifique quais ferramentas habilitar. Use `*` para todas as ferramentas (padrão), uma lista separada por vírgulas ou `\"\"` para nenhuma.\n* `--timeout MS`: defina um tempo limite em milissegundos.\n\n#### Exemplos\n\nAdicione um servidor stdio local:\n\n```shell copy\ncopilot mcp add context7 -- npx -y @upstash/context7-mcp\n```\n\nAdicione um servidor local com variáveis de ambiente:\n\n```shell copy\ncopilot 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\n```\n\nAdicione um servidor HTTP remoto:\n\n```shell copy\ncopilot mcp add --transport http notion \\\n  https://mcp.notion.com/mcp\n```\n\nAdicione um servidor remoto com um cabeçalho de autorização:\n\n```shell copy\ncopilot mcp add --transport http \\\n  --header \"Authorization: Bearer YOUR-TOKEN\" \\\n  stripe https://mcp.stripe.com\n```\n\n### Editando o arquivo de configuração\n\nVocê 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.\n\nO exemplo a seguir mostra um arquivo de configuração com um servidor local e um servidor HTTP remoto:\n\n```json copy\n{\n  \"mcpServers\": {\n    \"playwright\": {\n      \"type\": \"local\",\n      \"command\": \"npx\",\n      \"args\": [\"@playwright/mcp@latest\"],\n      \"env\": {},\n      \"tools\": [\"*\"]\n    },\n    \"context7\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.context7.com/mcp\",\n      \"headers\": {\n        \"CONTEXT7_API_KEY\": \"YOUR-API-KEY\"\n      },\n      \"tools\": [\"*\"]\n    }\n  }\n}\n```\n\nPara obter mais informações sobre a configuração do servidor MCP, consulte [Configurar servidores MCP para seu repositório](/pt/copilot/how-tos/copilot-on-github/customize-copilot/configure-mcp-servers#writing-a-json-configuration-for-mcp-servers).\n\n### Adicionando servidores MCP por repositório\n\nVocê pode configurar servidores MCP para um projeto específico adicionando um arquivo JSON ao repositório. Isso é útil quando você deseja que os servidores estejam disponíveis somente ao trabalhar nesse projeto ou quando você quiser compartilhar uma configuração do MCP com colaboradores, comprometendo-a com o repositório.\n\nCopilot CLI procura a configuração no nível do projeto nos seguintes locais:\n\n| Caminho                                                                                              | Uso recomendado                                                               |\n| ---------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- |\n| `.mcp.json` (em qualquer diretório, a partir do seu diretório de trabalho até a raiz do repositório) | Configuração local ou por checkout; geralmente localizada na raiz do projeto. |\n| `.github/mcp.json`                                                                                   | Configuração compartilhada enviada ao repositório                             |\n\nQuando você começa Copilot CLI dentro de um repositório Git, a CLI caminha do diretório de trabalho atual até a raiz do repositório, carregando arquivos de configuração MCP ao longo do caminho. Se ambos `.mcp.json` e `.github/mcp.json` existirem no mesmo diretório, `.mcp.json` terá precedência. Quando os nomes de servidor entram em conflito, as definições em arquivos mais próximos do diretório de trabalho têm precedência. As definições no nível do projeto também têm precedência sobre aquelas em `~/.copilot/mcp-config.json`. Para obter mais informações sobre a relação de confiança relativa, consulte [referência de comando da CLI GitHub Copilot](/pt/copilot/reference/copilot-cli-reference/cli-command-reference#mcp-server-trust-levels).\n\nArquivos no nível do projeto podem usar o objeto de nível superior `mcpServers`, mostrado em `~/.copilot/mcp-config.json`, ou o formato simples de nível superior, em que cada chave é o nome de um servidor MCP. Por exemplo, essa configuração usa o `mcpServers` objeto:\n\n```json copy\n{\n  \"mcpServers\": {\n    \"playwright\": {\n      \"type\": \"local\",\n      \"command\": \"npx\",\n      \"args\": [\"@playwright/mcp@latest\"]\n    }\n  }\n}\n```\n\nO mesmo servidor também pode ser configurado com o formato de nível superior nu:\n\n```json copy\n{\n  \"playwright\": {\n    \"type\": \"local\",\n    \"command\": \"npx\",\n    \"args\": [\"@playwright/mcp@latest\"]\n  }\n}\n```\n\n> \\[!NOTE]\n> Os servidores MCP no nível do projeto são carregados somente depois que você confirma que confia na pasta na primeira execução. Eles são ignorados sem aviso em diretórios não confiáveis. Para obter mais informações sobre a confiabilidade da pasta, consulte [Sobre GitHub Copilot CLI](/pt/copilot/concepts/agents/copilot-cli/about-copilot-cli#trusted-directories).\n\nNo modo de prompt (`copilot -p`), os servidores MCP no nível do projeto serão carregados automaticamente se o diretório atual já for confiável. Se o diretório não for confiável, os servidores MCP no nível do projeto serão ignorados por padrão. Para carregá-los mesmo assim, defina a variável de ambiente `GITHUB_COPILOT_PROMPT_MODE_WORKSPACE_MCP` como `true`, já que o modo de prompt não pode exibir um prompt de confiança interativo. Para obter mais informações, consulte [referência de comando da CLI GitHub Copilot](/pt/copilot/reference/copilot-cli-reference/cli-command-reference#environment-variables).\n\nO arquivo `.vscode/mcp.json` para VS Code não é lido por Copilot CLI. Ele usa a chave de nível superior `servers` sem suporte. Para migrar um existente `.vscode/mcp.json` para um formato que a CLI aceita, consulte [referência de comando da CLI GitHub Copilot](/pt/copilot/reference/copilot-cli-reference/cli-command-reference#migrating-from-vscodemcpjson).\n\n### Pesquisando e instalando no registro\n\n> \\[!NOTE]\n> No momento, o `/mcp search` comando é um recurso experimental. Para usá-lo, comece Copilot CLI com a opção `‑‑experimental` de linha de comando ou insira `/experimental on` durante uma sessão.\n\nVocê pode descobrir e instalar servidores MCP diretamente do [GitHub Registro MCP](https://github.com/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.\n\nSe 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 .\n\n1. No modo interativo, insira `/mcp search` para procurar os principais servidores por estrelas ou `/mcp search QUERY` procurar um servidor específico. Por exemplo:\n\n   ```text\n   /mcp search context7\n   ```\n\n2. Uma lista navegável por teclado de servidores correspondentes é exibida. Use as teclas de direção para procurar os resultados.\n\n3. 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.\n\n4. Pressione <kbd>Ctrl</kbd>+<kbd>S</kbd> para salvar. O servidor é adicionado ao seu `mcp-config.json` e iniciado imediatamente.\n\n## Gerenciando servidores MCP\n\nVocê pode gerenciar seus servidores MCP configurados usando os `/mcp` comandos no modo interativo ou os `copilot mcp` subcomandos do terminal.\n\n### Usar comandos `/mcp` no modo interativo\n\n* **Listar servidores MCP configurados:** Use o comando `/mcp show`. Isso exibe todos os servidores MCP configurados e seu status atual.\n\n* **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.\n\n* **Edite a configuração de um servidor:** Use o comando `/mcp edit SERVER-NAME`.\n\n* **Excluir um servidor:** Use o comando `/mcp delete SERVER-NAME`.\n\n* **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.\n\n* **Habilite um servidor desabilitado anteriormente:** Use o comando `/mcp enable SERVER-NAME`.\n\n### Usando os subcomandos `copilot mcp` no terminal\n\nVocê também pode gerenciar servidores MCP do terminal sem entrar no modo interativo.\n\n* **Listar todos os servidores configurados:**\n\n  ```shell copy\n  copilot mcp list\n  ```\n\n  Lista servidores de todas as fontes de configuração (usuário, workspace e plug-in). Adicionar `--json` para saída JSON.\n\n* **Exibir detalhes do servidor:**\n\n  ```shell copy\n  copilot mcp get SERVER-NAME\n  ```\n\n  Mostra o tipo, o status e as ferramentas disponíveis de um servidor. Adicionar `--json` para saída JSON.\n\n* **Remova um servidor:**\n\n  ```shell copy\n  copilot mcp remove SERVER-NAME\n  ```\n\n  Remove o servidor da configuração do usuário.\n\n## Usando servidores MCP\n\nDepois 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.\n\n## Leitura adicional\n\n* [Sobre o Protocolo de Contexto de Modelo (MCP)](/pt/copilot/concepts/context/mcp)\n* [Estendendo o GitHub Copilot Chat com servidores MCP (Protocolo de Contexto do Modelo)](/pt/copilot/how-tos/provide-context/use-mcp-in-your-ide/extend-copilot-chat-with-mcp)\n* [Configurar servidores MCP para seu repositório](/pt/copilot/how-tos/copilot-on-github/customize-copilot/configure-mcp-servers)"}