Plugar uma ferramenta externa num agente de programação parece simples até o servidor não conectar e não sobrar nenhuma pista sobre o motivo. No Verboo Code o caminho é curto: um comando para adicionar, uma regra de aprovação por escopo, e um comando de diagnóstico dedicado para quando algo não funciona.
Como adicionar um servidor MCP no Verboo Code?
Com verboo mcp add <nome> <comando-ou-url>. Para um servidor stdio (processo local):
verboo mcp add sentry -- npx @sentry/mcp-serverPara um servidor HTTP remoto, declare o transporte:
verboo mcp add --transport http sentry https://mcp.sentry.dev/mcp --header "Authorization: Bearer SEU_TOKEN"Quatro flags controlam onde a configuração é salva e como o servidor se autentica:
| flag | o que faz |
|---|---|
-s, --scope | local, project ou user. Default é local: só o projeto atual, na sua máquina, enxerga o servidor |
-t, --transport | stdio, sse ou http. Sem essa flag o Verboo Code assume stdio |
-e, --env | variável de ambiente para o processo, ex: -e API_KEY=xxx |
-H, --header | header HTTP para servidor remoto, ex: -H "Authorization: Bearer ..." |
Todo servidor adicionado pede aprovação?
Não. Só o escopo project, porque essa configuração fica versionada no repositório e qualquer pessoa do time que clonar o projeto herda os servidores nela. Por isso um servidor de escopo project nasce com status pending até alguém aprovar explicitamente. Escopo local, que é o default do mcp add, não passa por essa tela: é config sua, na sua máquina, sob sua responsabilidade.
Na prática: se você está testando um MCP sozinho, deixe no escopo local. Só suba para project quando o time inteiro precisar do mesmo servidor, porque aí entra o fluxo de aprovação.
O servidor não conecta. Como diagnosticar?
Com verboo mcp doctor <nome>. Ele lê a configuração, checa precedência entre escopos, e por padrão tenta a conexão de verdade:
verboo mcp doctor sentryCuidado: sem --config-only, o doctor pode subir processo local e contatar servidor remoto de verdade. Só rode em diretório confiável, como a própria descrição do comando avisa.
| flag | o que faz |
|---|---|
--config-only | não sobe processo nem contata servidor remoto, só analisa a configuração |
--json | devolve o relatório em JSON, para ler em script ou CI |
-s, --scope | restringe a análise a um escopo: local, project, user ou enterprise |
Rodar sem argumento (verboo mcp doctor) diagnostica todos os servidores configurados de uma vez, útil quando você não sabe qual dos vários MCPs plugados está com problema.
Como habilitar ou desabilitar um servidor sem removê-lo?
Dentro da sessão, com /mcp enable <nome> ou /mcp disable <nome>. Passar all no lugar do nome liga ou desliga todos de uma vez, o que ajuda a isolar se um problema vem de um MCP específico ou de outra coisa.
Ferramenta externa plugada certo economiza contexto que sobraria para resolver o problema em si. É o tipo de detalhe que separa sessão fluida de sessão travada. Conheça a Verboo Code.
