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 trabalhar com as transferências enquanto o DDM está em execução. Basta pedir o que pretende, com as suas próprias palavras:
- «O que está o DDM a transferir neste momento e quanto tempo falta?»
- «Transferir https://example.com/big.iso para D:\ISOs esta noite, mas não iniciar ainda.»
- "Interromper tudo o que está a ser transferido."
- «Remover da lista as transferências concluídas, mas manter os ficheiros.»
O assistente inicia o próprio servidor; só precisa de indicar ao assistente onde ele está, uma vez. O servidor passa cada pedido à aplicação através da sua API de automação, apenas neste computador.
O que o assistente pode fazer
| Ferramenta | O que faz |
|---|---|
list_downloads |
Apresenta as transferências por ordem decrescente de data: ficheiro, endereço, pasta, estado, tamanho, progresso e velocidade. Pode apresentar apenas as transferências com um determinado estado (Em fila, A transferir, 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 a transferência ou coloca-a apenas em fila. Pode especificar a pasta e o nome do ficheiro. Uma ligação magnet abre Adicionar torrent no DDM, para que possa escolher os ficheiros. |
pause_downloads |
Interrompe as transferências em curso. |
resume_downloads |
Inicia ou retoma as transferências paradas, em fila ou com erro. |
remove_downloads |
Remove as transferências da lista e mantém os respetivos ficheiros ou, se lhe for pedido, também elimina os ficheiros. É necessário interromper primeiro uma transferência em curso. |
start_queue |
Inicia a fila de transferências principal. |
O assistente não pode alterar as opções do DDM, ver o navegador nem ativar a API de automação por iniciativa própria.
Configurar
1. Ligar a API de automação
Para listar e controlar as transferências, é necessária a API de automação do DDM, que está desligada até a ativar. Com o DDM em execução, execute este comando uma vez (a API permanece ligada):
dannexdownloadmanager-cli api on
dannexdownloadmanager-cli api offdesliga-a novamente. Sem a API, o assistente pode continuar a adicionar transferências, tal como através da linha de comandos do DDM.
2. Localizar o servidor
dannexdownloadmanager-mcpencontra-se junto à aplicação:
| Instalação | Servidor |
|---|---|
| Windows, apenas para si (predefiniçã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 da aplicação |
| 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 automaticamente o DDM dessa cópia, a partir da respetiva pasta.
3. Diga ao seu assistente
Claude Desktop: Definições → Programador → Editar Configuração abre claude_desktop_config.json. Adicione o servidor e, em seguida, 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 que a do Claude Desktop, em ~/.cursor/mcp.json (ou adicione-a nas definiçõ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 do passo 2 (em JSON, cada \ é escrito \\). Outros assistentes usam o mesmo: um comando para iniciar, sem argumentos.
Privacidade
O próprio DDM continua a não enviar nada para lado nenhum: o servidor comunica apenas com o DDM neste computador, através do canal local protegido por token. No entanto, o que o assistente lê é enviado para o serviço de IA do próprio assistente: quando este lista as suas transferências, os nomes dos ficheiros, os endereços e as pastas são enviados para esse serviço, ao abrigo dos respetivos termos de privacidade. Desative a API de automatizaçã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 o pode iniciar por si. |
| A API de automação está desativada | Execute dannexdownloadmanager-cli api on com o DDM em execução. |
| O DDM não respondeu a tempo | Uma janela no DDM pode estar à sua espera (uma pergunta, Adicionar torrent); responda e pergunte novamente. |
| O DDM recusou o pedido | O ficheiro de canal do DDM é de um início anterior; reinicie o DDM. |
| As ferramentas não aparecem de todo | Verifique o caminho nas definiçõ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 avaliação.
Transferir Dannex Download Manager