Cursor Telegram MCP - Telegram in Cursor, Zed e Windsurf

Cursor: ~/.cursor/mcp.json

Cursor carica i server da ~/.cursor/mcp.json per ogni progetto che apri, oppure da .cursor/mcp.json salvato dentro un repo quando vuoi il server disponibile solo per quel codice. Il percorso da menu è Cursor Settings → MCP & Integrations → New MCP server, che scrive lo stesso file per te. Una voce a livello di progetto chiede la fiducia la prima volta che l'agente la usa, quindi un collega che scarica il repo fa comunque una scelta consapevole.

{
  "mcpServers": {
    "entergram": {
      "url": "https://mcp.entergram.com/mcp"
    }
  }
}

Zed: ~/.config/zed/settings.json

Zed tiene i server MCP in un blocco context_servers nel suo file di impostazioni principale, non in un blocco mcpServers, e quella parola fa fallire quasi tutti i primi tentativi: incolla lo snippet di Cursor così com'è e non si carica nulla, senza alcun errore che spieghi il perché. La schermata delle impostazioni dell'Agent Panel ha un pulsante Add Custom Server che scrive la forma corretta, se preferisci non modificare il JSON a mano.

{
  "context_servers": {
    "entergram": {
      "source": "custom",
      "url": "https://mcp.entergram.com/mcp"
    }
  }
}

Windsurf: ~/.codeium/windsurf/mcp_config.json

Windsurf legge un file dedicato sotto ~/.codeium e non le impostazioni dell'editor che ti aspetteresti, e Cascade lo rilegge su richiesta: dopo aver salvato, apri il pannello MCP in Cascade e premi aggiorna, altrimenti gli strumenti restano invisibili fino al riavvio successivo. La struttura JSON è la stessa di Cursor, quindi la voce si porta dall'uno all'altro.

{
  "mcpServers": {
    "entergram": {
      "url": "https://mcp.entergram.com/mcp"
    }
  }
}

Mostra tutti i 78 strumenti in 9 gruppi →

• L'accesso MCP è incluso nel piano Pro, e nulla lato editor lo cambia: un workspace con un piano inferiore può registrare il server, completare il login e non ottenere comunque nulla di utile da una chiamata.
• Nulla arriva da solo. L'editor interroga Entergram solo dentro un turno avviato da te, quindi un messaggio che arriva mentre sei a metà di un refactoring aspetta in silenzio finché non chiedi di nuovo.
• La configurazione è per singola macchina. mcp.json non segue il tuo account dell'editor, e nemmeno l'autorizzazione OAuth: un secondo portatile significa un secondo file e una seconda schermata di consenso.
• L'output degli strumenti resta nella conversazione. L'agente può citare il log di un cliente in un commento o in una fixture, ma scrive nei tuoi file solo quando glielo chiedi, e mai nella direzione opposta.
• Ogni invio indica un solo account. account_id è un argomento obbligatorio e non un valore predefinito, quindi un agente che sbaglia ramo non può anche improvvisare un messaggio a tutta la tua rubrica.
• Il connettore vede esattamente ciò che vede il tuo account Telegram. Un gruppo in cui non sei mai stato aggiunto resta invisibile anche dall'editor, comunque tu formuli il prompt.

Il server mostra un pallino rosso nel pannello MCP di Cursor

Cursor mette in cache l'elenco degli strumenti dall'ultimo handshake riuscito. Disattiva e riattiva il server in Cursor Settings → MCP & Integrations e, se il pallino resta rosso, ricarica la finestra: l'agente legge l'elenco all'avvio della finestra, non quando modifichi il file.

Zed ignora completamente la voce

Quasi certamente hai scritto mcpServers. La chiave di Zed è context_servers, e una chiave di primo livello non riconosciuta viene scartata in silenzio invece di essere segnalata come errore. Correggi il nome della chiave, salva e riavvia Zed.

Windsurf non mostra strumenti Entergram dopo il salvataggio

Verifica di aver modificato ~/.codeium/windsurf/mcp_config.json e non l'interfaccia delle impostazioni, poi apri il pannello MCP in Cascade e aggiornalo. Windsurf rilegge quel file quando glielo chiedi, non prima.

La schermata di consenso si apre ma l'editor resta scollegato

L'autorizzazione si completa nel browser che il sistema operativo apre per impostazione predefinita. Completa lì il login, con l'accesso a Entergram attivo nello stesso profilo, poi torna nell'editor e avvia ancora una volta la connessione.

L'agente risponde su Telegram senza chiamare nulla

Ci sono troppi server registrati e l'elenco degli strumenti viene tagliato prima che il modello lo veda. Disattiva i server MCP che non usi per questa attività e nomina Entergram nel prompt, così la scelta non è ambigua.

Le chiamate restituiscono 403

Controlla due cose, in ordine. Il tuo ruolo: un connettore del workspace richiede proprietario o amministratore, e un agente personale copre tutti gli altri. Poi il piano: l'accesso MCP è incluso in Pro, e un livello inferiore fallisce qui e non al momento della connessione.