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 Cursor in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega VK Teams con la configurazione guidata e aggiungi il tuo URL MCP a Cursor. 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 + Cursor
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 Cursor
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.
Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:
{
"mcpServers": {
"anythingmcp": {
"url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di
YOUR_MCP_API_KEY. - Salva il file e riavvia Cursor.
- Apri Cursor → Settings → MCP e verifica che
anythingmcpsia elencato e connesso. - Inizia a chattare: l'agente ora può usare i tool di
VK Teams.
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.
Cursor supporta server MCP personalizzati nel piano gratuito? Sì — MCP è disponibile nei piani Hobby, Pro e Business.
Prossimi passi
Questa guida ti è stata utile?