In breve
Fai lavorare la tua IA come un bot in VK Teams (VK WorkSpace), nel cloud o on-premise: leggi i messaggi e gli eventi in arrivo, invia e modifica messaggi, invia file, rispondi a pressioni di pulsanti e cerca e gestisci gruppi e canali. Token del bot.
Configurazione guidata
Collega VK Teams a Microsoft Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega VK Teams con la configurazione guidata e aggiungi il tuo URL MCP a Microsoft Copilot. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
Prova a chiedere
Prompt di esempio per VK Teams
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connectors → VK Teams, inserisci l'indirizzo dell'API del bot e il token del bot di Metabot, crea una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
VK Teams + Microsoft Copilot
Fai lavorare la tua IA come un bot in VK Teams (VK WorkSpace), nel cloud o on-premise: leggi i messaggi e gli eventi in arrivo, invia e modifica messaggi, invia file, rispondi a pressioni di pulsanti e cerca e gestisci gruppi e canali. Token del bot.
Prerequisiti
Consulta le istruzioni complete di configurazione integrate nel connettore (visibili nello store dell'app quando selezioni il connettore). Le variabili ambientali richieste per questo connettore sono:
VK_TEAMS_API_URL, VK_TEAMS_BOT_TOKEN
Passo 1 — Ottieni le credenziali
La configurazione richiede circa 3 minuti.
- In VK Teams apri una chat con Metabot (cerca
@metabot) e invia/newbot. Scegli un nome e un soprannome che finisca conbot. Metabot risponde con il token del bot, che appare come001.2659914704.0218887601:747432131. - Incolla il token in
VK_TEAMS_BOT_TOKEN. Viene inviato come parametro di querytokendi ogni chiamata, quindi appare nell'URL di ogni richiesta: tratta l'indirizzo qui sotto come infrastruttura fidata. - Imposta
VK_TEAMS_API_URLsull'indirizzo dell'API del bot. Per il cloud di VK Teams èhttps://myteam.mail.ru/bot/v1. Un'installazione on-premise ha il proprio indirizzo che termina con/bot/v1; il tuo amministratore di VK Teams lo conosce. Su AnythingMCP Cloud l'indirizzo deve essere raggiungibile da internet. - Per consentire al bot di lavorare in un gruppo o canale, permettigli di unirsi ai gruppi in Metabot (
/setjoingroups), quindi aggiungilo come membro (come amministratore per fissare, rinominare e gestire le liste dei membri).
Dove iniziare: vk_teams_get_self controlla il token e l'indirizzo. vk_teams_get_events restituisce ciò che le persone hanno scritto al bot e gli id di cui hai bisogno: payload.chat.chatId per una chat e payload.msgId per un messaggio. Non c'è una chiamata che elenchi le chat del bot, quindi conserva gli id che vedi.
Messaggi: vk_teams_send_text (plain, MarkdownV2 o HTML; risposta, inoltra e pulsanti inline), vk_teams_edit_text, vk_teams_delete_messages (disattivato all'installazione). File: vk_teams_upload_file recupera un file da un URL e lo invia; vk_teams_send_file invia un file che è già sul server tramite il suo fileId; vk_teams_get_file_info trasforma un fileId inviato da qualcuno in nome, dimensione e un link per il download. vk_teams_answer_callback_query risponde a una pressione di pulsante, vk_teams_send_chat_actions mostra che si sta digitando.
Gruppi e canali: vk_teams_get_chat_info, vk_teams_list_chat_admins, vk_teams_list_chat_members, vk_teams_list_blocked_users, vk_teams_list_pending_users, vk_teams_pin_message, vk_teams_unpin_message, vk_teams_set_chat_title e vk_teams_set_chat_about.
Note sul campo
chatId: una persona è identificata tramite l'id utente (in VK Teams di solito l'indirizzo email aziendale) o@nick; un id di gruppo o canale termina con@chat.agent.msgIdè un numero a 64 bit. Passalo come testo esattamente come ricevuto; il connettore restituisce anche tali numeri come testo in modo che nessuna cifra venga persa.- Eventi:
vk_teams_get_eventsconlast_event_id0 restituisce tutto ciò che è in attesa. Una volta che passi un id più alto, il server dimentica gli eventi fino a quel punto, quindi fallo solo dopo averli gestiti. Un altro programma che interroga lo stesso bot sottrae eventi da questo. - L'API risponde con HTTP 200 anche per un rifiuto e lo riporta come
ok: falsecon unadescription(ad esempioToken non valido); il connettore trasforma questo in un errore. - La maggior parte dei metodi sono richieste GET, comprese quelle che inviano; un messaggio viene consegnato nel momento in cui viene effettuata la chiamata.
- Formattazione: con
parse_modeMarkdownV2 esegui l'escape dei caratteri riservati dal formato, oppure usa HTML, che è più facile da gestire correttamente.
Passo 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
Passo 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 mostraYOUR_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.
- In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
- Inserisci un Server name (per esempio
AnythingMCP), una Server description che dica cosa fa il connettore e il Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server. - Come autenticazione scegli API key, imposta Type su Header e come nome dell'header
X-API-Key, poi seleziona Create. - 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.
- Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di
VK Teams. - 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.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
vk_teams_get_self | Leggi il bot dietro il token: userId, nick, firstName, about e foto. Usalo per controllare il token e l'indirizzo API. Solo lettura |
vk_teams_get_events | Leggi gli eventi in attesa per il bot (long polling): events[] con eventId, type (newMessage, editedMessage, deletedMessage, pinnedMessage… |
vk_teams_send_text | Invia un messaggio di testo come bot a un utente, gruppo o canale, formattato opzionalmente, come risposta, come inoltro, o con pulsanti inline. Restituisce… |
vk_teams_send_file | Invia un file che è già sui server di VK Teams, tramite il suo fileId, con una didascalia opzionale. Il fileId proviene da un caricamento precedente… |
vk_teams_upload_file | Carica un file da un URL e invialo come bot a un utente, gruppo o canale, con una didascalia opzionale. Il connettore scarica il file (su… |
vk_teams_edit_text | Cambia il testo di un messaggio inviato dal bot, e opzionalmente i suoi pulsanti inline. Restituisce ok. Solo i messaggi del bot possono essere modificati |
vk_teams_delete_messages | Elimina uno o più messaggi da una chat per tutti. Il bot può eliminare i propri messaggi entro 48 ore e, come amministratore di un… |
vk_teams_answer_callback_query | Rispondi alla pressione di un pulsante inline (un evento callbackQuery): mostra all'utente una breve notifica o un avviso, o apri un URL. Restituisce ok. Rispondi… |
vk_teams_send_chat_actions | Mostra cosa sta facendo il bot in una chat per circa 10 secondi: digitando un messaggio o guardando la chat. Passa una lista vuota per smettere di mostrarlo.… |
vk_teams_get_chat_info | Leggi una chat: tipo (privata, gruppo o canale) e, per una persona, firstName, lastName, nick, about e isBot; per un gruppo o canale, titolo… |
vk_teams_list_chat_admins | Elenca gli amministratori di un gruppo o canale: admins[] con userId e creator (true per il proprietario). Il bot deve essere un membro. Solo lettura |
vk_teams_list_chat_members | Elenca i membri di un gruppo o canale: members[] con userId e i flag creator e admin, più cursore quando ci sono altri. Il bot deve… |
vk_teams_list_blocked_users | Elenca gli utenti bloccati in un gruppo o canale: users[] con userId. Il bot deve essere un amministratore lì. Solo lettura |
vk_teams_list_pending_users | Elenca gli utenti in attesa di approvazione per unirsi a un gruppo o canale con moderazione di adesione: users[] con userId. Il bot deve essere un amministratore… |
vk_teams_pin_message | Fissa un messaggio in un gruppo o canale in modo che rimanga in cima. Il bot deve essere un amministratore lì. Restituisce ok |
vk_teams_unpin_message | Sblocca un messaggio fissato in un gruppo o canale; il messaggio stesso rimane. Il bot deve essere un amministratore lì. Restituisce ok |
vk_teams_set_chat_title | Cambia il titolo di un gruppo o canale. Ogni membro vede il nuovo titolo immediatamente, quindi confermalo con l'utente. Il bot deve essere un… |
vk_teams_set_chat_about | Cambia la descrizione (testo informativo) di un gruppo o canale. Il bot deve essere un amministratore lì. Restituisce ok |
vk_teams_get_file_info | Leggi i dettagli di un file sui server di VK Teams tramite il suo fileId: tipo (immagine, video, audio e così via), dimensione in byte, nome file e url, un… |
Esempi di prompt
- "Cosa hanno scritto le persone al bot da questa mattina?"
- "Invia il messaggio Release 2.4 è live al gruppo Dev Announcements."
- "Chi sono gli amministratori e i membri del canale Sales Team?"
- "Fissa l'ultimo messaggio nel gruppo Dev Announcements."
- "Cosa c'è nel file che Anna ha inviato al bot, e quanto è grande?"
FAQ
Da dove provengono il token e l'indirizzo? Scrivi /newbot a Metabot (@metabot) in VK Teams, scegli un nome e un soprannome che finisca con bot, e copia il token con cui risponde. L'indirizzo dell'API del bot del cloud di VK Teams è https://myteam.mail.ru/bot/v1; un'installazione on-premise ha il proprio indirizzo che termina con /bot/v1. Su AnythingMCP Cloud quell'indirizzo deve essere raggiungibile da internet.
Cosa può vedere e fare il bot? Tutto avviene come il bot: legge gli eventi inviati a lui, raggiunge gli utenti che gli hanno scritto per primi e le chat a cui è stato aggiunto, invia e modifica messaggi, invia file, risponde a pressioni di pulsanti e legge e gestisce i suoi gruppi e canali (fissare, titoli e liste dei membri richiedono diritti di amministratore). Non c'è una chiamata che elenchi le chat del bot, e un altro programma che interroga lo stesso bot sottrae eventi da questo.
Quali strumenti sono installati disattivati? vk_teams_delete_messages. Attivalo nella pagina del connettore solo se l'IA deve usarlo. I messaggi vengono inviati nel momento in cui viene effettuata la chiamata, quindi l'IA ti mostra ciascuno di essi prima.
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
Questa guida ti è stata utile?