# WA2TG Explorador Telegram + MCP — Windows (beta)

Este aplicativo local consulta grupos e mensagens que a sua própria conta Telegram pode acessar. Também oferece ferramentas MCP de leitura para clientes compatíveis, como OpenCode.

## Requisitos

- Windows 10 ou 11.
- Python 3.11 ou superior: https://www.python.org/downloads/windows/ . Durante a instalação, marque **Add Python to PATH**.
- A sua conta Telegram e as credenciais de aplicação `api_id` e `api_hash` obtidas em https://my.telegram.org (API development tools).

## Iniciar

1. Extraia o ZIP para uma pasta normal, por exemplo `Documentos\WA2TG-Explorador`.
2. Dê dois cliques em `start.bat`. Na primeira execução, uma janela do PowerShell cria o ambiente local e instala Telethon e MCP. Isso pode levar alguns minutos.
3. Não feche a janela preta enquanto estiver usando o explorador.
4. No navegador do mesmo computador, acesse `http://127.0.0.1:8787`.
5. Informe `api_id`, `api_hash` e telefone com código do país. Peça o código de login e digite o código recebido no Telegram. Se sua conta usar senha de verificação em duas etapas, informe-a quando solicitado.
6. Siga a seção **Conectar OpenCode por MCP** na página do explorador. O servidor MCP local usa `http://127.0.0.1:8788/mcp`; mantenha o aplicativo aberto durante o uso.

Para parar, feche a janela do PowerShell. Para iniciar novamente, dê dois cliques em `start.bat`.

## Onde ficam os dados

A sessão e as credenciais são guardadas fora desta pasta, em `%LOCALAPPDATA%\WA2TG\mtproto-explorer`. O Windows protege os dados de credenciais com DPAPI. Não compartilhe essa pasta, especialmente `telegram.session` e `mcp.token`. O ZIP não leva nenhum desses arquivos.

Para revogar o acesso, use a opção de desconexão no explorador ou encerre a sessão correspondente em Telegram > Configurações > Dispositivos. Depois, apague a pasta local acima se quiser remover também os dados salvos neste computador.

## Privacidade, limites e suporte

- O aplicativo vincula seus serviços a `127.0.0.1`; eles não são publicados na internet.
- As pesquisas vão do seu computador diretamente ao Telegram. O conteúdo consultado não passa pela VPS WA2TG.
- As ferramentas MCP são somente de leitura: listam grupos, pesquisam e leem mensagens, calculam estatísticas e baixam mídia compatível. Não enviam, editam nem apagam mensagens.
- Só são acessíveis os grupos e históricos visíveis para a conta conectada. Mídias indisponíveis para download, incluindo certos conteúdos de visualização única, não podem ser recuperadas.
- Este pacote beta é um lançador em código Python, não um instalador assinado. O Windows pode mostrar um aviso ao executar scripts; confira se baixou o arquivo do site WA2TG GAMA 7.

## Arquivos

`start.bat` inicia o lançador PowerShell; `start.ps1` prepara um ambiente Python isolado; `app.py` e `index.html` compõem o aplicativo; `requirements.txt` lista as bibliotecas necessárias.
