← Todos os conectores MCP do Telegram

Raycast · MCP

Conecte o Telegram ao Raycast

Adicione a Entergram como servidor MCP no Raycast e alcance sua conta real do Telegram com um atalho — verifique mensagens perdidas e clientes esperando sem abrir o Telegram.

URL do servidor MCP https://mcp.entergram.com/mcp

O Raycast oferece suporte a servidores MCP por meio do comando «Manage MCP Servers». A Entergram expõe sua conta pessoal do Telegram como um servidor MCP hospedado, então o Raycast AI atua sobre suas conversas reais com total segurança via OAuth — sem bot, sem chaves de API.

Configuração pronta para colar

Raycast → Manage MCP Servers → Add
{
  "mcpServers": {
    "entergram": {
      "url": "https://mcp.entergram.com/mcp"
    }
  }
}

Pergunte ao Raycast sobre o seu Telegram

Com sua conta pessoal conectada, o Raycast AI confere o Telegram com um atalho. Experimente:

  • «Perdi alguma mensagem de cliente na última hora?»
  • «Quais conversas estou esquecendo de responder?»
  • «Quantos leads esfriaram esta semana?»
  • «Resuma o feedback dos clientes de hoje.»
  • «Escreva uma resposta para a minha última mensagem sem resposta.»

Conecte o Raycast em 3 passos

Funciona com o Raycast AI no macOS.

  1. 01

    Copie sua URL do MCP na Entergram

    Na Entergram, abra Settings → Workspace → Connectors → MCP e copie a URL do seu servidor MCP.

  2. 02

    Adicione o servidor no Raycast

    Execute o comando «Manage MCP Servers» do Raycast e adicione um servidor com a URL da Entergram: https://mcp.entergram.com/mcp.

  3. 03

    Autorize e use

    Clique em Connect, faça login com sua conta da Entergram e clique em Allow access. O Raycast AI pode então consultar e atuar sobre sua conta do Telegram de qualquer lugar do seu Mac.

Três formas de disparar

Raycast AI Chat

O caminho padrão e por onde começar. Aperte o atalho do Raycast, abra o AI Chat, mencione o servidor da Entergram no prompt para que as ferramentas dele entrem em jogo e leia a resposta na mesma janela que você abriu. Nada mais na tela precisa se mexer, que é o objetivo inteiro.

Um AI Command com tecla própria

Pegue a pergunta que você faz vinte vezes por dia — o que está esperando por mim agora — salve como AI Command e associe uma tecla. Um atalho de dentro de qualquer aplicativo devolve a resposta. Adicione um argumento de placeholder e o mesmo comando aceita um nome de cliente digitado na hora da invocação.

Manage MCP Servers

O Raycast guarda a lista de servidores atrás do comando Manage MCP Servers, e cada entrada é JSON puro. Vale saber quando você monta a mesma coisa em um segundo Mac: cole a entrada, faça o login uma vez e todos os comandos salvos funcionam lá sem serem refeitos. É também onde você vai quando um comando silenciosamente parou de enxergar o seu workspace, já que a lista mostra se o servidor ainda está habilitado.

Perguntas que você dispara no meio da frase

Não é aqui que você roda um trabalho de quarenta passos. É aqui que você consegue um fato nos dois segundos antes de alguém terminar de te pedir. Cada um destes é um atalho, duas ou três chamadas de ferramenta e uma resposta curta o bastante para ler em pé — a cadeia de ferramentas só importa porque explica por que a resposta chega tão rápido.

Você pergunta

«Qual foi a última coisa que o Marco me disse, e eu respondi?»

Ferramentas chamadas

entergram_list_chatsentergram_list_messages

Você recebe

Duas chamadas e uma linha de volta: a mensagem, o horário e se o último turno da conversa foi dele ou seu. Essa é a consulta que vale colocar em uma tecla, porque você precisa dela enquanto a pessoa ainda está perguntando e a alternativa é abrir um aplicativo e rolar a tela na frente dela.

Você pergunta

«Existe algum ticket aberto da Northwind agora?»

Ferramentas chamadas

entergram_list_chatsentergram_list_chat_tickets

Você recebe

