Servidor MCP é como você dá a um agente de programação ferramentas que ele não trouxe de fábrica: o seu rastreador de issues, o seu banco, a sua API interna. O Verboo Code adiciona um com um comando só. As duas coisas que as pessoas erram são em qual escopo a configuração cai e qual transporte o servidor fala.
Este texto passa pelos dois, mais o comando de diagnóstico para quando o servidor se recusa a conectar.
Como eu adiciono um servidor MCP?
O comando é verboo mcp add. O formato é o mesmo em qualquer transporte:
verboo mcp add <nome> <comandoOuUrl> [args...]O que muda é o transporte. São três, e o Verboo Code assume stdio quando você não diz o contrário.
Servidor remoto por HTTP
verboo mcp add --transport http sentry https://mcp.sentry.dev/mcpServidor remoto que precisa de header
verboo mcp add --transport http corridor https://app.corridor.dev/api/mcp \
--header "Authorization: Bearer ..."O --header se repete. Passe um por header.
Servidor local por stdio
verboo mcp add -e API_KEY=xxx meu-servidor -- npx meu-mcp-serverO -- importa. Tudo depois dele vira a linha de comando do subprocesso em vez de ser lido como flag do verboo, e é isso que permite passar flags para o seu próprio servidor:
verboo mcp add meu-servidor -- meu-comando --alguma-flag arg1Dois erros que parecem o mesmo engano. Esquecer o nome devolve Error: Server name is required. Esquecer o comando devolve Error: Command is required when server name is provided. Os dois imprimem a linha de uso, então leia qual dos dois você tomou antes de tentar de novo.
Qual escopo eu devo usar?
É a flag que decide quem mais enxerga o servidor, e o padrão é o mais restrito.
| Escopo | Onde a configuração vive | Use quando |
|---|---|---|
local (padrão) | Só nesta máquina, só neste projeto | Você está testando o servidor, ou ele guarda um token pessoal |
project | Viaja junto com o repositório | Todo mundo que trabalha nessa base precisa do mesmo servidor |
user | Sua máquina, todos os projetos | Servidor que você quer em tudo, tipo suas notas ou seu tracker |
verboo mcp add --scope project ci-tools https://interno.exemplo.com/mcp --transport httpExiste um quarto escopo que você lê mas não escreve. O verboo mcp doctor aceita enterprise como escopo para inspecionar, enquanto o verboo mcp add só aceita local, user e project. Se o seu time tem configuração de MCP empurrada em nível corporativo, você diagnostica pelo CLI mas não edita por ali.
E servidor atrás de OAuth?
Três flags resolvem, e valem só para os transportes HTTP e SSE:
--client-id <id> | O client ID do OAuth |
--client-secret | Pede o secret na hora. Dá para usar MCP_CLIENT_SECRET em vez de digitar |
--callback-port <porta> | Fixa a porta de callback, para servidor que exige redirect URI pré-cadastrada |
A porta fixa é a que vale guardar. Muito provedor de OAuth rejeita redirect URI que ele nunca viu, e porta aleatória falha sempre sem dizer por quê.
O servidor não conecta. E agora?
Rode o diagnóstico apontando para o servidor pelo nome:
verboo mcp doctor meu-servidorEle reporta configuração, precedência entre escopos, se o servidor está desabilitado ou pendente, e saúde da conexão. Três flags mudam o comportamento:
| Flag | O que faz |
|---|---|
--config-only | Analisa só a configuração. Não sobe processo, não contata servidor remoto |
-s, --scope <escopo> | Restringe a análise a um escopo: local, project, user ou enterprise |
--json | Devolve o relatório em JSON, para script ou etapa de CI |
Leia isto antes de rodar num diretório que não é seu. A própria descrição do comando avisa: sem o --config-only, servidores stdio podem ser executados e servidores remotos podem ser contatados. Configuração de MCP em escopo de projeto que veio junto com um repositório clonado é código que você está prestes a executar. Em base desconhecida, comece pelo --config-only.
Como desligo um servidor sem remover?
Dentro da sessão, quem resolve é o slash command /mcp. A dica de argumento dele é [enable|disable [server-name]]:
/mcp abre o painel de configuração de MCP
/mcp disable meu-servidor desliga um servidor
/mcp disable desliga todos
/mcp enable meu-servidor liga de volta
/mcp reconnect meu-servidor reconecta sem reiniciar a sessãoOmitir o nome do servidor mira todos, o que é prático e vez ou outra surpreende. E se já estiver tudo no estado que você pediu, ele diz isso em vez de fingir que fez algo: All MCP servers are already disabled.
O reconnect é o que passa despercebido. Quando um servidor remoto cai, o reflexo é reiniciar a sessão inteira e perder o contexto que você construiu. Reconectar só aquele servidor preserva.
A ordem que funciona de verdade
- Adicione no escopo mais estreito que fizer sentido. O
localé o padrão por um motivo. Promova paraprojectdepois que souber que o servidor merece ser commitado. - Aprove. O Verboo Code pergunta antes de deixar um servidor novo entrar na sessão. Aquele diálogo é a fronteira de segurança, não formalidade.
- Se não conectar, rode o
doctorcom--config-onlyprimeiro. A maioria das falhas é configuração, e a passada só de config te diz isso sem executar nada. - Só depois deixe ele tentar a conexão de verdade.
Todo comando acima saiu da leitura do código de verbeux-ai/code em 3 de setembro de 2026, em src/commands/mcp/. As flags, os padrões e as mensagens de erro são o que o código faz, não o que um changelog afirma.
É pelo mesmo motivo que o agente consegue ler o repositório inteiro antes de responder: na Verboo Code os modelos rodam em GPU dedicada com tokens ilimitados, então ler três arquivos ou trinta custa igual.
MCP compensa o setup justamente porque ele deixa de ser setup. Depois que o servidor está no escopo certo, as ferramentas simplesmente estão lá, em toda sessão, e o agente para de chutar coisa que ele podia ter consultado.
