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

Assistentes de IA (MCP)

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