Como conectar o Raycast ao Telegram via MCP

O Raycast é o launcher que prioriza o teclado e que, discretamente, se tornou o centro de comando de muitos power users de Mac. Você aciona um atalho, digita alguns caracteres e já está buscando, calculando, rodando scripts ou conversando com o Raycast AI — tudo sem tirar as mãos do teclado ou trocar de aplicativo. Com o suporte a MCP, o Raycast AI agora pode alcançar ferramentas externas, e é aí que a Entergram entra. O servidor MCP do Telegram da Entergram conecta a sua conta pessoal do Telegram — e não um bot — ao Raycast através do Model Context Protocol, para que você possa perguntar sobre as suas conversas reais do Telegram e agir sobre elas a partir do mesmo atalho que já usa para tudo o mais.

Este guia faz parte do nosso hub conecte qualquer ferramenta de IA ao Telegram MCP, e a página dedicada Raycast Telegram MCP cobre o conector por completo. Para o panorama geral, o hub do Telegram MCP explica como a Entergram expõe o Telegram a todos os clientes compatíveis com MCP.

O MCP é o padrão aberto que permite ao Raycast AI carregar capacidades externas sob demanda. Em vez de construir uma integração avulsa com o Telegram, o Raycast aponta para um único endpoint MCP — https://mcp.entergram.com/mcp — e descobre as ferramentas disponíveis automaticamente. Uma vez conectado, o Raycast AI pode:

• Listar e ler conversas — mensagens privadas, grupos e canais das suas contas conectadas.
• Consultar contatos e campos personalizados — estágio, responsável, tags e qualquer dado estruturado de CRM em uma conversa.
• Criar e atualizar tickets — registre um follow-up no instante em que você o percebe.
• Enviar mensagens e transmissões — dispare uma resposta ou uma transmissão a partir de um modelo.

Esta é a sua conta real do Telegram, exposta através de uma camada de CRM com permissões, em vez da limitada Bot API. O Raycast vê exatamente as conversas que você vê, limitado ao que você permitir.

O superpoder do Raycast é a velocidade de acesso. Todo o objetivo é remover o atrito de abrir um aplicativo, encontrar a janela certa e clicar por aí. O Telegram, para muita gente, é precisamente esse tipo de atrito: uma caixa de entrada movimentada, cheia de clientes, leads e grupos, que exige atenção constante e te tira do foco.

Colocar o Telegram atrás de um atalho do Raycast inverte essa lógica. Em vez de abrir o Telegram "só para dar uma olhada", você faz uma pergunta direta ao Raycast AI e recebe uma resposta direta:

• "Quem me enviou mensagem na última hora e eu ainda não respondi?"
• "Quais clientes estão esperando por mim agora?"
• "Alguém no estágio Demo ficou em silêncio esta semana?"

Você permanece no que estava fazendo, recebe a resposta em um painel e age apenas se precisar. Para quem vive no Raycast o dia inteiro, este é o lugar mais natural em que um assistente de Telegram poderia possivelmente viver — sem nova janela, sem troca de contexto, sem rolagem infinita.

No seu workspace da Entergram, abra Settings → Developer, clique em Create new OAuth client e escolha o preset Custom. Selecione os escopos com cuidado. Como o Raycast costuma ser uma forma rápida e ad hoc de verificar coisas, muita gente o inicia somente leitura (chats.read, contacts.read, custom_fields.read) e adiciona escopos de escrita como chats.write apenas quando quer enviar respostas ou abrir tickets diretamente de um comando do Raycast. O menor privilégio mantém a superfície pequena.

A URL do seu servidor MCP é:

https://mcp.entergram.com/mcp

Abra as configurações do Raycast e vá até a seção AI, onde o Raycast gerencia os seus servidores MCP. Adicione um novo servidor apontando para o endpoint acima e forneça as credenciais do cliente OAuth que você acabou de criar para que o Raycast possa se autenticar. A página Raycast Telegram MCP tem os valores exatos a inserir. O Raycast AI carrega as ferramentas da Entergram e as torna disponíveis para o AI Chat e os AI Commands.

Observe que os recursos de IA do Raycast exigem um plano Raycast Pro; os servidores MCP rodam sobre ele. Uma vez que o servidor é adicionado, você não precisa configurar nada por comando — as ferramentas simplesmente ficam disponíveis sempre que você conversa com o Raycast AI.

