Pular para o conteúdo
Manual do Programador

Cap. 05 · Peça F · 8 min · Revisado em 21/10/2026

Capítulo 5: Instalando seu primeiro servidor MCP

Passo a passo para Claude Code, Claude Desktop, VS Code e Cursor, no Windows, macOS ou Linux. Com um configurador que monta a receita para o seu caso.

Agora você já sabe o que é um servidor MCP e o que ele troca com o app. Este capítulo é a parte prática: escolher um servidor, dizer ao app como iniciá-lo e confirmar que funcionou.

Os quatro servidores do configurador foram escolhidos por serem oficiais e úteis logo no primeiro dia:

  • Arquivos (@modelcontextprotocol/server-filesystem), do próprio projeto MCP: lê e escreve só nas pastas que você liberar.
  • Navegador (@playwright/mcp), da Microsoft: abre páginas, clica, preenche e lê o que está na tela.
  • GitHub, o servidor oficial do GitHub: issues, pull requests, código e Actions.
  • Memória (@modelcontextprotocol/server-memory), do projeto MCP: guarda fatos num arquivo para usar em outras conversas.

Antes: Node.js

Três dos quatro rodam com npx, que vem junto com o Node.js. Confira se ele está instalado e qual a versão:

node --version

Os servidores oficiais de arquivos e de memória pedem Node 24 ou mais novo. Se o comando não existir ou mostrar uma versão menor, instale a versão LTS pelo site nodejs.org ou pelo gerenciador do seu sistema:

winget install OpenJS.NodeJS.LTS
brew install node

O primeiro é para Windows, o segundo para macOS com Homebrew. No Linux, prefira o nvm ou o repositório oficial do Node para a sua distribuição, porque os pacotes padrão costumam vir com versões antigas. Depois de instalar, feche e abra o terminal e o app de IA, para eles enxergarem o Node novo.

Configurador

Escolha o app, o sistema e o servidor. A receita muda na hora, e o endereço da página guarda a escolha, se quiser mandar para alguém.

ConfiguradorConferido nas docs oficiais em 21/10/2026
01Onde você vai usar?
02Seu sistema
03Qual servidor?

Procedimento: Claude Code · Windows · Navegador

Antes de começar

  • Node.js 18 ou mais novo (node --version para conferir).

Passo a passo

  1. No terminal, rode:

    PowerShell
    claude mcp add --transport stdio navegador -- npx -y @playwright/mcp@latest

  2. Abra o Claude Code (claude). O servidor sobe junto.

Como conferir

  • No terminal, claude mcp list mostra o servidor como conectado.
  • Dentro do Claude Code, o comando /mcp mostra o status e as ferramentas.

Teste com este pedido

Abra https://example.com e me diga o título da página.

Se der errado no Windows

Se o servidor aparecer como "Failed to connect" ou der "Connection closed", troque -- npx por -- cmd /c npx e confira os argumentos salvos com claude mcp get navegador.

Depois de instalar

Na primeira vez que o modelo usar uma ferramenta do servidor, o app vai pedir permissão. Leia o que ele quer executar antes de aprovar, principalmente se a ferramenta escreve, apaga ou envia alguma coisa. Liberar de vez só faz sentido para o que é seguro e repetitivo.

Se o modelo não usar o servidor, peça de forma explícita: “use o navegador para abrir…”. Com o tempo você aprende quando ele pega a dica sozinho.

Se der errado

Sintoma Causa provável O que fazer
npx não é reconhecido Node.js não instalado, ou o app foi aberto antes da instalação Instale o Node e reabra o terminal e o app
O servidor dá erro assim que o app abre JSON inválido: vírgula sobrando, aspas ou chaves faltando Abra o arquivo no VS Code, que marca o erro, e corrija
“Connection closed” no Windows O app não consegue iniciar o npx diretamente Use cmd /c npx; a receita de Windows do configurador mostra como
Erro mencionando a versão do Node O servidor exige Node mais novo Rode node --version; arquivos e memória pedem 24 ou mais
Conectado, mas o modelo não usa Pedido vago, ou a ferramenta está desligada no app Peça de forma explícita e confira se o servidor está ativo

Depois do primeiro dia

Com um ou dois servidores funcionando, o assistente já faz mais do que responder: ele busca, abre, lê e escreve. Quando ele começa a encadear essas ações sozinho, o assunto passa a ser agentes.

Quem escreve

Davi Antonaji

Technical Lead na SantoroIN. Trabalho com infraestrutura (AWS, GCP, Terraform) e uso IA no dia a dia para escrever código, revisar e automatizar o que dá. Este manual é o passo a passo que eu queria ter lido quando comecei.

Conheça meu trabalho em antonaji.com.br
GitHubLinkedIn