Claude Depura e Corrige Seu Próprio Bug de Caminho UNC no Servidor de Sistema de Arquivos MCP no Windows

Um desenvolvedor documentou o uso do Claude Opus para depurar e corrigir um bug no MCP Filesystem Server (versão da Extensão para Desktop) no Windows. O problema afetava os caminhos de compartilhamento de rede UNC (por exemplo, \\servidor\compartilhamento\).

O Problema

Ao usar um compartilhamento UNC como um diretório permitido, o list_directory na raiz do compartilhamento funcionava, mas qualquer operação em subdiretórios ou arquivos falhava com um erro "Acesso negado - caminho fora dos diretórios permitidos". A gravação de arquivos na raiz também falhava, apesar do compartilhamento estar totalmente acessível pelo Windows Explorer e por unidades mapeadas.

O Processo de Depuração

O Claude ajudou a identificar que:

• A configuração para a versão da Extensão para Desktop é armazenada em %APPDATA%\Claude\Claude Extensions Settings\ant.dir.ant.anthropic.filesystem.json, não em claude_desktop_config.json.
• Mudar para uma letra de unidade mapeada não funcionou porque o fs.realpath() do Node.js resolve as unidades mapeadas de volta para caminhos UNC durante a inicialização do servidor.
• Os arquivos de origem do servidor (index.js → lib.js → path-validation.js) foram examinados para encontrar a causa raiz.

Causa Raiz

Em path-validation.js, a função isPathWithinAllowedDirectories() verifica a associação de subdiretórios com:

return normalizedPath.startsWith(normalizedDir + path.sep);

As raízes de compartilhamento UNC são raízes do sistema de arquivos (como C:\) e mantêm sua barra invertida final após a normalização: \\servidor\compartilhamento\. Isso cria uma barra invertida dupla final (\\servidor\compartilhamento\\) que nunca corresponde aos caminhos reais. O código tinha tratamento especial para raízes de unidade como C:\, mas não para raízes UNC.

A Correção

Substitua a linha problemática por:

const dirWithSep = normalizedDir.endsWith(path.sep) ? normalizedDir : normalizedDir + path.sep;
return normalizedPath.startsWith(dirWithSep);

Aplique o patch com esta linha única do PowerShell:

$file = "$env:APPDATA\Claude\Claude Extensions\ant.dir.ant.anthropic.filesystem\node_modules\@modelcontextprotocol\server-filesystem\dist\path-validation.js"
Copy-Item $file "$HOME\Desktop\path-validation.js.backup"
$content = Get-Content $file -Raw
$content = $content.Replace(
  'return normalizedPath.startsWith(normalizedDir + path.sep);',
  'const dirWithSep = normalizedDir.endsWith(path.sep) ? normalizedDir : normalizedDir + path.sep; return normalizedPath.startsWith(dirWithSep);'
)
[System.IO.File]::WriteAllText($file, $content)

Em seguida, saia completamente e reinicie o Claude Desktop. O próprio Claude testou a correção usando ferramentas MCP após reiniciar — listando subdiretórios e gravando um arquivo de teste para confirmar a funcionalidade.

Observação: Este patch será sobrescrito se a extensão for atualizada automaticamente. A correção deve ser implementada na fonte em @modelcontextprotocol/server-filesystem. Problemas relacionados no GitHub: #1838, #470.