Servidor MCP do Mail Viewer: Conversão e Inspeção de E-mails com Inteligência Artificial

O CoolUtils Mail Viewer inclui um servidor MCP (Model Context Protocol) integrado. Execute MailViewer.exe --mcp e o programa ignora sua interface gráfica, tornando-se um servidor em segundo plano que assistentes de IA podem chamar diretamente. Claude Code, Claude Desktop, Cursor, Cline e qualquer agente compatível com MCP podem então converter, ler e extrair anexos de seus arquivos de e-mail — respondendo a instruções em linguagem natural, sem nenhum script personalizado.

O Que É MCP?

Model Context Protocol é um padrão aberto publicado pela Anthropic que permite que agentes de IA chamem softwares de desktop como se fossem uma API remota. Em vez de escrever scripts ou usar a linha de comando, você descreve o que precisa em linguagem natural. O agente resolve os parâmetros e invoca a ferramenta correta — neste caso, o Mail Viewer rodando silenciosamente em segundo plano.

O servidor MCP está integrado ao binário normal do MailViewer.exe. Não há nada extra para instalar ou licenciar. O sinalizador --mcp apenas altera o comportamento de inicialização: a interface gráfica é ocultada e uma thread de leitura stdio em segundo plano é iniciada.

O Que Você Pode Fazer

Uma vez conectado, você pode dar instruções ao seu assistente de IA como estas:

Três Ferramentas Disponíveis

convert_mail

Converte um arquivo de e-mail para o formato de saída especificado. Usa o mecanismo completo de renderização do Mail Viewer, então a saída em PDF e DOCX inclui HTML incorporado, imagens inline, pré-visualizações de anexos e cabeçalhos de mensagem — idêntico ao que você vê na interface gráfica.

Formatos de origem: .eml, .msg, .mim, .p7m, .vmbx, .tnef, .mapixml, .olk15, .vcf, .contact, .3uc
Formatos de saída: pdf, html, txt, doc, rtf, tiff, jpg, png, bmp, emf, eml, xps

get_mail_info

Lê um arquivo de e-mail e retorna seus metadados como JSON: remetente, destinatários Para/CC/CCO, assunto, data, cabeçalhos RFC brutos, corpo em texto simples e HTML, e uma lista de anexos com nomes, tamanhos e tipos de conteúdo. O arquivo de origem não é modificado.

extract_attachments

Salva todos os anexos de um arquivo de e-mail em uma pasta de destino (criada automaticamente se não existir). Retorna a lista de arquivos salvos com seus caminhos absolutos e tamanhos em bytes.

Conectar ao Claude Code

Adicione o seguinte bloco ao seu arquivo ~/.claude.json dentro do objeto mcpServers (crie a chave se ela não existir):

{
  "mcpServers": {
    "mailviewer": {
      "command": "C:\\Program Files\\CoolUtils\\CoolUtils Mail Viewer\\MailViewer.exe",
      "args": ["--mcp"]
    }
  }
}

Um trecho pronto para copiar e colar está instalado ao lado do executável como claude-config-snippet.json. Ajuste o caminho se você instalou o Mail Viewer em um local diferente do padrão.

Conectar ao Claude Desktop

Abra %APPDATA%\Claude\claude_desktop_config.json e adicione o mesmo bloco em mcpServers:

{
  "mcpServers": {
    "mailviewer": {
      "command": "C:\\Program Files\\CoolUtils\\CoolUtils Mail Viewer\\MailViewer.exe",
      "args": ["--mcp"]
    }
  }
}

O mesmo formato de configuração funciona para Cursor, Cline e qualquer outro agente que suporte o padrão Model Context Protocol.

Verificar a Instalação

Execute o seguinte em um prompt de comando para confirmar que o servidor MCP responde corretamente:

echo {"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"t","version":"0"}}} | "C:\Program Files\CoolUtils\CoolUtils Mail Viewer\MailViewer.exe" --mcp

Você deve ver uma única resposta JSON-RPC contendo protocolVersion, serverInfo e uma capacidade tools. Se aparecer, o servidor está pronto para uso.

Detalhes Técnicos

Para desenvolvedores e integradores: o servidor se comunica via stdio usando NDJSON (uma mensagem JSON-RPC 2.0 por linha, codificação UTF-8). Versão do protocolo: 2024-11-05. Nome do servidor informado no initialize: mailviewer-mcp. Os esquemas de entrada completos para todas as três ferramentas estão instalados junto ao executável como mcp-tools.json. Um manifesto do servidor legível por máquina está disponível como mcp-server.json.