MCTL for Telegram

Sua conta Telegram autorizada, dentro do seu assistente de IA

Instale pelo Diretório de Apps do ChatGPT ou conecte-se via Configurações → Apps. Resuma conversas, pesquise mensagens e rascunhe respostas a partir do ChatGPT, Claude ou qualquer cliente MCP — após o login OAuth na conta Telegram que você possui e controla.

Política de privacidade · Modelo de segurança · [email protected] · Quer a sessão na sua própria máquina? Local Bridge

O que você pode fazer

Resumir conversas não lidas

Pergunte ao seu assistente o que você perdeu enquanto esteve ausente. Receba um resumo de qualquer conversa, grupo ou canal sem abrir o Telegram.

Rascunhar e revisar mensagens

Deixe seu assistente escrever ou revisar uma resposta antes de você enviar. Revise o tom, corrija erros ou traduza — e envie quando estiver pronto.

Pesquisar em todas as conversas

Encontre qualquer coisa que você disse ou recebeu, instantaneamente. Pesquise por tópico, pessoa ou data em todo o seu histórico.

Triar sua caixa de entrada

Liste todas as conversas e identifique o que ainda precisa de resposta, para que você possa limpar um acúmulo de conversas não lidas de uma só vez.

Traduzir em tempo real

Leia conversas em outros idiomas no seu próprio idioma, ou rascunhe uma resposta no idioma deles — sem sair da conversa.

Fixar o que importa

Peça ao seu assistente para fixar uma mensagem importante em uma conversa (requer direitos de administrador em grupos) para que o importante fique no topo, onde todos veem.

Como funciona

Seu cliente de IA Claude, ChatGPT…

Servidor MCP mctl-telegram

API MTProto do Telegram

1. Você autoriza com o login do Telegram. O mctl-telegram armazena uma sessão MTProto criptografada em seu nome.
2. Quando você solicita ao seu assistente, ele chama as ferramentas MCP neste servidor por meio de uma conexão autenticada por OAuth.
3. O mctl-telegram faz chamadas MTProto ao Telegram, formata o resultado e o retorna ao seu assistente.

Instalar no ChatGPT

1. Abra o ChatGPT → Configurações → Apps e selecione seu aplicativo de rascunho (ou instale pelo Diretório de Apps quando publicado).
2. Defina a URL do servidor MCP como https://tg.mctl.ai/mcp.
3. Autenticação: OAuth. O ChatGPT descobre este servidor via https://tg.mctl.ai/.well-known/oauth-protected-resource e https://tg.mctl.ai/.well-known/oauth-authorization-server.
4. Conclua o fluxo de login do Telegram no seu navegador quando solicitado.
5. Teste com uma ferramenta somente leitura (list_dialogs ou get_unread_messages) antes de habilitar envios reais. No tg.mctl.ai, envios reais permanecem bloqueados até que todas as permissões de adesão sejam ativadas (veja send-gate).
6. Revise nossa política de privacidade e modelo de segurança antes de conectar sua conta.

Outros clientes MCP

1. Qualquer cliente: copie a URL MCP https://tg.mctl.ai/mcp e adicione-a como um conector personalizado. A autenticação é OAuth — você faz login com o Telegram uma vez durante a configuração.
2. Claude: abra Configurações de conectores, escolha Adicionar conector personalizado e cole a URL MCP.
3. ChatGPT (fora do fluxo do Diretório de Apps acima): abra Configurações → Conectores, adicione um conector personalizado e cole a URL MCP. Requer um plano com conectores personalizados habilitados — veja o Guia de Modo Desenvolvedor e apps MCP da OpenAI.
4. Cursor, Windsurf e outros: cole a URL MCP nas configurações do conector MCP remoto do seu cliente. Veja /docs para URLs de descoberta OAuth e um comando de teste rápido.

Dados em resumo

• Armazenados neste servidor: um blob de sessão Telegram criptografado com AES-256-GCM por conta e metadados de auditoria sem texto de mensagem. Quando o Agente de Comunicação está habilitado, conteúdo relevante de mensagens/eventos recebidos e payloads de ações propostas também são armazenados criptografados em repouso.
• Não armazenados em logs ou histórico de auditoria: corpos de mensagens, números de telefone, senhas 2FA ou tokens OAuth.
• Através do ChatGPT: seus prompts, argumentos de ferramentas e resultados de ferramentas passam pelo cliente ChatGPT para chegar a este servidor; as práticas de dados do próprio ChatGPT se aplicam a esse tráfego.
• Seus controles: desconecte ou exclua sua conta a qualquer momento via ferramentas MCP ou API HTTP. Inventário completo em nossa política de privacidade.

