Filesystem
O que este servidor faz
Leitura, escrita e busca de arquivos dentro de diretórios explicitamente autorizados.
É o servidor mais usado para aprender MCP: efeito imediato e configuração mínima. Bom primeiro contato.
| Característica | Detalhe |
|---|---|
| Transporte | stdio |
| Autenticação | Sem autenticação — o escopo é definido pelos diretórios passados na inicialização. |
| Manutenção | Oficial — mantido pelo projeto MCP |
| Dificuldade de configuração | Fácil |
| Repositório | Disponível no GitHub (link ao final) |
Como configurar
Declare o servidor no arquivo de configuração do seu cliente MCP. O caminho do arquivo varia por cliente — no Cursor, por exemplo, é ~/.cursor/mcp.json para configuração global ou .cursor/mcp.json para configuração por projeto.
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/caminho/do/seu/projeto"
]
}
}
}Depois de salvar, reinicie o cliente: a configuração é lida na inicialização. Em seguida, teste com uma pergunta que só possa ser respondida usando este servidor. Se o assistente responder com dados reais, a configuração está correta.
Segurança
Antes de conectar qualquer servidor MCP, verifique quem mantém o projeto, quando foi a última atualização e se há issues abertas sobre segurança. Você vai executar esse código na sua máquina com as permissões que conceder.
Nosso guia de segurança em MCP detalha os sete riscos que aparecem com mais frequência em uso profissional, com contramedidas para cada um.
Perguntas frequentes
O servidor Filesystem é gratuito?
Sim. Assim como os demais servidores MCP, ele é open source e não cobra assinatura. O custo está no uso do modelo de IA que consome as ferramentas.
Qual transporte o servidor Filesystem usa?
Ele usa stdio. No transporte stdio, o cliente inicia o servidor como processo local — funciona apenas na sua máquina.
Como o servidor Filesystem se autentica?
Sem autenticação — o escopo é definido pelos diretórios passados na inicialização.
Qual o principal risco do servidor Filesystem?
O servidor tem acesso a tudo dentro dos diretórios autorizados. Nunca aponte para a raiz do sistema, para o diretório pessoal completo ou para pastas com chaves de API e credenciais.
Fontes verificadas
Verificamos preços e recursos contra a documentação oficial do fornecedor na data da última revisão. Preços em dólar e sujeitos a variação cambial e IOF para assinantes no Brasil.