Servidor MCP Filesystem

Ler, criar, mover e buscar arquivos dentro das pastas que você autorizar.

Referência do protocoloLocal · npxmantido por Model Context Protocol

O que é

Servidor de referência para acesso a arquivos. Você informa uma ou mais pastas na linha de comando e o servidor recusa qualquer caminho fora delas. É o primeiro servidor que a documentação oficial ensina a instalar.

Exemplos de pedidos

“Liste os arquivos .csv desta pasta e diga o tamanho de cada um.”
“Crie um arquivo NOTAS.md com o resumo desta conversa.”

Antes de instalar

Requer Node.js. Para liberar mais de uma pasta, acrescente outros caminhos ao final dos argumentos.

Sinais de confiança

Quem mantém: Referência do protocolo Model Context ProtocolMantido no repositório de servidores de referência da organização do Model Context Protocol.
Repositório: modelcontextprotocol/servers/src/filesystem
Licença: Não identificada pelo GitHub: veja o arquivo LICENSE do repositório
Último commit: 05/10/2026 (2 dias antes da coleta)
Estrelas: 91,1 mil
Registro oficial: Entrada não conferida por nós no registro oficial
Transporte: Local (stdio), iniciado com npx
O que você preenche: PASTA_PERMITIDA — Caminho absoluto da pasta que o assistente poderá ler e alterar
Configuração conferida: 03/10/2026, no README do repositório

Estrelas, licença e último commit: API do GitHub, retrato incluído nesta versão do site, coletado em 07/10/2026. Situação no registro: registry.modelcontextprotocol.io, na mesma data.

Configurar o Filesystem em cada cliente

Sem token nesta página. O que está destacado você preenche na sua máquina. Para combinar com outros servidores ou gerar a versão para Windows, use o gerador com o Filesystem já marcado.

claude_desktop_config.json~/Library/Application Support/Claude/claude_desktop_config.json

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

PASTA_PERMITIDA: Substitua <PASTA_PERMITIDA> pelo valor, direto no arquivo, na sua máquina.

Onde fica o arquivo e como conferir no Claude Desktop

ComandosTerminal, na pasta do projeto

claude mcp add --transport stdio filesystem -- npx -y @modelcontextprotocol/server-filesystem "<PASTA_PERMITIDA>"

PASTA_PERMITIDA: Substitua <PASTA_PERMITIDA> pelo valor, direto no comando, na sua máquina.

Onde fica o arquivo e como conferir no Claude Code

mcp.json.cursor/mcp.json

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

PASTA_PERMITIDA: Substitua <PASTA_PERMITIDA> pelo valor, direto no arquivo, na sua máquina.

Onde fica o arquivo e como conferir no Cursor

mcp.json.vscode/mcp.json

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

PASTA_PERMITIDA: Substitua <PASTA_PERMITIDA> pelo valor, direto no arquivo, na sua máquina.

Onde fica o arquivo e como conferir no VS Code

mcp_config.json~/.config/devin/mcp_config.json

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

PASTA_PERMITIDA: Substitua <PASTA_PERMITIDA> pelo valor, direto no arquivo, na sua máquina.

Onde fica o arquivo e como conferir no Windsurf

O que ele alcança

Leitura e escrita em todas as pastas listadas nos argumentos, com as permissões do seu usuário.

Riscos e como reduzir

O servidor pode apagar e sobrescrever arquivos dentro das pastas liberadas. Libere uma pasta de projeto, nunca a pasta do usuário inteira.
Um arquivo malicioso dentro da pasta pode conter instruções escritas para o modelo (injeção de prompt).

Contexto geral em Segurança no MCP. Código-fonte: github.com/modelcontextprotocol/servers.

Outros servidores de arquivos e sistema

Perguntas frequentes

O servidor Filesystem é oficial?

Referência do protocolo: é mantido por Model Context Protocol, no repositório modelcontextprotocol/servers. Mantido no repositório de servidores de referência da organização do Model Context Protocol.

Que credenciais o Filesystem pede?

Nenhuma. A configuração não contém token nem senha.

Como o Filesystem é executado?

É um servidor local, iniciado com npx (exige Node.js). O cliente inicia o processo sozinho quando abre.

O Filesystem funciona no Cursor, no VS Code e no Claude Code?

Sim. Esta página traz o bloco de configuração para Claude Desktop, Claude Code, Cursor, VS Code e Windsurf, cada um no formato do cliente.

Quando esta configuração foi conferida?

Em 03/10/2026, no README do repositório modelcontextprotocol/servers. Se o comando mudar depois disso, vale o que o repositório publicar.