# O que é um servidor MCP? Configuração para agentes

URL: https://agentvera.dev/pt/blog/what-is-mcp-server/ · Publicado: 2026-09-24

O que é um servidor MCP e como conectá-lo a agentes de código? Servidores stdio e HTTP, custo em tokens, segredos e o escopo certo, explicados passo a passo.

**Resumo:**

- Um servidor MCP é um pequeno programa que oferece a um agente ferramentas, prompts e recursos pelo Model Context Protocol, um protocolo aberto; servidores stdio rodam localmente, e HTTP remotamente com token ou OAuth.
- As definições de ferramentas de cada servidor entram no contexto do agente e são relidas a cada turno, mesmo sem uso; o teste de conexão do AgentVera mostra o custo aproximado em tokens por ferramenta.
- O catálogo do AgentVera tem 23 servidores prontos, guarda segredos no chaveiro do sistema operacional e adiciona a todo projeto um servidor de quadro de avisos chamado agentvera-board.

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_navigate` ou `search_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:

```bash
claude mcp add playwright -- npx -y @playwright/mcp@latest
```

No Codex, os servidores são definidos em `~/.codex/config.toml`:

```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](/pt/features/mcp-manager/) do AgentVera mantém os servidores numa única lista e os conecta quando um agente inicia:

1. Na página MCP, pressione **+** para abrir o catálogo e escolher um servidor, ou informe seu próprio comando ou endereço.
2. Decida se todos os agentes recebem o servidor ou só os que você escolher. Limite a um projeto, se quiser.
3. Pressione “Test connection” para listar as ferramentas, os prompts e os recursos do servidor.
4. 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](/pt/agents/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](/pt/blog/claude-code-token-usage/).

## 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](/pt/features/agent-browser/) 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](/pt/) e ver quais ferramentas aceitam MCP na página do [Claude Code](/pt/agents/claude-code/) e nas páginas dos outros agentes.

## Perguntas frequentes

**O que é um servidor MCP?** Um pequeno programa que fala o Model Context Protocol e oferece a um agente de IA ferramentas, prompts e recursos. Chamando essas ferramentas, o agente pode abrir um navegador, ler issues ou consultar um banco de dados.

**Qual é a diferença entre servidores stdio e HTTP?** Um servidor stdio roda como um comando no seu computador (por exemplo, via npx). Um servidor HTTP roda num endereço remoto e geralmente precisa de OAuth ou de um token.

**Servidores MCP gastam tokens?** Sim. As definições de ferramentas de cada servidor entram no contexto do agente e são relidas a cada turno. Não conectar servidores que você não usa reduz o custo.

**Quais agentes suportam MCP?** No AgentVera, além do Claude Code e do Codex, o opencode, o Copilot, o Qwen Code, o Goose e o Amp também recebem os servidores MCP do AgentVera ao iniciar.

---

**Sobre o AgentVera.** AgentVera é um app desktop para macOS, Windows e Linux, desenvolvido pela Solviera Teknoloji. Ele roda 18 agentes de programação com IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) lado a lado, por projeto, em terminais reais com as instalações e logins de CLI do próprio usuário. O plano gratuito tem agentes ilimitados. Baixar: https://agentvera.dev/pt/download/ · Preços: https://agentvera.dev/pt/pricing/