Para utilizadores do Claude Desktop

Comece a usar servidores pré-construídos no Claude para Desktop.

Neste tutorial, você estenderá o Claude para Desktop para que ele possa ler o sistema de arquivos do seu computador, gravar novos arquivos, mover arquivos e até mesmo pesquisar arquivos.

Não se preocupe — ele pedirá sua permissão antes de executar essas ações!

1. Baixe o Claude para Desktop

Comece baixando o Claude para Desktop, escolhendo macOS ou Windows. (O Linux ainda não é suportado para Claude para Desktop.)

Siga as instruções de instalação.

Se você já tem o Claude para Desktop, certifique-se de que ele está na versão mais recente clicando no menu Claude no seu computador e selecionando “Check for Updates…”

Por que Claude para Desktop e não Claude.ai?

2. Adicione o Filesystem MCP Server

Para adicionar essa funcionalidade de sistema de arquivos, instalaremos um Filesystem MCP Server pré-construído no Claude para Desktop. Este é um dos muitos servidores criados pela Anthropic e pela comunidade.

Comece abrindo o menu Claude no seu computador e selecione “Settings…”. Observe que estas não são as Configurações de Conta Claude encontradas na própria janela do aplicativo.

É assim que deve ser em um Mac:

Clique em “Developer” na barra lateral esquerda do painel Settings e, em seguida, clique em “Edit Config”:

Isso criará um arquivo de configuração em:

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

Windows: %APPDATA%\Claude\claude_desktop_config.json

se você ainda não tiver um, e exibirá o arquivo no seu sistema de arquivos.

Abra o arquivo de configuração em qualquer editor de texto. Substitua o conteúdo do arquivo por isto:

MacOS/Linux

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/Users/username/Downloads"
      ]
    }
  }
}

Windows

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "C:\\Users\\username\\Desktop",
        "C:\\Users\\username\\Downloads"
      ]
    }
  }
}

Certifique-se de substituir username pelo nome de usuário do seu computador. Os caminhos devem apontar para diretórios válidos que você deseja que o Claude possa acessar e modificar. Ele está configurado para funcionar para Desktop e Downloads, mas você também pode adicionar mais caminhos.

Você também precisará do Node.js no seu computador para que isso funcione corretamente. Para verificar se você tem o Node instalado, abra a linha de comando no seu computador.

No macOS, abra o Terminal na sua pasta Applications

No Windows, pressione Windows + R, digite “cmd” e pressione Enter

Uma vez na linha de comando, verifique se você tem o Node instalado inserindo o seguinte comando:

Se você receber um erro dizendo “command not found” ou “node is not recognized”, baixe o Node em nodejs.org.

Como funciona o arquivo de configuração?
Este arquivo de configuração diz ao Claude para Desktop quais servidores MCP iniciar toda vez que você iniciar o aplicativo. Neste caso, adicionamos um servidor chamado “filesystem” que usará o comando Node npx para instalar e executar @modelcontextprotocol/server-filesystem. Este servidor, descrito aqui, permitirá que você acesse seu sistema de arquivos no Claude para Desktop.

Command Privileges
Claude para Desktop executará os comandos no arquivo de configuração com as permissões da sua conta de usuário e acesso aos seus arquivos locais. Adicione comandos somente se você entender e confiar na fonte.

3. Reinicie o Claude

Depois de atualizar seu arquivo de configuração, você precisa reiniciar o Claude para Desktop.

Ao reiniciar, você deverá ver um ícone de martelo

no canto inferior direito da caixa de entrada:

Depois de clicar no ícone do martelo, você deverá ver as ferramentas que acompanham o Filesystem MCP Server:

Se o seu servidor não estiver sendo detectado pelo Claude para Desktop, vá para a seção Troubleshooting para obter dicas de depuração.

4. Experimente!

Agora você pode conversar com o Claude e perguntar sobre seu sistema de arquivos. Ele deve saber quando chamar as ferramentas relevantes.

Coisas que você pode tentar perguntar ao Claude:

Você pode escrever um poema e salvá-lo na minha área de trabalho?

Quais são alguns arquivos relacionados ao trabalho na minha pasta de downloads?

Você pode pegar todas as imagens na minha área de trabalho e movê-las para uma nova pasta chamada “Images”?

Conforme necessário, o Claude chamará as ferramentas relevantes e buscará sua aprovação antes de tomar uma ação:

1. Baixe o Claude para Desktop#

2. Adicione o Filesystem MCP Server#

3. Reinicie o Claude#

4. Experimente!#

1. Baixe o Claude para Desktop

2. Adicione o Filesystem MCP Server

3. Reinicie o Claude

4. Experimente!