Ele resolve a conversa daquela conta, puxa os tickets ligados a ela e informa status e prioridade de tudo que ainda está aberto. Suficiente para responder a um cliente ao vivo em uma call, e suficiente para saber se você está prestes a abrir um duplicado de algo que um colega criou uma hora atrás.

Você pergunta

«Avise o grupo do standup que eu chego em cinco minutos.»

Ferramentas chamadas

entergram_list_accountsentergram_list_chatsentergram_send_message

Você recebe

A escrita que mais gente coloca em um atalho. Ele descobre qual conta conectada é dona daquele grupo antes de enviar, então a mensagem chega vinda de você e não da conta que por acaso ficou em primeiro na ordenação. Este aqui precisa de um conector de workspace — um agente pessoal lê o grupo tranquilamente e depois para no envio.

Você pergunta

«O que temos registrado deste contato — plano, responsável, data de renovação?»

Ferramentas chamadas

entergram_list_contactsentergram_get_chat_custom_fields

Você recebe

O nome vira um contato e então as colunas de CRM ligadas à conversa dele voltam, com as vazias removidas. Disparado dez segundos antes de uma call começar, é a diferença entre abrir com contexto e abrir com uma pergunta cuja resposta já estava escrita.

Você pergunta

«Quem é o responsável pelo ticket 412 e quando ele mexeu nisso pela última vez?»

Ferramentas chamadas

entergram_get_ticketentergram_list_members

Você recebe

O registro do ticket carrega um id de responsável; a consulta de membros transforma isso em um nome que você reconhece. Responsável, status e última atualização voltam em uma linha — que é exatamente o conteúdo da mensagem que você senão postaria no canal do time e ficaria esperando resposta. Pergunte duas vezes num dia e você já eliminou uma pequena interrupção recorrente na vida de outra pessoa.

Você pergunta

«Dê um joinha na última mensagem do canal de lançamento.»

Ferramentas chamadas

entergram_list_chatsentergram_list_messagesentergram_set_message_reactions

Você recebe

Uma confirmação em três chamadas que custa menos tempo do que trocar de janela. Ele encontra o canal, pega o id da mensagem mais recente do histórico e define a reação. Útil justamente quando você quer que uma sala saiba que você leu algo e está no meio de outra coisa que não quer largar.

O que o Raycast pode fazer com o seu Telegram

  • Consultar conversas do Telegram de qualquer lugar do macOS
  • Mostrar mensagens perdidas na hora
  • Consultar contatos e campos do CRM
  • Enviar mensagens e respostas com sua aprovação
  • Quantificar oportunidades perdidas e feedbacks
  • Disparar ações do Telegram com um atalho

O que está por trás do launcher

O conector entrega ao Raycast as mesmas 70 ferramentas em 9 grupos que um agente completo recebe, ainda que uma pergunta típica de launcher toque duas ou três delas. Essa amplitude vale pelo pedido esquisito ocasional — a lista de membros de um grupo, um campo de ticket, as comunidades em comum com um contato — que senão te custaria dois aplicativos e uma caixa de busca. Na prática, os grupos de descoberta fazem a maior parte do trabalho, porque quase toda pergunta rápida começa transformando um nome em uma conversa ou em um contato antes de conseguir consultar qualquer coisa.

Contas e workspace

5 ferramentas

Descoberta de identidade e escopo. Toda chamada de mensagem precisa antes de um account_id vindo de list_accounts — um cliente de IA que pula essa etapa vai falar com a conta errada do Telegram.

  • entergram_get_me
  • entergram_list_accounts
  • entergram_get_workspace
  • entergram_get_member
  • entergram_list_members

Conversas e descoberta

8 ferramentas

Para localizar conversas. As visões do workspace trazem o estado do CRM (tickets, comentários, campos personalizados); as visões ao vivo trazem o estado atual de transporte do Telegram e a contagem de não lidas.

  • entergram_list_chats
  • entergram_get_chat
  • entergram_list_live_chats
  • entergram_get_live_chat
  • entergram_list_workspace_chats
  • entergram_get_workspace_chat
  • entergram_update_workspace_chat
  • entergram_get_chat_management

Mensagens

9 ferramentas

