opencode · SST

Conecte o Telegram ao opencode

Adicione a Entergram como servidor MCP no opencode, o agente de IA de terminal open-source da SST, e deixe-o trabalhar com sua conta real do Telegram — revele mensagens perdidas, retome leads que esfriaram e atue sobre conversas sem sair da linha de comando.

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

Começar grátis Ver todos os conectores

O opencode carrega servidores MCP a partir do seu arquivo de configuração. Registre o da Entergram como servidor MCP remoto e o agente open-source da SST passa a trabalhar com sua conta pessoal real do Telegram no terminal — delimitado por OAuth, sem conta de bot e sem chaves de API.

Configuração pronta para colar

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "entergram": {
      "type": "remote",
      "url": "https://mcp.entergram.com/mcp",
      "enabled": true
    }
  }
}

Pergunte ao opencode o que o Telegram nunca responderia

Com sua conta pessoal conectada, o opencode atua em todas as conversas a partir do terminal. Experimente comandos como:

«Abra um canal de incidente e chame quem está de plantão.»
«Publique o resumo do deploy no canal de novidades para clientes.»
«Quantos tickets ainda estão abertos antes de eu fechar a release?»
«Encontre conversas que mencionam a migração e resuma as preocupações.»
«Adicione uma nota naquela conversa com o plano de rollback.»
«Quem no grupo beta ainda não respondeu ao aviso de atualização?»

Conecte o opencode em 3 passos

Funciona com a TUI e a CLI do opencode.

01
Copie sua URL do MCP na Entergram
Na Entergram, abra Settings → Workspace → Connectors → MCP e copie a URL do seu servidor MCP. O opencode lê essa URL do opencode.json, então ela vai para um arquivo e não para um prompt.
02
Adicione o servidor no opencode.json
No seu opencode.json, adicione a Entergram em "mcp" como servidor remoto apontando para a URL do MCP: https://mcp.entergram.com/mcp.
03
Autorize e execute
Inicie o opencode, faça login com sua conta da Entergram e clique em Allow access para conceder acesso delimitado. O opencode já pode ler e atuar sobre sua conta do Telegram nas sessões dele.

Global, por projeto ou headless

Global — ~/.config/opencode/opencode.json

Uma entrada que te acompanha em todo repositório que você abre. É o lugar certo para uma concessão pessoal: o servidor fica disponível esteja você em um projeto de trabalho ou em um de fim de semana, e você autoriza uma única vez em vez de uma vez por checkout.

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "entergram": {
      "type": "remote",
      "url": "https://mcp.entergram.com/mcp",
      "enabled": true
    }
  }
}

Por projeto — opencode.json na raiz do repositório

Commitado junto com o código, então quem clonar o repositório recebe o servidor já declarado sem precisar ser avisado. Nada de secreto está sendo compartilhado — o arquivo nomeia um endpoint e nada mais, e cada colega ainda faz o próprio login com as próprias permissões. A configuração de projeto se sobrepõe à global, então mantenha uma definição em vez de duas concorrentes.

Headless — opencode run

A razão pela qual este conector combina com um agente de terminal, para começo de conversa. Uma única invocação não interativa cabe em um script de deploy, em um alvo de Makefile ou em um passo de CI, que é como um aviso de release deixa de depender de alguém lembrar de mandá-lo.

opencode run "post the release summary for v2.14 in the customer channel"

Colocando no ar, do mesmo shell

Um agente de terminal é usado nos momentos em que abrir um app de chat quebraria a concentração: logo depois de um deploy, no meio de um incidente ou no fim do dia, quando você quer saber o que ainda está aberto. Estas execuções assumem esse contexto — prompts curtos, só teclado, e o conector fazendo a parte que você senão adiaria até deixar de importar. Cada uma mapeia para um punhado de chamadas nomeadas que aparecem no log da sessão, o que também as torna seguras de levar direto para um script depois que você as viu funcionar à mão.

Você pergunta

«O deploy terminou. Publique a versão e o link do changelog no canal de release.»

Ferramentas chamadas

entergram_list_accountsentergram_list_groupsentergram_send_message

Você recebe

O anúncio sai do mesmo shell que rodou o deploy, segundos depois de ele dar certo em vez de uma hora depois. O agente resolve qual conta conectada pode publicar, encontra o canal pelo nome para que o id nunca precise morar no seu script, e envia. Ligue isso ao alvo de deploy e o passo deixa de ser opcional.

Você pergunta

«Coloquei o número de build errado naquele anúncio — corrija no lugar.»

Ferramentas chamadas

entergram_list_messagesentergram_get_messageentergram_edit_message

Você recebe

