Como conectar o Goose ao Telegram via MCP

O Goose é o agente de IA open-source da Block — um assistente local e extensível que vai muito além de sugestões de código. Onde a maioria dos assistentes responde perguntas, o Goose planeja e executa trabalho de várias etapas na sua máquina: ele lê o contexto, decide o que fazer, executa as ferramentas de que precisa, verifica o resultado e segue em frente até concluir a tarefa. Toda a sua arquitetura é construída em torno de extensões, e as extensões são alimentadas pelo Model Context Protocol (MCP). Isso faz do Goose um par natural para o servidor MCP do Telegram da Entergram, que conecta a sua conta pessoal do Telegram — e não um bot — ao agente, para que essas execuções autônomas incluam operações reais de CRM do Telegram.

Este guia faz parte do nosso hub conecte qualquer ferramenta de IA ao Telegram MCP, e a página dedicada Goose Telegram MCP percorre o conector com capturas de tela. Se você prefere ver o panorama geral primeiro, 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 o Goose usa para carregar capacidades externas em uma execução do agente. Em vez de escrever uma integração personalizada para cada serviço, você aponta o agente para um único endpoint MCP e ele descobre as ferramentas disponíveis automaticamente. A Entergram publica as suas ações do Telegram em um único endpoint hospedado, https://mcp.entergram.com/mcp. Assim que o Goose se conecta, ele pode:

• Listar e ler conversas — conversas privadas, grupos e canais das suas contas conectadas.
• Consultar contatos e campos personalizados — estágio, responsável, ARR, tags e qualquer dado estruturado que você mantenha em uma conversa.
• Criar e atualizar tickets — com status, prioridade e responsável.
• Enviar mensagens e transmissões — respostas, follow-ups ou uma transmissão personalizada a partir de um modelo salvo.

O ponto crucial: esta é a sua conta real do Telegram, exposta através de uma camada de CRM com permissões — e não a limitada Bot API. O Goose vê as mesmas conversas que você, governadas pelos escopos que você concede.

O Goose foi criado para trabalho encadeado e autônomo, e é exatamente aí que uma conexão com o Telegram compensa. Uma única instrução pode conduzir uma sequência inteira de etapas de CRM sem que você toque em uma interface gráfica:

• Ler tudo o que chegou durante a noite, classificar e priorizar os itens urgentes.
• Cruzar cada remetente com o seu estágio no CRM antes de decidir como responder.
• Abrir tickets, atualizar campos e publicar um resumo — tudo em uma única execução.

Como o Goose roda localmente e mantém a sua própria sessão, ele pode fazer isso repetidamente e em um cronograma. O servidor MCP do Telegram simplesmente se torna mais uma extensão que ele aciona, da mesma forma que aciona um sistema de arquivos ou um shell. Você descreve o resultado; o Goose descobre quais ferramentas do Telegram chamar e em que ordem.

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 Goose age de forma autônoma e em sequências, muitas equipes o iniciam somente leitura (chats.read, contacts.read, custom_fields.read) e adicionam escopos de escrita como chats.write ou permissões de ticket apenas quando passam a confiar em um determinado fluxo. O menor privilégio limita o raio de impacto se algo der errado.

A URL do seu servidor MCP é:

https://mcp.entergram.com/mcp

O Goose armazena as suas extensões em ~/.config/goose/config.yaml, e você pode adicionar uma de forma interativa com goose configure. Escolha Add Extension → Remote Extension, dê um nome como entergram-telegram e cole o endpoint acima. Forneça as credenciais do cliente OAuth que você acabou de criar para que o Goose possa se autenticar. A página Goose Telegram MCP tem o bloco de configuração exato, incluindo os headers que o Goose espera. No próximo início, o Goose carrega as ferramentas da Entergram e as lista ao lado das suas extensões nativas.

Se você prefere editar o arquivo de configuração diretamente, adicione a entrada da Entergram sob a chave extensions, com o tipo definido como um servidor MCP remoto e a URL apontando para https://mcp.entergram.com/mcp. Qualquer um dos caminhos produz o mesmo resultado.

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