Na primeira vez que o Raycast se conectar, aprove a solicitação na tela de autorização da Entergram, que lista as permissões exatas sendo concedidas. Clique em Allow access.

As suas ferramentas do Telegram agora estão a um atalho de distância, e você pode revogá-las instantaneamente em Settings → Developer a qualquer momento.

Como o Raycast foi feito para invocação rápida, os melhores fluxos de Telegram aqui são curtos e em formato de resposta:

• "Quantas pessoas estão esperando uma resposta minha agora?" Uma verificação de status de uma linha antes de decidir se vale abrir o Telegram.
• "Resuma as minhas conversas não lidas das últimas duas horas." Triagem sem rolagem.
• "Encontre a conversa com a Acme e me diga em que pé está o negócio." O Raycast lê a conversa e os campos de CRM e te dá o estado em uma frase.
• "Responda à última mensagem do Jordan avisando que a fatura foi enviada." Com os escopos de escrita concedidos, o Raycast rascunha e envia sem que você abra o aplicativo.
• "Abra um ticket de alta prioridade na conversa com a reclamação de reembolso." Capture o follow-up no instante em que percebe.

Cada um é uma chamada real de ferramenta MCP contra o seu workspace, retornada dentro do Raycast. O valor não está na profundidade — está em a resposta chegar nos dois segundos que leva para digitar a pergunta, em vez dos dois minutos que leva para abrir o Telegram e perder a linha de raciocínio.

Conectar a sua conta real do Telegram a uma ferramenta que você aciona dezenas de vezes por dia merece o mesmo cuidado que qualquer outra integração. O acesso é governado por escopos OAuth, então você decide exatamente o que o Raycast pode ler e escrever. Uma configuração somente leitura é um ótimo padrão para uma ferramenta de verificação rápida; conceda escopos de escrita apenas quando realmente quiser enviar a partir do Raycast. Há um cliente OAuth por usuário, revogável instantaneamente em Settings → Developer.

A Entergram retransmite a sua sessão do Telegram no lado do servidor e armazena as credenciais criptografadas, então o Raycast trabalha através da camada de CRM em vez de reter o seu login bruto do Telegram. O conteúdo das mensagens não é retido para treinamento, e cada ação de escrita é registrada no log de atividade do workspace com um autor e um carimbo de data e hora. Se algum dia você parar de usar o Raycast, revogar o cliente OAuth dele remove o seu acesso em todos os lugares de uma só vez.

Uma vez que a conexão funciona no AI Chat, o próximo passo natural é capturar os prompts que você repete como AI Commands. Salve "Resuma as minhas conversas não lidas do Telegram das últimas duas horas" como um comando vinculado a um atalho, e a sua triagem matinal vira uma única tecla. Faça o mesmo para "Liste os clientes que estão esperando uma resposta" ou "Mostre os negócios que ficaram em silêncio esta semana". Como os AI Commands aceitam texto selecionado e argumentos, você também pode construir comandos como um "Rascunhe uma resposta de Telegram para o texto selecionado", que funciona de qualquer lugar no macOS. As ferramentas do Telegram permanecem disponíveis para todos os comandos sem configuração extra, então cada novo comando é apenas um prompt que você escreve uma vez e aciona para sempre — exatamente a filosofia do Raycast aplicada à sua caixa de entrada mais movimentada. Ao longo de uma semana, o punhado de comandos que você salvar irá, discretamente, substituir a maioria dos motivos que você tinha para abrir o Telegram.

Se o seu plano da Entergram inclui acesso à API, o conector MCP está pronto. Crie a sua conexão agora, siga o passo a passo completo na página Raycast Telegram MCP, ou navegue por todos os clientes suportados no hub conecte qualquer IA. Para os detalhes de configuração subjacentes — clientes OAuth, escopos e solução de problemas — veja o guia passo a passo do MCP. O Raycast te dá a forma mais rápida possível de alcançar as suas ferramentas; a Entergram torna o seu CRM real do Telegram uma delas, para que dar uma olhada na sua caixa de entrada mais exigente finalmente custe um atalho, e não o seu foco.