Come collegare Telegram Bot a Microsoft Copilot via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Telegram Bot, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Telegram Bot + Microsoft Copilot

Invia messaggi Telegram, foto, album, documenti, audio, video, animazioni, sticker, contatti, luoghi, posizioni e sondaggi da qualsiasi agente AI tramite la Telegram Bot API. 21 strumenti, autenticazione con il token del bot. Invio in uscita più una lettura leggera degli aggiornamenti recenti (niente long polling).

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

TELEGRAM_BOT_TOKEN

Step 1 — Ottieni le credenziali

1. In Telegram apri una chat con @BotFather, invia /newbot e scegli un nome visualizzato e un username che finisca con bot.
2. BotFather risponde con un token simile a 123456789:ABCdef.... Trattalo come un segreto: chiunque lo abbia può inviare messaggi come il tuo bot.
3. Incolla il token completo in TELEGRAM_BOT_TOKEN e installa il connettore. Telegram vuole il token nell'indirizzo della richiesta, e il connettore lo inserisce lì per te.
4. Inizia con telegram_bot_get_me per verificare che il token funzioni.

Chi può raggiungere il bot: ogni chat ha un chat_id numerico. Un utente deve aver inviato /start al tuo bot almeno una volta, e nei gruppi e nei canali il bot va prima aggiunto. I canali pubblici accettano anche @channelusername; i canali privati richiedono l'id numerico, che inizia con -100. telegram_bot_get_updates mostra i messaggi in arrivo recenti con i relativi chat id.

Cosa invia: messaggi di testo (la formattazione HTML è la scelta più sicura), foto, album, documenti, file audio, messaggi vocali, video, animazioni GIF, sticker, schede contatto, luoghi, posizioni (anche in tempo reale) e sondaggi o quiz. Può anche modificare ed eliminare i propri messaggi e leggere i dettagli di una chat.

Album: telegram_bot_send_album invia da 2 a 10 foto e video come un unico messaggio raggruppato, oppure da 2 a 10 documenti, oppure da 2 a 10 file audio; documenti e audio non si possono mescolare con altri tipi. La didascalia va sul primo elemento. Se Telegram segnala WEBPAGE_CURL_FAILED per un elemento, non è riuscito a scaricare quel file: il link deve essere pubblico e puntare direttamente al file, non a una pagina web.

File: i contenuti multimediali si inviano tramite link HTTPS (fino a 5 MB per le foto e 20 MB per gli altri file) o tramite il file_id di qualcosa inviato in precedenza. Caricare un file dal tuo computer nella stessa chiamata non è supportato.

Già installato? Gli strumenti per album, animazioni, sticker, contatti e luoghi arrivano a un connettore installato in precedenza tramite l'aggiornamento del catalogo: apri il connettore in AnythingMCP e, sotto Catalog update available, controlla l'elenco dei nuovi strumenti e clicca Apply update. Il token del bot e gli strumenti che hai aggiunto tu restano come sono.

Limiti di frequenza: circa 30 messaggi al secondo su chat diverse, 1 al secondo verso la stessa chat e 20 al minuto verso lo stesso gruppo. Con un 429, Telegram indica quanto aspettare.

Il connettore legge gli aggiornamenti recenti quando glielo chiedi e non gestisce un chatbot che risponde da solo, per il quale serve un webhook ospitato da te. Pagamenti, modalità inline, giochi e gestione dei set di sticker non sono coperti.

Step 2 — Installa l'adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Aggiungi il connettore in Microsoft Copilot

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.

1. In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
2. Inserisci un Server name (per esempio AnythingMCP), una Server description che dica cosa fa il connettore e il Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server.
3. Come autenticazione scegli API key, imposta Type su Header e come nome dell'header X-API-Key, poi seleziona Create.
4. In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
5. Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di Telegram Bot.
6. Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.

Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.

Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.

Tool disponibili

Esempi di prompt

• "Invia le foto di questi quattro link come un unico album al canale del team, con la didascalia 'Nuova collezione, online da oggi'."
• "Pubblica un sondaggio nel gruppo vendite: quale giorno va bene per la revisione trimestrale, martedì o giovedì?"
• "Invia l'indirizzo del nostro negozio come luogo nella chat del cliente, così può aprirlo nella sua app di mappe."
• "Mostrami i messaggi che il bot ha ricevuto nell'ultima ora e chi li ha inviati."

FAQ

Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.

Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.

L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Gemini
• Collegare a Meta Muse