A partir daí, as ferramentas do Telegram ficam disponíveis para o Goose em todas as sessões, e você pode revogá-las instantaneamente em Settings → Developer.

O Goose dá o seu melhor quando um único prompt se desdobra em uma sequência de ações reais. Alguns exemplos realistas:

• "Leia todas as conversas marcadas como support nas últimas 24 horas, classifique cada uma por urgência, abra tickets para as urgentes e escreva um resumo para mim." O Goose lê as conversas, chama a ferramenta de ticket para cada caso urgente e reporta de volta — um prompt, muitas etapas.
• "Encontre todo contato que mencionou 'invoice' esta semana, defina o campo de prioridade como alta e rascunhe uma resposta para cada um." O agente busca, atualiza campos personalizados e prepara respostas sem que você abra o aplicativo.
• "Reúna as estatísticas de tempo de resposta desta semana e anexe-as ao meu relatório semanal." O Goose lê as analytics e as escreve onde você guarda as suas anotações.
• "Verifique quais leads no estágio Demo não responderam em três dias e me lembre com uma lista." Um daily standup para o seu pipeline do Telegram, gerado sob demanda.

Cada um desses é uma cadeia de chamadas de ferramentas MCP contra o seu workspace. Você não está escrevendo um script das etapas; está declarando o objetivo e deixando o Goose orquestrar as operações do Telegram na ordem certa.

Dar a um agente autônomo acesso à sua conta real do Telegram merece cuidado, e o conector foi construído exatamente para isso. O acesso é governado por escopos OAuth, então você decide com precisão o que o Goose pode ler e escrever. Comece somente leitura, comprove um fluxo e então conceda os escopos de escrita mínimos de que ele precisa — nada além disso. Há um cliente OAuth por usuário, e você pode revogá-lo instantaneamente em Settings → Developer, o que corta imediatamente todas as sessões do Goose que o utilizam.

A Entergram retransmite a sua sessão do Telegram no lado do servidor e armazena as credenciais criptografadas; o agente 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 que um agente executa é registrada no log de atividade do workspace com um autor e um carimbo de data e hora, de modo que uma execução autônoma é sempre auditável depois do fato. Para as equipes, é justamente essa trilha de auditoria que torna aceitável, em primeiro lugar, deixar um agente agir — em vez de apenas aconselhar.

Como o Goose roda a partir da linha de comando, os mesmos fluxos do Telegram que você dispara manualmente podem rodar sem supervisão. Envolva um prompt em uma invocação goose run e agende-o com cron, um job do launchd ou o seu runner de CI, e você tem um agente recorrente: uma triagem às 7h que abre tickets para qualquer coisa urgente que chegou durante a noite, uma varredura no fim do dia que sinaliza leads que ficaram em silêncio, ou uma verificação horária que só te avisa quando um contato VIP envia uma mensagem. A conexão MCP se comporta de forma idêntica, quer um humano quer um agendador tenha iniciado a execução, e os escopos OAuth que você concedeu continuam valendo, então um Goose agendado lê e age exatamente dentro dos mesmos limites. Mantenha as execuções agendadas somente leitura até ter observado algumas rodarem sem problemas, e então amplie os escopos quando o comportamento for previsível. É aqui que o design autônomo justifica o seu valor — o agente faz a vigilância para que você não precise.

Se o seu plano da Entergram inclui acesso à API, o conector MCP está pronto para usar. Crie a sua conexão agora, siga o passo a passo completo na página Goose Telegram MCP, ou explore todos os clientes suportados no hub conecte qualquer IA. Para os detalhes de configuração subjacentes, o guia passo a passo do MCP cobre clientes OAuth, escopos e solução de problemas. O Goose traz a autonomia; a Entergram traz o seu CRM real do Telegram — juntos, eles transformam uma fila de conversas não lidas em trabalho que é concluído enquanto você se concentra em outras coisas.