Conecte um servidor de referência ao Claude Desktop e valide que todo o seu ambiente está funcionando.
Para validar que todo o ambiente está funcionando, precisamos de um MCP Server confiável e bem testado. A Anthropic e a comunidade mantêm diversos servers oficiais que são perfeitos para este primeiro teste. Vamos escolher o mais adequado para iniciantes e entender por que ele é a melhor opção.
Existem diversos MCP Servers oficiais mantidos pela comunidade e pela Anthropic. Para o primeiro teste, os mais indicados são: filesystem (acesso controlado a arquivos e diretórios locais), fetch (buscar conteúdo de URLs na internet) e memory (armazenar e recuperar notas persistentes). O filesystem é o melhor para começar porque é visual (você pode ver os arquivos sendo lidos e criados), não depende de APIs externas ou chaves de acesso, e demonstra claramente o conceito de tools MCP em ação.
Lê, escreve e lista arquivos em diretórios permitidos. Ideal para primeiro teste.
Busca conteúdo de URLs. Útil para dar ao Claude acesso à web.
Armazena e recupera notas entre conversas. Demonstra persistência.
Todos estão disponíveis como pacotes npm no escopo @modelcontextprotocol e podem ser executados via npx sem instalação prévia.
A beleza dos MCP Servers baseados em npm é que eles podem ser executados diretamente via npx, sem necessidade de instalação global prévia. Porém, se preferir, você também pode instalar globalmente para ter controle mais direto. Vamos ver as duas abordagens.
O server filesystem pode ser utilizado de duas formas: via npx direto (recomendado, não precisa instalar nada) ou via instalação global com npm. Quando usamos npx no config.json do Claude Desktop, o npx automaticamente baixa e executa o pacote na versão mais recente. Não é necessário clonar repositórios, compilar código ou fazer qualquer setup manual. Basta ter o Node.js e npm instalados (que já configuramos nos módulos anteriores).
Se quiser instalar globalmente (opcional), execute no terminal:
npm install -g @modelcontextprotocol/server-filesystem
Mas a abordagem recomendada é usar npx diretamente no config.json — assim o Claude Desktop sempre usa a versão mais recente automaticamente, sem necessidade de atualização manual.
Agora vamos colocar tudo junto: adicionar o server filesystem ao arquivo de configuração do Claude Desktop. Este é o momento em que a teoria vira prática — você vai editar o config.json com os dados corretos e preparar o Claude para se conectar ao seu primeiro MCP Server.
Abra o arquivo claude_desktop_config.json e adicione o seguinte conteúdo:
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/caminho/permitido"
]
}
}
}
Substitua /caminho/permitido pelo diretório real que você quer que o Claude acesse. Por exemplo: /home/usuario/projetos no Linux, /Users/usuario/Documents no macOS, ou C:/Users/usuario/Documents no Windows.
Defina um diretório restrito! O server filesystem dará ao Claude acesso de leitura e escrita a todos os arquivos dentro do diretório especificado. Nunca use a raiz do sistema (/ ou C:\) como caminho permitido. Crie uma pasta dedicada para testes, como ~/mcp-teste, e use-a como argumento. Isso garante que o Claude só possa acessar arquivos naquele diretório específico, seguindo o princípio de menor privilégio.
Com o config.json salvo, é hora de reiniciar o Claude Desktop e verificar que o server foi carregado com sucesso. Este é o momento da verdade — quando você abre o aplicativo e vê as tools do filesystem aparecerem, saberá que o MCP está funcionando.
Após salvar o config.json, você precisa reiniciar completamente o Claude Desktop. Feche o aplicativo (não apenas minimize), verifique que ele não está rodando na bandeja do sistema, e abra-o novamente. Ao reabrir, o Claude Desktop lerá o config.json, encontrará a entrada "filesystem" e tentará iniciar o server via npx. Se tudo correr bem, o ícone de martelo (🔨) aparecerá próximo ao campo de input. Clicando nele, você verá as tools disponíveis: read_file, write_file, list_directory, entre outras.
Feche o Claude Desktop. No macOS: Cmd+Q. No Windows: clique com botão direito no ícone da bandeja e selecione "Quit". No Linux: feche a janela e verifique se o processo encerrou.
Abra o Claude Desktop novamente. Aguarde 5-10 segundos para que o server filesystem seja iniciado via npx (o primeiro carregamento pode ser mais lento por conta do download).
Procure o ícone de martelo (🔨) na barra de input do chat. Se aparecer, clique nele para ver as tools: read_file, write_file, list_directory, create_directory, move_file, etc.
Se o ícone não aparecer: verifique o JSON (jsonlint.com), confirme que npx funciona no terminal, e cheque os logs do Claude Desktop em busca de erros.
Com o server filesystem conectado, é hora de testar de verdade. Vamos enviar comandos ao Claude que exercitem as tools do filesystem e observar como funciona a interação entre o Claude, o Client MCP e o Server. Preste atenção especial ao fluxo de permissões — o Claude sempre pede sua autorização antes de usar uma tool.
Ao enviar um prompt que requer acesso a arquivos, o Claude identifica automaticamente qual tool usar e pede sua permissão antes de executá-la. Esse fluxo de aprovação é uma camada de segurança fundamental do MCP — o Human-in-the-Loop. O Claude nunca executa uma tool sem que você autorize. Na interface, você verá um card com o nome da tool, os parâmetros que serão usados e botões para "Permitir" ou "Negar".
Experimente estes três prompts de teste, um de cada vez:
Em cada caso, observe o card de permissão e clique em "Permitir" para ver a tool em ação.
Se você chegou até aqui e o servidor filesystem está funcionando no Claude Desktop, parabéns! Seu ambiente de desenvolvimento MCP está 100% configurado. Vamos recapitular tudo o que foi montado ao longo desta trilha e preparar o terreno para o próximo grande passo: criar o seu próprio MCP Server.
Seu ambiente de desenvolvimento MCP completo inclui:
Com tudo isso em mãos, você está pronto para a Trilha 3: criar o seu próprio MCP Server do zero.
Antes de seguir para a Trilha 3, experimente explorar mais o server filesystem. Peça ao Claude para organizar arquivos, criar estruturas de pastas, buscar conteúdo em arquivos de texto. Quanto mais você usar, mais natural ficará a interação com tools MCP. Você também pode tentar adicionar um segundo server (como o fetch) ao config.json para praticar a configuração de múltiplos servers simultâneos.
O ecossistema MCP está em crescimento acelerado. Existem hoje centenas de MCP Servers disponíveis publicamente, cobrindo desde bancos de dados (PostgreSQL, MongoDB) até serviços de nuvem (AWS, GCP), ferramentas de desenvolvimento (GitHub, GitLab) e aplicativos de produtividade (Slack, Google Drive, Notion). Na Trilha 3, você vai aprender a criar seus próprios servers, entrando para essa comunidade de desenvolvedores que está moldando o futuro das integrações de IA.
Próxima Trilha: Trilha 3 — Criando Seu Primeiro MCP Server