Collegare un agente IA con MCP e OAuth

Collegare un agente IA con MCP e OAuth

Il server MCP di Metricgram consente a client IA come Claude, ChatGPT, Cursor o Claude Code di lavorare con i tuoi gruppi Telegram: leggere analisi e membri, pubblicare messaggi, moderare e gestire gli argomenti. Con OAuth non devi copiare nessuna chiave. Incolli un URL, accedi a Metricgram e approvi l'accesso.

Il server MCP è incluso in tutti i piani a pagamento e nella prova gratuita di 14 giorni.

1. Copia l'URL del server

Apri Integrazioni > MCP nel pannello di gestione e copia l'URL nel riquadro Collega con OAuth:

https://metricgram.com/api/v1/mcp

2. Aggiungilo al tuo client IA

• Claude: vai in Settings > Connectors > Add custom connector (Impostazioni > Connettori > Aggiungi connettore personalizzato), incolla l'URL e salva.
• Claude Code: esegui claude mcp add --transport http metricgram https://metricgram.com/api/v1/mcp, poi digita /mcp per accedere.
• ChatGPT, Cursor e altri client: aggiungi un nuovo server MCP (alcuni client lo chiamano connettore) con lo stesso URL e scegli OAuth se il client chiede un metodo di autenticazione.

3. Accedi e approva l'accesso

Il tuo client apre una pagina di Metricgram nel browser. Accedi se necessario, controlla il nome dell'app e i suoi permessi, quindi fai clic su Consenti. Verrai riportato al tuo client e la connessione sarà pronta.

La pagina mostra:

• L'app che chiede l'accesso e l'indirizzo a cui verrai riportato.
• Cosa potrà fare l'app: Lettura dei tuoi gruppi, membri, messaggi, analisi e impostazioni, e Scrittura, cioè agire nei tuoi gruppi pubblicando, moderando o modificando le impostazioni.
• Un avviso quando Metricgram non ha verificato l'app. Continua solo se hai avviato tu la connessione.

4. Provalo

Chiedi al tuo agente qualcosa come "Riassumi l'attività di questa settimana nel mio gruppo" o "Quali membri non hanno scritto negli ultimi 30 giorni?".

Gestire le app collegate

Ogni app che approvi compare in App collegate nella pagina MCP, con i suoi permessi e la data in cui l'hai collegata. Fai clic su Scollega per revocarne subito l'accesso.

OAuth o chiave API?

Usa OAuth ogni volta che il tuo client lo supporta: non c'è nessun segreto da conservare e puoi scollegare l'app in qualsiasi momento. Per i client che non supportano OAuth, crea una chiave API in Integrazioni > API e usa gli esempi di configurazione nella pagina MCP. L'articolo Accesso API & MCP spiega come funzionano le chiavi e i relativi permessi.

Risoluzione dei problemi

• "Il tuo account deve avere un piano Metricgram attivo per collegare agenti IA tramite MCP.": MCP richiede un piano attivo o la prova gratuita.
• "Questa richiesta di connessione non è valida": la richiesta è scaduta o è stata modificata. Avvia di nuovo la connessione dal tuo client IA.
• L'agente non vede un gruppo: l'accesso è limitato ai gruppi Telegram che gestisci in Metricgram. Verifica che il gruppo sia collegato e che il bot sia ancora amministratore.
• L'agente non può pubblicare né moderare: la connessione ha solo accesso in lettura. Scollegala e collegala di nuovo da un client che richieda l'accesso in scrittura.