Dannex Download Manager
  1. Início
  2. Ajuda
  3. Assistentes de IA (MCP)

Assistentes de IA (MCP)

O DDM inclui um servidor MCP, dannexdownloadmanager-mcp, para que um assistente de IA compatível com MCP (Claude Desktop, Claude Code, Cursor, VS Code e outros) possa interagir com os downloads no DDM em execução. Basta pedir com suas próprias palavras:

  • "O que o DDM está baixando agora e quanto tempo falta?"
  • "Baixe https://example.com/big.iso para D:\ISOs esta noite, não comece ainda."
  • "Pausar todos os downloads em andamento."
  • "Remover os downloads concluídos da lista, mas manter os arquivos."

O assistente inicia o servidor; basta informar a ele onde encontrá-lo, uma única vez. O servidor encaminha cada solicitação ao aplicativo pela API de automação, somente neste computador.

O que o assistente pode fazer

Ferramenta O que faz
list_downloads Lista seus downloads, do mais recente ao mais antigo: arquivo, endereço, pasta, status, tamanho, progresso e velocidade. Pode listar apenas downloads com um status específico (Na fila, Baixando, Parado, Concluído, Erro) ou apenas os nomes e endereços que contenham determinado texto.
add_download Adiciona um endereço http, https, ftp ou ftps e inicia o download, ou apenas o coloca na fila. Pode especificar a pasta e o nome do arquivo. Um link magnético abre Adicionar torrent no DDM para que escolha os arquivos.
pause_downloads Pausa os downloads em andamento.
resume_downloads Inicia ou retoma downloads parados, na fila ou com falha.
remove_downloads Remove downloads da lista e mantém os arquivos, ou também os exclui quando solicitado. É preciso pausar um download em andamento antes de removê-lo.
start_queue Inicia a fila principal de downloads.

O assistente não pode alterar as opções do DDM, ver seu navegador nem ativar a API de automação por conta própria.

Configurar

1. Ativar a API de automação

Para listar e controlar downloads, é necessária a API de automação do DDM, que fica desativada até ser ativada. Com o DDM em execução, execute este comando uma vez (a API permanecerá ativada):

dannexdownloadmanager-cli api on

dannexdownloadmanager-cli api offdesativa a API novamente. Sem ela, o assistente ainda pode adicionar downloads, assim como pela linha de comando do DDM.

2. Localizar o servidor

dannexdownloadmanager-mcpfica ao lado do aplicativo:

Instalação Local do servidor
Windows, somente para você (padrão do instalador) %LOCALAPPDATA%\Programs\Dannex Download Manager\dannexdownloadmanager-mcp.exe
Windows, para todos C:\Program Files\Dannex Download Manager\dannexdownloadmanager-mcp.exe
Windows, um zip ou cópia portátil dannexdownloadmanager-mcp.exena pasta do aplicativo
macOS /Applications/Dannex Download Manager.app/Contents/MacOS/dannexdownloadmanager-mcp
Linux, pacote .deb ou .rpm /usr/bin/dannexdownloadmanager-mcp
Linux, o .tar.gz dannexdownloadmanager-mcpna sua pasta (o AppImage não o expõe: use o .tar.gz)

O servidor de uma cópia portátil encontra o DDM da cópia portátil sozinho, a partir da sua própria pasta.

3. Informe seu assistente

Claude Desktop: Configurações → Desenvolvedor → Editar Config abre claude_desktop_config.json. Adicione o servidor e reinicie o Claude Desktop:

{
  "mcpServers": {
    "dannexdownloadmanager": {
      "command": "C:\\Users\\you\\AppData\\Local\\Programs\\Dannex Download Manager\\dannexdownloadmanager-mcp.exe"
    }
  }
}

Claude Code:

claude mcp add dannexdownloadmanager -- "C:\Users\you\AppData\Local\Programs\Dannex Download Manager\dannexdownloadmanager-mcp.exe"

Cursor: a mesma entrada mcpServers do Claude Desktop, em ~/.cursor/mcp.json (ou adicione-a nas configurações MCP do Cursor).

VS Code: em .vscode/mcp.json, ou MCP: Adicionar Servidor na paleta de comandos:

{
  "servers": {
    "dannexdownloadmanager": {
      "type": "stdio",
      "command": "C:\\Users\\you\\AppData\\Local\\Programs\\Dannex Download Manager\\dannexdownloadmanager-mcp.exe"
    }
  }
}

Use o caminho da etapa 2 (em JSON, cada \ é escrito \\). Outros assistentes usam a mesma coisa: um comando para iniciar, sem argumentos.

Privacidade

O DDM não envia nada para lugar nenhum: o servidor se comunica apenas com o DDM neste computador, pelo canal local protegido por token. Mas o assistente envia ao próprio serviço de IA as informações que lê. Quando lista seus downloads, os nomes dos arquivos, os endereços e as pastas são enviados a esse serviço, de acordo com os termos de privacidade dele. Desative a API de automação ou remova o servidor do assistente se não quiser que isso aconteça.

Quando não funciona

O assistente diz O que fazer
Dannex Download Manager não está em execução Inicie o DDM. O servidor não pode iniciá-lo para você.
A API de automação está desativada Execute dannexdownloadmanager-cli api on com o DDM em execução.
DDM não respondeu a tempo Pode haver uma janela do DDM aguardando sua resposta (uma pergunta, Adicionar torrent). Responda e tente novamente.
DDM recusou a solicitação O arquivo de canal do DDM é de um início anterior; reinicie o DDM.
As ferramentas não aparecem Verifique o caminho nas configurações do assistente e reinicie o assistente. Iniciado manualmente, dannexdownloadmanager-mcp --help diz o que é.

Gratuito, de código aberto, sem anúncios, sem período de teste.

Baixar Dannex Download Manager