O que é um servidor MCP? Em resumo, um pequeno programa que dá novas habilidades a um agente de IA. O Model Context Protocol (MCP) é um protocolo aberto: um servidor o usa para oferecer a um agente ferramentas, prompts prontos e recursos legíveis. O agente chama essas ferramentas para abrir um navegador, ler issues do GitHub, buscar erros no Sentry ou consultar um banco de dados.
Este post explica como o MCP funciona, quais servidores valem a pena adicionar e os erros que as pessoas cometem ao conectá-los a agentes de código.
O que é um servidor MCP e como ele funciona?
Um servidor MCP pode oferecer três tipos de coisa:
- Ferramentas: funções que o agente pode chamar, como
browser_navigateousearch_issues. - Prompts: modelos que o servidor prepara para o agente.
- Recursos: dados que o agente pode ler, como um arquivo ou um registro.
Quando um agente inicia, ele se conecta aos seus servidores e busca as listas de ferramentas deles. Essas listas entram no contexto do modelo, e o modelo chama uma ferramenta quando precisa.
Tipos de conexão
| Tipo | Onde roda | Exemplo | Autorização |
|---|---|---|---|
| stdio | No seu computador, como um comando | npx -y @playwright/mcp@latest | Variáveis de ambiente, se necessário |
| HTTP | Num endereço remoto | https://mcp.sentry.dev/mcp | Token ou OAuth |
| SSE | Num endereço remoto, como fluxo de eventos | Comum em servidores mais antigos | Token ou OAuth |
Servidores MCP que valem a pena
Os servidores mais usados com agentes de código se dividem em alguns grupos. Alguns dos 23 servidores prontos do catálogo do AgentVera:
- Navegador: Playwright (abrir páginas, clicar, preencher formulários, tirar capturas de tela), Chrome DevTools (console, requisições de rede, traces de desempenho).
- Documentação: Context7 (documentação de bibliotecas atual e específica por versão), Cloudflare Docs.
- Desenvolvimento: GitHub (issues, pull requests, busca de código), Git (log local, diff, commit), Sentry (erros e stack traces).
- Mobile: Mobile MCP, MobileBuildMCP, iOS Simulator, Firebase.
- Dados e memória: Filesystem, Memory, Fetch, Sequential Thinking, Supabase.
- Produto e equipe: Linear, Notion, Stripe.
- Design: Figma (o servidor MCP do Dev Mode no app desktop), Canva.
- Marketing: fal.ai (geração de imagem, vídeo e áudio), Meta Ads (campanhas de anúncios).
Adicionando servidores MCP em cada CLI
Cada agente tem seu próprio jeito. No Claude Code, você pode adicionar um pela linha de comando:
claude mcp add playwright -- npx -y @playwright/mcp@latestNo Codex, os servidores são definidos em ~/.codex/config.toml:
[mcp_servers.playwright]
command = "npx"
args = ["-y", "@playwright/mcp@latest"]O problema: você define o mesmo servidor de novo em cada ferramenta, e os segredos acabam em arquivos de configuração em texto puro. Com vários agentes, as listas vão se desencontrando.
Gerenciando servidores MCP num só lugar
O gerenciador de MCP do AgentVera mantém os servidores numa única lista e os conecta quando um agente inicia:
- Na página MCP, pressione + para abrir o catálogo e escolher um servidor, ou informe seu próprio comando ou endereço.
- Decida se todos os agentes recebem o servidor ou só os que você escolher. Limite a um projeto, se quiser.
- Pressione “Test connection” para listar as ferramentas, os prompts e os recursos do servidor.
- Reinicie o agente; a mudança vale para a nova sessão.
Variáveis de ambiente secretas e tokens de cabeçalho ficam guardados no chaveiro do seu sistema operacional. Servidores que precisam de OAuth são autorizados no primeiro uso. Os servidores das configurações do próprio Claude Code e do Codex aparecem na lista com seu estado; você pode importá-los para o AgentVera ou gravar os servidores do AgentVera de volta nas configurações das CLIs.
Esses servidores não chegam só ao Claude Code e ao Codex. Outras ferramentas que aceitam MCP também os recebem: opencode, Copilot, Qwen Code, Goose e Amp.
Calcule o custo em tokens
O preço escondido do MCP é o contexto. As definições de ferramentas de cada servidor entram no contexto do agente e são relidas a cada turno. Um servidor com dez ferramentas ocupa espaço em todo turno, mesmo que o agente nunca o chame.
O teste de conexão do AgentVera mostra os tokens aproximados que cada ferramenta acrescenta ao contexto do agente. Isso permite:
- Dar servidores caros e pouco usados só ao agente que precisa deles.
- Escolher o mais leve entre dois servidores que fazem o mesmo trabalho.
- Manter um agente enxuto livre de ferramentas que ele não vai usar.
Para outras formas de reduzir o contexto, veja como cortar o uso de tokens do Claude Code.
Um quadro compartilhado para os agentes
O AgentVera adiciona automaticamente a todo projeto um servidor MCP chamado agentvera-board. É um quadro de avisos compartilhado pelos agentes do projeto e por você. Os agentes usam board_read, board_post e board_update para deixar notas, decisões, pendências, descobertas e registros de arquivos/módulos, e para ler o que os outros escreveram. Você publica e marca pendências como concluídas pela aba Board no painel direito.
Para agentes em paralelo, essa é a resposta simples para “como o Tester vai saber da decisão que o Architect tomou?”
Exemplo: testando no navegador com Playwright
O melhor exemplo do que o MCP oferece é o navegador. Um agente com o servidor MCP do Playwright pode:
- Abrir seu app no endereço local.
- Tirar um snapshot da árvore de acessibilidade da página.
- Clicar em botões e preencher formulários.
- Tirar uma captura de tela e relatar o que vê.
Assim, o agente consegue verificar sozinho se “o botão de salvar na página de configurações funciona”. O AgentVera gerencia um Chrome headless com perfil próprio para isso. Agentes no modo “AgentVera browser” o usam via Playwright MCP, e você acompanha as abas ao vivo na página Browser e intervém quando quiser. Veja a página do navegador do agente para mais detalhes.
Qual servidor para qual agente?
Distribuir servidores por papel, em vez de dar todos os servidores a todos os agentes, melhora tanto o contexto quanto a segurança:
| Papel do agente | Servidores adequados | Por quê |
|---|---|---|
| Desenvolvedor frontend | Playwright, Chrome DevTools, Figma | Vê a página, lê o design |
| Desenvolvedor backend | Context7, Supabase, Git | Documentação atual, banco de dados, histórico do repositório |
| Depurador | Sentry, GitHub | Stack traces e issues relacionadas |
| Foco em produto | Linear, Notion | Lê e atualiza tarefas e documentos |
Limitar um servidor a um projeto também ajuda. Um servidor conectado ao projeto Supabase de um cliente não precisa ficar visível para agentes de outros projetos.
Notas de segurança
Servidores MCP dão aos agentes acesso a sistemas reais. Então:
- Cuidado com servidores que podem gravar. Um agente que pode aplicar migrações de banco de dados pode alterar dados com um passo errado.
- Não guarde tokens em arquivos de texto puro. Use o chaveiro ou variáveis de ambiente.
- Não rode servidores que você não conhece. Servidores stdio rodam como código no seu computador.
- Não pule o teste de conexão. Ele mostra o que o servidor realmente oferece e quanto contexto custa.
Adicionando seu próprio servidor MCP
Você também pode adicionar servidores que não estão no catálogo. Precisa de duas coisas:
- Para stdio: o comando e os argumentos para rodar, além de eventuais variáveis de ambiente.
- Para HTTP ou SSE: o endereço do servidor e eventuais cabeçalhos de autorização.
Teste a conexão depois de adicionar. Se o teste falhar, confira a saída do servidor (stderr); uma variável de ambiente ausente ou um runtime não instalado (como o uvx) costuma ser a causa.
Checklist
- Esse servidor realmente ajuda esse agente?
- Você testou o custo em tokens dele?
- Os segredos estão no chaveiro e não num arquivo de texto puro?
- O servidor deveria ficar limitado a um projeto?
- Você reiniciou o agente depois de adicioná-lo?
Concluindo
Servidores MCP levam os agentes de código além do terminal: navegadores, gerenciadores de issues, monitoramento de erros e arquivos de design ficam ao alcance. O preço é o custo de contexto e a gestão de segredos. Gerenciar os servidores num só lugar, restringir o escopo deles e medir o custo é como você mantém esse equilíbrio.
Você pode testar o gerenciador de MCP do AgentVera no plano gratuito e ver quais ferramentas aceitam MCP na página do Claude Code e nas páginas dos outros agentes.