Nosso modelo de confiança

O mctl-telegram mantém uma sessão Telegram no lado do servidor em seu nome. Aqui está exatamente o que isso significa:

• Sessões são criptografadas com AES-256-GCM em repouso com chaves por usuário derivadas via HKDF-SHA256.
• O texto da mensagem nunca é gravado em logs ou histórico de auditoria. O conteúdo de mensagens e ações do Agente de Comunicação é criptografado em repouso e retido de acordo com a política em /privacy.
• Você pode desconectar (revogação suave) ou excluir (exclusão definitiva) sua sessão a qualquer momento usando as ferramentas MCP ou a API.

Endpoint MCP: https://tg.mctl.ai/mcp
Documento de recurso protegido por OAuth: https://tg.mctl.ai/.well-known/oauth-protected-resource

Modelo de segurança completo Retenção de dados Referência do desenvolvedor

Mantenha a sessão na sua máquina

Local Bridge (beta) é o caminho de autoatendimento onde a sessão do Telegram permanece em uma máquina que você controla e o tg.mctl.ai atua apenas como retransmissor. Não é o caminho de instalação do App ChatGPT. Você precisa de uma máquina que permaneça ligada. A ativação é por autoatendimento.

1. init, depois login --phone +…
2. activate --server https://tg.mctl.ai e aprove o dispositivo em um navegador. Após login, --telegram-id é opcional.
3. daemon — a primeira credencial é somente leitura. Ative o envio você mesmo com set_send_consent ou a página gerenciar.

Início rápido Visão geral Controles do proprietário Suporte e recuperação

Perguntas frequentes

Com quais assistentes de IA isso funciona?

Qualquer cliente que suporte conectores MCP remotos — Claude, ChatGPT, Cursor, Windsurf e outros. É um servidor MCP padrão autenticado por OAuth, portanto não está vinculado a um único fornecedor.

Este é um aplicativo oficial do Telegram?

Não. O mctl-telegram é um projeto independente, não afiliado ou endossado pelo Telegram ou OpenAI. Ele opera apenas na conta Telegram que você conecta explicitamente, e você permanece responsável por seguir os termos do Telegram.

Ele pode enviar mensagens em meu nome?

Somente se você aderir explicitamente. No tg.mctl.ai, o padrão efetivo é simulação: ALLOW_SEND=false bloqueia envios reais, então send_message retorna uma prévia (sent=false) em vez disso. Envios reais adicionalmente exigem o sinalizador send_enabled da sua conta (você ativa isso com set_send_consent ou a página gerenciar) e o escopo telegram:messages:send — não há argumento de modo para contornar a permissão.

Quais dados o ChatGPT vê?

Seus prompts de conversa, os argumentos de ferramentas que o ChatGPT envia (ex.: peer, texto de mensagem para rascunhos) e os resultados de ferramentas que este servidor retorna. Esse tráfego é tratado pelo ChatGPT sob as políticas da OpenAI. Para chamadas MCP comuns, este servidor armazena um blob de sessão criptografado e metadados de auditoria. Contas com Agente de Comunicação habilitado armazenam adicionalmente conteúdo criptografado de mensagens e ações, conforme descrito em /privacy.

Quais dados o mctl-telegram armazena?

Um blob de sessão criptografado e metadados são armazenados por conta. Quando o Agente de Comunicação está habilitado, mensagens/eventos recebidos relevantes e payloads de ações propostas são armazenados criptografados em repouso; logs e histórico de auditoria ainda excluem corpos de mensagens. Veja /privacy para detalhes de retenção.

Como revogo o acesso?

Chame a ferramenta MCP disconnect_telegram_account (revogação suave, mantém a linha) ou delete_telegram_account (exclusão definitiva, remove todos os seus dados). Você também pode revogar pelo lado do Telegram: Configurações → Dispositivos.

Isso é código aberto?

Sim. O código-fonte completo está em github.com/mctlhq/mctl-telegram. Você pode auditar o código, executar sua própria implantação ou contribuir.

O que é o Local Bridge?

Um modo auto-hospedado opcional (beta) onde a sessão do Telegram permanece na sua própria máquina e o tg.mctl.ai atua apenas como retransmissor. Não faz parte do caminho padrão de instalação do App ChatGPT e precisa de uma máquina que permaneça ligada, mas ativá-lo é por autoatendimento: init, login, activate, daemon. Migrar uma conta hospedada existente para este modo ainda usa set_account_mode (uma etapa de operador, não de integração). Comece pelo início rápido.