Como instalar seu primeiro servidor MCP no Claude Desktop

O que você vai fazer

Instalar o servidor Filesystem, o servidor de referência mantido pela organização do Model Context Protocol. Ele dá ao assistente ferramentas para listar, ler, criar e mover arquivos, mas só dentro das pastas que você informar. É o mesmo exemplo do guia oficial, escolhido porque não depende de conta em serviço nenhum.

1. Confira o Node.js

O servidor é um pacote do npm, iniciado com o npx. Abra o terminal (ou o Prompt de Comando) e rode:

node --version

Se aparecer um número de versão, siga em frente. Se o comando não existir, instale a versão LTS em nodejs.org e abra o terminal de novo.

2. Escolha a pasta

Crie uma pasta só para o teste, por exemplo mcp-teste dentro de Documentos, e coloque nela um arquivo de texto qualquer. Anote o caminho completo. Não use a sua pasta de usuário nem a de Documentos inteira: tudo o que estiver dentro da pasta liberada pode ser lido e alterado.

3. Abra o arquivo de configuração

No Claude Desktop, abra Settings pelo menu do sistema (a barra de menus no macOS, e não a engrenagem dentro da conversa), vá à aba Developer e clique em Edit Config. O aplicativo cria o arquivo claude_desktop_config.json se ele ainda não existir e o mostra na pasta.

4. Cole a configuração

No macOS:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "<PASTA_PERMITIDA>"
      ]
    }
  }
}

No Windows, o npx é chamado por cmd /c:

{
  "mcpServers": {
    "filesystem": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "<PASTA_PERMITIDA>"
      ]
    }
  }
}

Troque <PASTA_PERMITIDA> pelo caminho da pasta do passo 2. No macOS, algo como /Users/voce/Documents/mcp-teste. No Windows, com a barra invertida em dobro: C:\\Users\\voce\\Documents\\mcp-teste. Salve o arquivo.

Usa outro cliente? O gerador produz o mesmo servidor no formato do Cursor, do VS Code, do Claude Code e do Windsurf.

5. Reinicie e confira

Feche o Claude Desktop por completo (sair do aplicativo, e não só fechar a janela) e abra de novo. Na caixa de mensagem, clique no botão de adicionar arquivos e conectores, passe o mouse por Connectors e abra Manage connectors: o servidor filesystem deve estar na lista, com as ferramentas dele.

6. Faça o primeiro pedido

Escreva: “Quais arquivos existem na pasta mcp-teste?”. O Claude pede a sua aprovação antes de usar a ferramenta. Aprove e veja a lista. Depois tente “Crie um arquivo ola.md com um resumo desta conversa” e confira na pasta.

Se o servidor não aparecer

• Valide o JSON: aspas duplas em tudo, sem vírgula depois do último item.
• O caminho precisa ser absoluto e a pasta precisa existir.
• Rode o servidor à mão para ver o erro: npx -y @modelcontextprotocol/server-filesystem /caminho/da/pasta. No nosso teste, ele respondeu "Secure MCP Filesystem Server running on stdio" e listou as ferramentas.
• Leia os logs: ~/Library/Logs/Claude no macOS, %APPDATA%\Claude\logs no Windows. O arquivo mcp-server-filesystem.log traz a saída de erro do servidor.

Mais casos no guia do Claude Desktop.

O que aconteceu por baixo

Ao abrir, o Claude Desktop leu o arquivo, executou o comando e passou a conversar com o processo pela entrada e saída padrão. Perguntou quais ferramentas existem e ofereceu a lista ao modelo. Quando você pediu os arquivos, o modelo escolheu a ferramenta, o aplicativo pediu a sua aprovação e encaminhou a chamada. A página O que é MCP explica cada peça.