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