Leitura e escrita do histórico de mensagens, incluindo edições, encaminhamentos e reações. O envio é delimitado por conta, então nada vale de forma global entre as suas contas conectadas.

  • entergram_list_messages
  • entergram_get_message
  • entergram_send_message
  • entergram_send_media_message
  • entergram_edit_message
  • entergram_delete_message
  • entergram_forward_messages
  • entergram_get_message_reactions
  • entergram_set_message_reactions

Contatos

3 ferramentas

Com quem você está falando e onde mais vocês se cruzam. A busca por grupos em comum é o que torna respondíveis perguntas como «quais dos meus leads estão na mesma comunidade?».

  • entergram_list_contacts
  • entergram_get_contact
  • entergram_list_contact_shared_groups

Tickets

10 ferramentas

Controle total da central de suporte: abrir, atribuir, priorizar, comentar e fechar. Os tickets apontam de volta para a conversa que os originou, então um cliente de IA vai da conversa para a fila em um único passo.

  • entergram_list_tickets
  • entergram_get_ticket
  • entergram_create_ticket
  • entergram_update_ticket
  • entergram_delete_ticket
  • entergram_list_chat_tickets
  • entergram_list_ticket_comments
  • entergram_create_ticket_comment
  • entergram_update_ticket_comment
  • entergram_delete_ticket_comment

Campos personalizados de CRM

11 ferramentas

O esquema do seu funil. Leia as colunas antes de gravar valores — caixas de seleção aceitam booleanos, campos de múltipla escolha aceitam arrays de valores de opção e datas aceitam strings ISO 8601.

  • entergram_list_custom_columns
  • entergram_get_custom_column
  • entergram_create_custom_column
  • entergram_update_custom_column
  • entergram_delete_custom_column
  • entergram_list_custom_column_options
  • entergram_create_custom_column_option
  • entergram_update_custom_column_option
  • entergram_delete_custom_column_option
  • entergram_get_chat_custom_fields
  • entergram_patch_chat_custom_fields

Campos personalizados de ticket

9 ferramentas

O mesmo controle de esquema do lado dos tickets — categorias, níveis de severidade, faixas de SLA e tudo o mais que a sua central acompanha além de status e prioridade.

  • entergram_list_ticket_custom_columns
  • entergram_get_ticket_custom_column
  • entergram_create_ticket_custom_column
  • entergram_update_ticket_custom_column
  • entergram_delete_ticket_custom_column
  • entergram_list_ticket_custom_column_options
  • entergram_create_ticket_custom_column_option
  • entergram_update_ticket_custom_column_option
  • entergram_delete_ticket_custom_column_option

Notas internas

4 ferramentas

Comentários em uma conversa que o seu cliente nunca vê. Úteis para o cliente de IA deixar o raciocínio registrado e um colega humano continuar de onde ele parou.

  • entergram_list_chat_comments
  • entergram_create_chat_comment
  • entergram_update_chat_comment
  • entergram_delete_chat_comment

Grupos e canais

11 ferramentas

Criar e administrar grupos e canais do Telegram — participantes, permissões, privacidade e informações — além de uma saída de emergência por comando bruto para o resto.

  • entergram_list_groups
  • entergram_get_group
  • entergram_list_group_members
  • entergram_create_group_chat
  • entergram_create_channel
  • entergram_invite_chat_members
  • entergram_remove_chat_member
  • entergram_update_chat_info
  • entergram_update_chat_permissions
  • entergram_update_chat_privacy
  • entergram_run_chat_command

O que um atalho de teclado tem permissão de fazer

Você autoriza uma vez, em uma janela de navegador que o Raycast abre para você, e o token fica naquele Mac. A Entergram nunca repassa seu número de telefone nem as credenciais de sessão do Telegram para o Raycast, e nada disso depende de o app do Telegram estar instalado, aberto ou sequer logado. Um atalho de launcher é, por definição, fácil de disparar sem querer, então o nível de acesso mais estreito é o padrão sensato, a menos que um comando específico precise de mais.

