IA by DNACX

#15 no GitHub · Agir no código

Como instalar e usar o Desktop Commander

Um servidor MCP que dá à IA acesso ao seu computador: ela lê e edita arquivos, procura texto em pastas e executa comandos de terminal, inclusive programas que ficam rodando.

Para quem
Quem quer que o Claude Code mexa em arquivos e rode comandos no computador, e aceita dar esse poder à IA depois de entender os riscos.
Estrelas (07/11/2026)
10.246, #15 no ranking
Licença
MIT
Repositório
wonderwhy-er/DesktopCommanderMCP

Passo a passo

Antes de começar: Node.js, para as opções que usam o npx (o README lista Node.js como requisito da maioria das opções); Um cliente MCP compatível. O README tem uma seção própria para o Claude Code; Para a opção em contêiner: Docker Desktop instalado e rodando (a opção Docker dispensa o Node.js).

  1. Leia os avisos de segurança primeiro

    Este servidor executa comandos e altera arquivos no seu computador. O README avisa que as proteções têm limites conhecidos e que ele não é uma caixa isolada. Leia os cuidados desta página antes de instalar.

  2. Adicione o servidor ao Claude Code

    No terminal, cole o comando e aperte Enter. Com --scope user ele vale para todos os seus projetos. O README diz que, tirando essa parte, a instalação fica só no projeto atual.

    Comando
    claude mcp add --scope user desktop-commander -- npx -y @wonderwhy-er/desktop-commander@latest

  3. Restrinja as pastas que o servidor pode alcançar

    O README descreve a configuração allowedDirectories, que limita as pastas para operações de arquivo. Ela não limita o terminal. Se quiser usar, o README recomenda caminhos específicos em vez de caminhos amplos.

  4. Mude configurações em outra conversa

    O README manda alterar a configuração numa janela de conversa separada daquela em que você trabalha, porque o Claude às vezes tenta mudar a configuração por conta própria quando esbarra numa restrição.

  5. Peça ajuda para começar

    Depois de instalado, peça ao Claude a introdução do próprio servidor. O README diz que ele mostra tutoriais e exemplos para iniciantes.

  6. Se quiser isolamento, use a opção Docker

    O README oferece uma instalação em contêiner Docker, que ele descreve como isolada do seu sistema, com pastas montadas só se você escolher. Exige Docker Desktop instalado e rodando.

Primeiro teste

Numa sessão com o servidor conectado, cole:

Primeiro teste
Help me get started with Desktop Commander

Segundo o README, o Claude mostra tutoriais e exemplos para iniciantes, como organizar a pasta Downloads, analisar planilhas CSV e Excel com Python e explorar um código.

Cuidados

  • O README declara as proteções como salvaguardas e diz que elas não são uma caixa isolada (not a sandbox): bloqueio de travessia por links simbólicos, lista de comandos bloqueados contra execução acidental e a opção de isolamento por Docker.
  • O README avisa que restrições de diretório e bloqueio de comandos podem ser contornados por vários métodos, incluindo links simbólicos, substituição de comandos, caminhos absolutos e execução de código.
  • A configuração allowedDirectories restringe só operações de arquivo, não os comandos de terminal, que continuam alcançando arquivos fora das pastas permitidas.
  • Deixar allowedDirectories como uma lista vazia dá acesso ao sistema de arquivos inteiro nas operações de arquivo.
  • Para segurança mais forte o README manda usar a instalação em Docker, que ele diz oferecer isolamento completo do seu sistema.
  • Os comandos executados e seus argumentos ficam registrados localmente, na máquina que roda o servidor, e esse histórico pode conter argumentos das chamadas e prévias limitadas dos resultados.
  • Há telemetria limitada e pseudônima. O README diz que não coleta conteúdo de arquivos, caminhos de arquivos nem argumentos de comandos, e que dá para desligar pedindo ao Claude ou com telemetryEnabled igual a false na configuração.
  • Várias opções de instalação atualizam sozinhas ao reiniciar o cliente, porque usam a versão latest.

Como desfazer

O README traz um desinstalador automático, que remove o servidor da configuração do Claude e cria um backup antes. Para o Claude Code o README não descreve um passo próprio de remoção, e o comando abaixo é o documentado para o Claude Desktop.

Desfazer
npx @wonderwhy-er/desktop-commander@latest remove

O que o README não confirma

Esta página foi montada lendo o README. Estes pontos não estão escritos lá:

  • O README descreve o fluxo de início principalmente para o Claude Desktop; o comportamento do tutorial dentro do Claude Code não está confirmado.
  • O README não informa custo. Ele diz que usa a assinatura do cliente em vez de custo de token de API, e isso não foi conferido.
  • O comando de remoção do README fala em remover da configuração do Claude Desktop. Não está confirmado se ele remove o registro feito no Claude Code.
  • Não está confirmado como o servidor se comporta em cada sistema operacional.

Dúvidas

Isso é seguro?

O README diz que as proteções não são uma caixa isolada e que podem ser contornadas. Para isolamento de verdade ele indica a instalação em Docker.

Ele envia meus arquivos para algum lugar?

O README diz que a telemetria não coleta conteúdo de arquivos, caminhos nem argumentos de comandos. O histórico de chamadas fica na própria máquina.

Dá para usar sem Node.js?

O README diz que a opção Docker não exige Node.js, mas exige o Docker Desktop instalado e rodando.

Ele lê planilhas e documentos do Office?

Sim, segundo a lista de recursos do README: arquivos Excel, PDF e Word (.docx) para ler, e também para criar ou editar em vários casos.

A DNACX usa o Desktop Commander?

Esta página foi montada a partir do README oficial. A DNACX não rodou cada passo, então confira a saída de cada comando e, se algo falhar, volte ao README do repositório.

Próximo da lista

← #14 Mobile MCP

Ver os 15 MCPs

Por Diogo Kammers, da DNACX. Passo a passo montado a partir do README oficial de wonderwhy-er/DesktopCommanderMCP, lido em . A DNACX não rodou cada passo desta página. O servidor é de terceiros e a DNACX não o criou.