Accesso API & MCP

Accesso API & MCP

Metricgram include un'API pubblica e un server MCP per collegare strumenti, dashboard, automazioni o client AI ai dati e alle operazioni disponibili nel tuo account.

Il server MCP è disponibile in tutti i piani a pagamento e durante la prova gratuita di 14 giorni. I client IA possono collegarsi con OAuth (incollando l'URL del server e approvando l'accesso) o con una chiave API. L'API REST richiede l'accesso Elite. Se il tuo account non la include, la sezione API può apparire bloccata o mostrare un messaggio di upgrade.

Dove trovarlo

Apri Integrazioni > MCP o Integrazioni > API nel pannello di gestione. Da lì, gli account con accesso possono creare token API, controllare i token attivi, revocarli e vedere il riferimento tecnico disponibile per il proprio piano.

Come funzionano i token

• I token appartengono al tuo account utente Metricgram, non a un singolo gruppo.
• Un token può accedere ai gruppi e alle risorse che il tuo account può gestire.
• I token includono permessi per aree come gruppi, membri, messaggi, automazioni, abbonati, analisi, ticket di supporto, referral e MCP.
• Alcuni endpoint leggono solo dati; altri possono creare, aggiornare, moderare o avviare azioni in base ai permessi del token.
• Il valore del token viene mostrato una sola volta al momento della creazione. Conservalo in modo sicuro.

Telegram Bot API tramite MCP

Il server MCP espone anche una Telegram Bot API limitata ai tuoi gruppi, così gli agenti IA possono agire al loro interno tramite il bot di Metricgram o il tuo bot personalizzato.

• Usa telegram_api_methods per elencare i metodi che il tuo token può chiamare e telegram_bot_api per chiamarne uno qualsiasi con i parametri ufficiali della Bot API.
• Gli strumenti tipizzati coprono il lavoro quotidiano: send_telegram_message, send_telegram_media, send_telegram_poll, pin_telegram_message, manage_forum_topic, create_telegram_invite_link e altri.
• La chat è sempre uno dei tuoi gruppi. Non passi mai un chat_id; Metricgram lo ricava dal group_id.
• Le azioni Telegram usano permessi dedicati: telegram:read, telegram:write, telegram:moderate e telegram:admin. I token creati prima dell'introduzione di questi permessi devono essere ricreati per poterli usare.
• I media devono essere un URL HTTPS pubblico o un file_id di Telegram, e i pulsanti inline possono solo aprire URL o copiare testo.
• Gli strumenti di scrittura accettano una idempotency_key opzionale, così una chiamata ripetuta non agisce due volte.

Autenticazione e limiti

Le richieste API usano l'header Authorization: Bearer mg_.... Il limite predefinito è 600 richieste al minuto per token, e il modulo consente di scegliere un valore entro il minimo e massimo consentiti dall'app.

Se un token viene revocato, se l'account perde l'accesso API o se il piano non include più API & MCP, le richieste con quel token saranno rifiutate.

Buone pratiche

• Crea token separati per ogni strumento esterno.
• Usa nomi chiari per identificare dove viene usato ogni token.
• Revoca i token che non ti servono più.
• Non condividere token in chat, screenshot, ticket o repository pubblici.