Como compartilhar configurações MCP entre VS Code e Copilot

Para compartilhar servidores MCP entre VS Code e GitHub Copilot, mantenha arquivos de configuração separados: o VS Code usa .vscode/mcp.json, com a chave servers; o formato portátil do Copilot usa .mcp.json, com mcpServers. Uma definição comum pode servir de origem para gerar arquivos diferentes, mas os formatos não são intercambiáveis e o portátil não preserva todos os recursos do VS Code.

MCP é o Model Context Protocol, um padrão que permite a clientes de IA acessar ferramentas oferecidas por servidores. Se você mantém esses servidores para uma equipe, o ponto principal é decidir quais recursos cada ambiente precisa antes de distribuir os arquivos.

Escolha o formato conforme o cliente

A documentação da Microsoft sobre configuração MCP distingue o formato próprio do VS Code do formato portátil lido diretamente pelas sessões do harness do Copilot, o ambiente de execução de agentes. Os caminhos e as chaves principais são diferentes:

O formato do VS Code também aceita variáveis de entrada interativas. Já uma sessão do harness do Copilot lê diretamente os arquivos portáteis; ela não lê .vscode/mcp.json por conta própria. O VS Code pode encaminhar servidores de sua configuração para essas sessões, mas não encaminha os que dependem de valores ${input:...}.

Monte arquivos separados sem perder recursos necessários

1. Defina o escopo da configuração. Escolha entre um arquivo no espaço de trabalho e um arquivo de usuário para cada ambiente. O primeiro fica associado ao projeto; o segundo é colocado no perfil do usuário correspondente.
2. Use a estrutura do VS Code no arquivo do VS Code. Para um espaço de trabalho, o caminho documentado é .vscode/mcp.json, com os servidores sob servers.
3. Crie uma saída portátil para o Copilot. No espaço de trabalho, use .mcp.json e a chave mcpServers. Para uma configuração de usuário, use o caminho do Copilot indicado na tabela.
4. Revise os recursos antes de migrar. O formato portátil não oferece prompts de entrada, envFile, modo de desenvolvimento nem configurações de sandbox por servidor. Se sua configuração do VS Code depende de algum desses recursos, uma conversão para o formato portátil não o manterá.

As referências de variáveis também precisam corresponder ao formato: o VS Code documenta ${env:NAME}; os arquivos portáteis aceitam ${NAME} ou ${NAME:-default}. No cliente MCP do VS Code, $NAME sem chaves é tratado como texto literal.

Audite os arquivos e teste o servidor separadamente

Uma auditoria estrutural pode verificar se o JSON é válido e se as chaves e referências de variáveis seguem o formato esperado. Ela não demonstra que o servidor inicia, autentica, conecta ou disponibiliza as ferramentas pretendidas.

Em um tutorial publicado em 2 de novembro de 2026, a autora da Tech Insider descreveu um gerador que parte de uma fonte comum e produz arquivos para diferentes clientes. Ela relatou executar no Linux verificações de sintaxe JSON, chaves principais, formato das variáveis, valores parecidos com segredos e correspondência entre nomes de servidores. Para testar a operação, recomendou também usar o MCP Inspector e fazer uma chamada representativa em cada cliente. Esse teste de execução responde a uma pergunta diferente da auditoria dos arquivos.

Cursor em espaços de trabalho gerenciados

Para equipes que provisionam ambientes de desenvolvimento gerenciados, a Coder descreve outra abordagem: seu módulo recebe JSON MCP e o grava em ~/.cursor/mcp.json durante a inicialização do espaço de trabalho. A empresa apresenta essa configuração como parte de modelos Terraform com controle de versão. É uma via de provisionamento de configurações do Cursor nesses ambientes, separada da geração de arquivos para VS Code e Copilot.