A entrada de um servidor MCP é um JSON pequeno com um modo de falha implacável: se uma chave estiver errada não há erro, o servidor simplesmente não aparece. Cada transporte quer um formato diferente — um local precisa de um comando e seus argumentos, um remoto precisa de uma URL e normalmente de um cabeçalho — e misturá-los produz um arquivo que parece completo e não faz nada. Este criador pede só os campos que o transporte escolhido usa, avisa quando um campo do outro está preenchido e aponta provavelmente o erro mais comum do mundo real: uma credencial viva escrita num arquivo que acaba versionado. Ele emite tanto o arquivo de configuração quanto o comando equivalente de uma linha.
Recursos
Só os campos que o transporte escolhido usa
Avisa quando um campo do outro transporte está preenchido
Aponta um segredo com cara de real escrito no arquivo, mas não um placeholder
Avisa sobre HTTP sem criptografia para host remoto, calado para localhost
Pega argumentos embutidos no campo de comando
Variáveis de ambiente e cabeçalhos como pares editáveis
Emite tanto o arquivo de projeto quanto a config do app de desktop
O comando equivalente, com aspas corretas
Como usar Configuração de servidor MCP
Nomeie o servidor: é assim que as ferramentas dele são agrupadas
Escolha o transporte que ele usa
Preencha o comando e os argumentos, ou a URL e os cabeçalhos
Copie o JSON para sua config, ou rode o comando
Exemplo
Entrada
"command": "npx -y some-server"
Saída
Warning: looked up as a single executable with that name
A primeira palavra é o comando; todo o resto é argumento.
Erros comuns e solução de problemas
O servidor nunca aparece. — Normalmente um formato trocado: uma entrada stdio com url, ou uma remota com command. Ambos são apontados aqui, porque nenhum gera erro sozinho.
O comando não é encontrado. — Argumentos vão separados. Coloque npx no comando e o resto na lista de argumentos: um comando com espaços é procurado como um único executável com aquele nome.
Funciona localmente e falha para os outros. — Costuma ser um caminho absoluto da sua máquina nos argumentos, ou uma credencial do seu ambiente que ninguém mais tem.
Tenho um token no arquivo de configuração. — Referencie uma variável de ambiente. Um segredo com cara de real é apontado aqui, porque arquivos de configuração acabam versionados.
Perguntas frequentes
Que transporte devo usar?
stdio para tudo que você roda localmente: o cliente inicia como processo e conversa pela entrada e saída padrão dele. HTTP para um servidor remoto. SSE existe sobretudo para servidores escritos antes de HTTP virar a escolha usual.
Onde fica o arquivo de configuração?
Um de projeto fica no repositório para toda a equipe ter os mesmos servidores; o app de desktop tem a própria config para os que você quer em todo lugar. Os dois formatos são emitidos e o caminho é mostrado.
Como mantenho um token fora do arquivo?
Escreva como referência a uma variável de ambiente em vez do valor. A checagem olha se o valor parece uma credencial real ou um placeholder, e só reclama do primeiro.
Uso o arquivo ou o comando?
Fazem a mesma coisa. O arquivo é melhor quando deve ser versionado com o projeto; o comando é mais rápido para algo que você está experimentando. Ambos saem dos mesmos campos.
Por que o nome do servidor importa?
Ele é a chave sob a qual a entrada é guardada e o namespace das ferramentas dele, então dois servidores não podem dividir um, e renomear muda como as ferramentas são referenciadas em todo lugar.
Ferramentas relacionadas
Esquema de ferramenta MCP — Defina uma ferramenta e obtenha o JSON Schema, com o modo estrito verificado.
Verificador de esquemas — Cole uma definição e descubra por que ela é rejeitada ou chamada errado.
Construtor de hooks — Monte hooks do settings.json e pegue os matchers que nunca disparam.