O MDM inclui um servidor MCP, mattdownloadmanager-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 MDM está em execução. Basta pedir o que pretende, com as suas próprias palavras:
- «O que está o MDM 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 MDM, 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 MDM, 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 MDM, que está desligada até a ativar. Com o MDM em execução, execute este comando uma vez (a API permanece ligada):
mattdownloadmanager-cli api on
mattdownloadmanager-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 MDM.
2. Localizar o servidor
mattdownloadmanager-mcpencontra-se junto à aplicação:
| Instalação | Servidor |
|---|---|
| Windows, apenas para si (predefinição do instalador) | %LOCALAPPDATA%\Programs\Matt Download Manager\mattdownloadmanager-mcp.exe |
| Windows, para todos | C:\Program Files\Matt Download Manager\mattdownloadmanager-mcp.exe |
| Windows, um zip ou cópia portátil | mattdownloadmanager-mcp.exena pasta da aplicação |
| macOS | /Applications/Matt Download Manager.app/Contents/MacOS/mattdownloadmanager-mcp |
| Linux, pacote .deb ou .rpm | /usr/bin/mattdownloadmanager-mcp |
| Linux, o .tar.gz | mattdownloadmanager-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 MDM 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": {
"mattdownloadmanager": {
"command": "C:\\Users\\you\\AppData\\Local\\Programs\\Matt Download Manager\\mattdownloadmanager-mcp.exe"
}
}
}
Claude Code:
claude mcp add mattdownloadmanager -- "C:\Users\you\AppData\Local\Programs\Matt Download Manager\mattdownloadmanager-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": {
"mattdownloadmanager": {
"type": "stdio",
"command": "C:\\Users\\you\\AppData\\Local\\Programs\\Matt Download Manager\\mattdownloadmanager-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 MDM continua a não enviar nada para lado nenhum: o servidor comunica apenas com o MDM 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 |
|---|---|
| Matt Download Manager isn't running | Inicie o MDM. O servidor não o pode iniciar por si. |
| A API de automação está desativada | Execute mattdownloadmanager-cli api on com o MDM em execução. |
| O MDM não respondeu a tempo | Uma janela no MDM pode estar à sua espera (uma pergunta, Adicionar torrent); responda e pergunte novamente. |
| O MDM recusou o pedido | O ficheiro de canal do MDM é de um início anterior; reinicie o MDM. |
| As ferramentas não aparecem de todo | Verifique o caminho nas definições do assistente e reinicie o assistente. Iniciado manualmente, mattdownloadmanager-mcp --help diz o que é. |
Gratuito, de código aberto, sem anúncios, sem período de avaliação.
Transferir Matt Download Manager