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 interagir com os downloads no MDM em execução. Basta pedir com suas próprias palavras:

  • "O que o MDM 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 MDM 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 MDM, 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 MDM, que fica desativada até ser ativada. Com o MDM em execução, execute este comando uma vez (a API permanecerá ativada):

mattdownloadmanager-cli api on

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

2. Localizar o servidor

mattdownloadmanager-mcpfica ao lado do aplicativo:

Instalação Local do servidor
Windows, somente para você (padrã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 do aplicativo
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 o MDM 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": {
    "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 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": {
    "mattdownloadmanager": {
      "type": "stdio",
      "command": "C:\\Users\\you\\AppData\\Local\\Programs\\Matt Download Manager\\mattdownloadmanager-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 MDM não envia nada para lugar nenhum: o servidor se comunica apenas com o MDM 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
Matt Download Manager isn't running Inicie o MDM. O servidor não pode iniciá-lo para você.
A API de automação está desativada Execute mattdownloadmanager-cli api on com o MDM em execução.
MDM não respondeu a tempo Pode haver uma janela do MDM aguardando sua resposta (uma pergunta, Adicionar torrent). Responda e tente novamente.
MDM recusou a solicitação O arquivo de canal do MDM é de um início anterior; reinicie o MDM.
As ferramentas não aparecem Verifique o caminho nas configuraçõ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 teste.

Baixar Matt Download Manager