Configuração MCP no VS Code: use servers em vez de mcpServers

A diferença, lado a lado

Mesmo servidor, mesmo comando, mesmos argumentos. A única coisa que muda é a chave do envoltório.

O que o VS Code espera

No .vscode/mcp.json, na raiz do seu workspace. Usando o conector do MyLinedChart como exemplo:

{ "servers": { "mylinedchart": { "command": "npx", "args": ["-y", "@mylinedchart/mcp-chart-context"] } } }

Troque pelo command e pelos args do seu próprio servidor. O formato do objeto interno não muda entre os clientes.

O que todo o resto espera

O mesmo servidor, para o Claude ou o Cursor:

{ "mcpServers": { "mylinedchart": { "command": "npx", "args": ["-y", "@mylinedchart/mcp-chart-context"] } } }

Se você tem os dois editores abertos, precisa mesmo dos dois arquivos. Os dois editores não conseguem compartilhar uma única configuração.

Por que falha sem nenhum erro

O VS Code lê o arquivo, encontra um JSON válido e procura uma chave servers. O arquivo não tem a chave servers, então o VS Code encontra zero servidores para iniciar. Zero servidores não é uma condição de erro. Do ponto de vista do VS Code, você não configurou nada, o que é uma coisa perfeitamente legítima de se fazer.

Por isso não há sublinhado vermelho, nem notificação, nem registro em log algum dizendo que a chave estava errada. A falha parece exatamente um servidor travando na inicialização, e é por isso que as pessoas vão depurar o servidor.

• O arquivo é um JSON válido, então nenhum erro de leitura aparece.
• Uma chave de nível superior desconhecida é ignorada em vez de rejeitada.
• Zero servidores configurados é um estado normal, então o VS Code não reporta falha.

Como confirmar qual é o seu problema

Antes de presumir que o servidor está quebrado, prove que o VS Code chegou a tentar iniciá-lo.

• Verifique primeiro a chave do envoltório. A checagem leva cinco segundos e é a resposta na maioria das vezes.
• Execute o comando do servidor à mão em um terminal. Se o servidor iniciar, o problema está em outro lugar.
• Procure o servidor na lista de servidores MCP do VS Code. Ausente significa que nunca foi configurado; presente mas falhando significa um erro real de inicialização.
• Se você instalou por um link de um clique em vez de à mão, toda essa classe de problema não se aplica.

Duas armadilhas relacionadas

Já que você está aqui, duas outras coisas falham do mesmo jeito silencioso.

Primeiro, os links de instalação MCP de um clique levam o conteúdo como JSON simples codificado na URL. Base64 é aceito pelo leitor de URL e depois não faz nada em silêncio, que é a pior falha possível: um botão que parece ter funcionado.

Segundo, o nome do servidor viaja dentro do conteúdo no VS Code, em vez de ir em um parâmetro de consulta separado como o Cursor faz. Um link montado no formato do Cursor não instala corretamente no VS Code, mesmo que abra.

Onde o MyLinedChart entra

O MyLinedChart traz um conector MCP que dá a um agente de IA o seu gráfico ao vivo: ativos, seus desenhos, valores de indicadores e os candles na tela. O conector roda na sua máquina e os dados não passam pelos nossos servidores.

O app tem um botão Add to VS Code de um clique que grava a chave correta para você, e esse é o motivo para usá-lo em vez de editar à mão. Configuração e os outros clientes: /resources/articles/ibkr-chart-data-github-copilot-vs-code.

Próximo passo

Corrija a chave, reinicie o VS Code e o servidor aparece. Se o servidor ainda não aparecer, você agora sabe que o problema está no servidor e não na configuração, o que é uma lista bem mais curta para investigar.

Conecte sua IA em /mcp.

Perguntas frequentes

Por que o VS Code usa servers em vez de mcpServers?

A chave servers é uma escolha de nomenclatura do formato de configuração MCP do próprio VS Code, feita de forma independente da convenção que o Claude Desktop estabeleceu. Nenhuma das duas é mais correta. A diferença só vira problema porque as duas parecem intercambiáveis e uma delas falha sem avisar.

O VS Code vai me avisar se eu usar a chave errada?

Não, e essa é a dificuldade toda. O arquivo é um JSON válido, uma chave de nível superior desconhecida é ignorada em vez de rejeitada e ter zero servidores configurados é um estado normal. Nada nisso parece uma falha.

Posso usar um único arquivo de configuração para o VS Code e o Cursor?

Não. Eles leem caminhos diferentes e esperam chaves de envoltório diferentes, então você precisa dos dois arquivos. A definição interna do servidor é idêntica, então é uma cópia com uma palavra trocada.

Isso vale também para o Copilot do Windows?

Não. O Copilot aqui é o GitHub Copilot dentro do VS Code, que suporta servidores MCP. O assistente da barra de tarefas do Windows é um produto separado que divide o nome e não usa esses arquivos de configuração.