Agente pessoal
É onde quase todo setup de Raycast de uso individual deveria estar. Qualquer membro cria um, e as leituras são generosas — conversas, histórico de mensagens, contatos, tickets e o workspace ao redor — enquanto as únicas escritas são campos personalizados nas suas próprias conversas. Um atalho disparado sem querer consulta alguma coisa e para por aí: não existe caminho até um cliente.
Conector de workspace
Necessário no instante em que você quer os comandos de responder rápido, e ele também libera escrita de campos em qualquer conversa mais administração de grupos. Quem cria são owners e admins. Em um notebook que viaja, pese esse escopo contra a facilidade de apertar o gatilho.
Revogando em um Mac compartilhado
Apagar o servidor da lista do Raycast interrompe o acesso naquela máquina. Se a máquina não está mais com você, revogue o token na Entergram em Settings → Workspace → Connectors → MCP — isso encerra o acesso independentemente do que continue configurado localmente.

O que um launcher não vai fazer por você

O Raycast é deliberadamente raso, e estas são as bordas que você encontra na primeira semana vivendo no atalho.

  • As chamadas de ferramenta MCP exigem um workspace Pro do lado da Entergram. A conexão autoriza em qualquer plano; as respostas só voltam no Pro.
  • O Raycast AI é um nível pago do Raycast. Servidores MCP são movidos pelos recursos de IA do Raycast, então confirme que o seu plano os cobre antes de investigar por que as ferramentas nunca disparam.
  • Só macOS. Não existe cliente Raycast para configurar em Windows ou Linux — a URL do MCP é idêntica em todo lugar, mas você estaria apontando outro aplicativo para ela.
  • Nada consulta em segundo plano. O conector responde quando é chamado e nunca o contrário: sem notificação push, sem selo na barra de menus, sem cutucão quando um cliente escreve durante uma reunião.
  • Perguntas amplas deixam de ser rápidas. Qualquer coisa urgente sobre o workspace inteiro percorre muitas conversas e demora o que isso implica. Cite uma pessoa, um grupo ou uma janela de tempo e a resposta continua ágil.
  • Comandos de envio falham em um agente pessoal. Esses escopos param antes das mensagens de saída, então um atalho de responder pelo launcher depende de um conector de workspace, que fica atrás de direitos de owner ou admin.

Correções do conector no Raycast

As ferramentas da Entergram nunca são usadas
O Raycast só alcança um servidor a que o prompt realmente se refere. Cite o servidor da Entergram na mensagem do AI Chat, ou embuta essa referência no AI Command salvo — senão o modelo responde por conhecimento geral e nunca toca no seu workspace.
Não existe opção de IA em lugar nenhum do Raycast
Servidores MCP funcionam pelos recursos de IA do Raycast, que ficam no nível pago dele. Se AI Chat e AI Commands não estão na sua instalação, isso é uma questão de assinatura do Raycast, não algo para resolver do lado da Entergram.
O servidor sumiu da lista depois de uma atualização
Reabra Manage MCP Servers, adicione a entrada de novo e refaça o login uma vez. Guardar a entrada JSON em algum lugar transforma isso numa correção de dez segundos, e é o mesmo trecho que você colaria ao configurar uma segunda máquina.
O atalho responde, mas devagar
O prompt foi amplo demais. Uma pergunta que nomeia uma conversa, um contato ou um dia resolve em duas ou três chamadas; confira o que está percorrendo o workspace inteiro. Separe a versão ampla em um comando próprio e deixe a rápida na tecla.
As leituras funcionam, mas os envios voltam com erro
Você conectou como agente pessoal, cujos escopos terminam antes das mensagens de saída. O conector de workspace de que um comando de envio depende precisa ser criado por alguém com direitos de owner ou admin — todos os comandos somente leitura continuam funcionando de qualquer forma.
Ele me pede para fazer login de novo
Tokens não duram para sempre. Dispare a conexão em Manage MCP Servers, aprove a tela de consentimento mais uma vez e todos os comandos salvos voltam a funcionar sem que nenhum deles seja editado.

Perguntas frequentes: Raycast + Telegram

Como adiciono um servidor MCP ao Raycast?
Use o comando «Manage MCP Servers» do Raycast, adicione a URL do MCP da Entergram e autorize via OAuth.
Isso é um bot do Telegram?
Não. A Entergram conecta sua conta pessoal real do Telegram por meio de um servidor MCP hospedado.
É seguro?
Sim. OAuth 2.0 com permissões delimitadas por escopo; suas credenciais ficam na Entergram e o acesso pode ser revogado.

Conecte o Telegram ao Raycast