Corrigir o original é melhor do que publicar uma errata embaixo. O agente volta pelo histórico recente para identificar a mensagem, confirma o conteúdo antes de tocar nela e edita, de modo que quem passar por ali amanhã lê o número certo em vez de uma sequência de emendas.

Você pergunta

«Abra uma sala de incidente para isso e chame quem está de plantão.»

Ferramentas chamadas

entergram_create_group_chatentergram_list_membersentergram_invite_chat_members

Você recebe

Trinta segundos de preparação que ninguém quer fazer com um sistema fora do ar. O grupo é criado, a lista do workspace é lida para resolver as pessoas que você nomeou e os convites saem. Você volta para os logs com a coordenação já resolvida, e não pela metade.

Você pergunta

«Encaminhe o aviso de manutenção de sexta para todo grupo de cliente que ainda não viu.»

Ferramentas chamadas

entergram_list_groupsentergram_list_messagesentergram_forward_messages

Você recebe

Encaminhar o original mantém todos os grupos lendo exatamente as mesmas palavras, que é o que você quer para uma janela de manutenção e exatamente o que redigitar destrói. O agente confere quais grupos já receberam antes de distribuir, então ninguém recebe o mesmo aviso duas vezes.

Você pergunta

«Quem reportou isso está em algumas das nossas comunidades — quais, e quem mais da nossa lista está nelas?»

Ferramentas chamadas

entergram_list_contactsentergram_get_contactentergram_list_contact_shared_groups

Você recebe

A busca por grupos em comum responde uma pergunta que o próprio Telegram não responde: onde a sua sobreposição com alguém realmente está. Útil quando um relato de bug precisa de contexto sobre o alcance de quem reportou, e útil de novo quando você decide se uma solução de contorno pode ser publicada uma vez em uma comunidade compartilhada em vez de repetida à mão em dez conversas privadas.

Você pergunta

«Antes de eu fechar a release, quantos tickets abertos estão marcados para este marco?»

Ferramentas chamadas

entergram_list_ticket_custom_columnsentergram_list_ticketsentergram_get_ticket

Você recebe

Uma verificação de prontidão de release que cabe em uma linha e não precisa de dashboard. O agente lê o schema de tickets para achar a coluna de marco, filtra os tickets abertos por ela e informa a contagem com os títulos. Coloque isso como primeiro passo do seu script de release e um ticket bloqueador impede a tag em vez de aparecer depois dela.

O que o opencode pode fazer com seu Telegram

—Comandar o Telegram inteiramente pelo teclado
—Anunciar um deploy no canal de clientes logo após subir
—Abrir um canal de incidente e convidar quem responde
—Contar tickets abertos antes de fechar uma release
—Configurar global ou por projeto via opencode.json
—Rodar de forma não interativa em tarefas automatizadas

Setenta ferramentas, nada instalado localmente

A Entergram hospeda o servidor, então o opencode recebe nove grupos de ferramentas sem uma única dependência adicionada à sua máquina ou à sua imagem de CI — sem processo de ponte, sem ambiente Python, sem credenciais no repositório. Tudo abaixo fica alcançável no momento em que a concessão existe, dentro do nível de acesso que você escolheu, e a mesma lista está disponível tanto para uma sessão interativa quanto para uma execução única.

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

Segurança do lado do terminal em um parágrafo

Nada sensível vai parar nos seus dotfiles. O opencode.json carrega uma URL e uma flag; a credencial em si fica no armazenamento de autenticação do próprio opencode depois de um login no navegador, e a sua sessão do Telegram continua dentro da Entergram, onde nem a SST nem o provedor de modelo a enxergam. Se uma máquina sumir ou um runner de CI for desativado, mate a concessão na Entergram em Settings → Workspace → Connectors → MCP e toda sessão naquela máquina perde acesso na chamada seguinte.

Agente pessoal: O padrão para o terminal de uma pessoa, e disponível a todo membro sem passo de aprovação. A leitura cobre o registro do workspace, suas contas conectadas, contatos, conversas, histórico de mensagens e a fila de tickets; a escrita se limita aos campos personalizados das conversas que pertencem às suas próprias contas. Isso basta para triagem, resumos e checagens de prontidão de release, e fica deliberadamente aquém de qualquer coisa que fale com um cliente.
Conector de workspace: Criado por um owner ou admin, e carrega todo escopo que o servidor define: envio, edição, encaminhamento, escrita em tickets, escrita de campos personalizados em qualquer lugar do workspace e administração de grupos. É o nível de que um script de deploy precisa se for publicar em um canal de clientes sem uma pessoa no laço.
Revogação: Imediata, e deliberadamente unilateral. Você não precisa de acesso à máquina que roda o opencode para cortar o acesso — revogar na Entergram invalida a concessão onde quer que ela esteja guardada, que é justamente o ponto quando o runner é uma máquina de CI e não um notebook na sua mesa.

