opencode Telegram MCP - dai la tua inbox al tuo agente da terminale

Globale: ~/.config/opencode/opencode.json

Una sola voce che ti segue in ogni repository che apri. È il posto giusto per un'autorizzazione personale: il server è disponibile sia in un progetto di lavoro sia in uno del fine settimana, e autorizzi una volta sola invece che per ogni checkout.

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

Per progetto: opencode.json nella radice del repository

Salvato insieme al codice, così chiunque cloni il repository trova il server già dichiarato senza che nessuno glielo dica. Non si condivide nulla di segreto: il file indica un endpoint e nient'altro, e ogni collega completa comunque il proprio login con i propri permessi. La configurazione di progetto si sovrappone al file globale, quindi tieni una sola definizione invece di due in conflitto.

Senza interfaccia: opencode run

Il motivo per cui questo connettore si adatta a un agente da terminale. Una singola invocazione non interattiva entra in uno script di deploy, in un target di Makefile o in un passaggio di CI, ed è così che una notifica di rilascio smette di dipendere da qualcuno che si ricordi di inviarla.

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

Mostra tutti i 78 strumenti in 9 gruppi →

• La prima autorizzazione richiede un browser. Un'invocazione da script non può completare una schermata di consenso, quindi autorizza una volta in una sessione interattiva e lascia che l'autorizzazione salvata copra le esecuzioni successive.
• Un opencode.json salvato nel repository condivide l'indirizzo, non l'accesso. I colleghi che scaricano il repository fanno ciascuno il proprio login, e il loro token porta i loro permessi, non i tuoi.
• Dal nostro lato non c'è uno scheduler. opencode termina quando finisce l'esecuzione, quindi tutto ciò che è ricorrente (un riepilogo notturno, un avviso dopo il deploy) è una tua voce cron o un passaggio della tua pipeline, mai qualcosa che Entergram avvia da solo.
• L'MCP fa parte del piano Pro. Con qualsiasi piano inferiore il server risponde comunque alla connessione, così il problema sembra un errore di configurazione quando in realtà è di fatturazione.
• Le scritture richiedono che la colonna esista già. L'agente può compilare un campo di monitoraggio dei rilasci su una chat, ma creare quel campo è un'azione da connettore workspace e un'autorizzazione personale non lo farà.
• Indicare l'account è obbligatorio. Le abitudini da terminale si aspettano un valore predefinito sensato e qui non c'è, quindi nomina l'account nel prompt oppure l'agente lo ricaverà da solo dall'elenco degli account.

opencode si avvia ma non elenca alcuno strumento Entergram

Verifica che la voce sia sotto il blocco mcp con type impostato su remote ed enabled impostato su true: una voce a cui manca uno dei due viene letta e ignorata senza avvisi. La configurazione si legge all'avvio, quindi riavvia la sessione dopo averla modificata.

opencode non si avvia dopo la modifica

Mantieni la riga $schema e passa il file in un parser JSON. La causa più comune è una virgola finale, e l'errore all'avvio tende a indicare il file invece della riga responsabile.

Un'esecuzione da script si blocca all'autorizzazione

Le esecuzioni non interattive non possono aprire una schermata di consenso. Avvia opencode in modo interattivo una volta, completa il login a Entergram e da quel momento l'autorizzazione salvata coprirà le esecuzioni da script.

È attiva la configurazione sbagliata

Un opencode.json di progetto si sovrappone al file globale in ~/.config/opencode/. Se un collega ha salvato una voce nel repository, è quella in uso: riconcilia le due invece di aggiungere un secondo server con un altro nome.

I messaggi finiscono nel posto sbagliato

Nomina nel prompt sia l'account sia la chat di destinazione. entergram_list_accounts risolve il primo, ma nulla in una sessione da terminale implica un valore predefinito, e un'esecuzione singola non si fermerà a chiedertelo.

Le chiamate hanno iniziato a fallire dopo qualche giorno

I token scadono. Esegui opencode in modo interattivo e approva di nuovo l'accesso: il file di configurazione non cambia, cambia solo l'autorizzazione dietro di esso.