Restrições de um conector nativo de terminal

A maior parte delas é sobre a distância entre uma sessão interativa e uma automatizada, que é justamente a distância que um agente de terminal passa a vida atravessando. Nenhuma é impeditiva; todas custam menos de aprender aqui do que dentro de um pipeline.

A primeira autorização precisa de um navegador. Uma invocação em script não consegue concluir uma tela de consentimento, então autorize uma vez em sessão interativa e deixe a concessão guardada sustentar as execuções seguintes.
Um opencode.json commitado compartilha o endereço, não o acesso. Colegas que clonarem o repositório fazem cada um o próprio login, e o token deles carrega as permissões deles, não as suas.
Não existe agendador do nosso lado. O opencode encerra quando a execução termina, então qualquer coisa recorrente — um resumo noturno, um aviso pós-deploy — é uma entrada no seu cron ou um passo do seu pipeline, nunca algo que a Entergram dispare sozinha.
MCP faz parte do plano Pro. Em qualquer plano abaixo, o servidor ainda responde ao handshake, o que faz a falha parecer um bug de configuração quando na verdade é uma questão de plano.
As escritas exigem que a coluna já exista. O agente consegue preencher um campo de acompanhamento de release em uma conversa, mas criar esse campo é uma ação de conector de workspace, e uma concessão pessoal não faz isso.
Endereçar por conta é obrigatório. Hábitos de terminal esperam um padrão sensato e aqui não existe um, então cite a conta no prompt ou o agente vai resolvê-la a partir da lista de contas.

Resolvendo problemas do conector no opencode

O opencode inicia, mas não lista nenhuma ferramenta da Entergram

Confira se a entrada está dentro do bloco mcp com type definido como remote e enabled como true — uma entrada sem um dos dois é interpretada e descartada sem comentário. A configuração é lida na inicialização, então reinicie a sessão depois de editar.

O opencode se recusa a iniciar depois da edição

Mantenha a linha do $schema e passe o arquivo por um parser de JSON. Uma vírgula sobrando é a causa de sempre, e o erro de inicialização costuma nomear o arquivo em vez da linha problemática.

Uma execução em script trava na autorização

Execuções não interativas não conseguem abrir uma tela de consentimento. Inicie o opencode de forma interativa uma vez, complete o login na Entergram, e a concessão guardada sustenta as execuções em script daí em diante.

A configuração em vigor é a errada

Um opencode.json de projeto se sobrepõe ao arquivo global em ~/.config/opencode/. Se um colega commitou uma entrada, é a dele que está valendo — reconcilie as duas em vez de adicionar um segundo servidor com outro nome.

As mensagens chegam no lugar errado

Cite no prompt tanto a conta quanto a conversa de destino. O entergram_list_accounts resolve a primeira, mas nada em uma sessão de terminal sugere um padrão, e uma execução única não vai parar para te perguntar.

As chamadas começaram a falhar depois de alguns dias

Tokens expiram. Rode o opencode de forma interativa e aprove o acesso de novo — o arquivo de configuração não muda, só a concessão que está por trás dele.

Perguntas frequentes: opencode + Telegram

Como o opencode se conecta a servidores MCP?

O opencode lê os servidores MCP do arquivo de configuração dele. Adicione a Entergram como servidor remoto com a URL do MCP e autorize via OAuth.

Isso é um bot do Telegram?

Não. Não existe token de bot nenhum nessa configuração — o servidor MCP hospedado age como a sua própria conta do Telegram, e é por isso que ele consegue ler um histórico que um bot jamais leria.

É seguro?

Sim. OAuth 2.0 com permissões delimitadas por escopo; você decide o que o opencode pode acessar e pode revogar a qualquer momento.

O opencode consegue executar ações de várias etapas no Telegram?

Sim. Como agente autônomo de terminal, o opencode encadeia passos em uma única execução — ler conversas sem resposta, escrever respostas e abrir tickets — parando para a sua aprovação antes de qualquer envio.

Outros conectores

A Entergram funciona com qualquer ferramenta de IA compatível com MCP.

Conecte o Telegram ao Claude Anthropic Conecte o Telegram ao ChatGPT OpenAI Conecte o Telegram ao Gemini Google Conecte o Telegram ao n8n n8n.io Conecte o Telegram ao Make.com Celonis Conecte o Telegram ao Cursor e IDEs Cursor, Zed, Windsurf Conecte o Telegram ao Perplexity Perplexity AI Conecte o Telegram ao Goose Block Conecte o Telegram ao Raycast Raycast Conecte o Telegram ao Cline Cline (VS Code)