Come collegare VK (VKontakte) a Cursor via MCP

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

VK (VKontakte) + Cursor

Gestisci una community VK da un agente AI: informazioni sulla community e diritti del token, messaggi della community (conversazioni, cronologia, risposte), commenti a nome della community e, con il token utente di un admin, post in bacheca, pubblicazione, statistiche, prodotti del negozio e album fotografici.

Prerequisiti

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

VK_COMMUNITY_TOKEN

Step 1 — Ottieni le credenziali

1. Apri la tua community VK e vai in Manage → Advanced → API usage (Управление → Дополнительно → Работа с API), scheda Access keys, poi clicca Create key.
2. Spunta i diritti che servono agli strumenti: Community management, Community messages, Wall per i commenti e, se ti serve, Photos. Conferma nell'app VK o via SMS.
3. Copia la chiave in VK_COMMUNITY_TOKEN e installa il connettore.
4. Per i messaggi, attiva anche Community messages in Manage → Messages.
5. Verifica la configurazione con vk_get_token_permissions: mostra quali diritti ha la chiave.

Servono i diritti di amministratore della community, e la chiave della community richiede circa 3 minuti. Le chiavi della community non scadono; se una finisce in mani sbagliate, eliminala e creane una nuova.

Due tipi di chiave: VK decide metodo per metodo quale chiave accettare. La chiave della community copre i dati della community, i messaggi della community (conversazioni, cronologia, risposte) e i commenti a nome della community. Leggere la bacheca, pubblicare post, statistiche, prodotti del negozio e album fotografici richiedono il VK_USER_TOKEN facoltativo:

• una chiave di accesso utente di un amministratore della community con i diritti wall, stats, market, photos e offline, per pubblicare, statistiche e negozio. VK rilascia le chiavi utente tramite app VK ID (id.vk.ru), concede i diritti wall e market alle app solo su richiesta al supporto VK e mantiene valida una chiave solo con l'accesso offline, quindi questa strada fa per te se hai già una chiave così;
• oppure la chiave di servizio della tua app VK ID, che basta per leggere bacheche, commenti e album fotografici delle community pubbliche.

Senza VK_USER_TOKEN questi strumenti si fermano prima di chiamare VK e segnalano che la chiave manca.

Chiede prima di ogni post e messaggio: vk_send_message raggiunge subito una persona e da qui non si può ritirare; vk_create_comment e vk_publish_post sono pubblici, e un post finisce nel feed di ogni iscritto. Prima di ognuno l'AI ti mostra il testo esatto, il destinatario o la community e, per un post, gli allegati e l'orario, poi aspetta il tuo sì. I post si possono anche programmare.

Disattivati all'installazione: vk_delete_post e vk_delete_comment. Un post eliminato non si può recuperare. Un amministratore li attiva consapevolmente; richiedono la chiave utente di un admin e chiedono prima anche loro.

Rispondere ai messaggi: l'AI trova con vk_list_conversations le conversazioni in attesa di risposta, ne legge una con vk_get_conversation_history e prepara una risposta che approvi tu. La community può scrivere solo a chi le ha scritto o ha accettato i suoi messaggi.

Dati personali: messaggi e commenti sono dati personali di chi li ha scritti. L'AI legge solo ciò che serve alla tua domanda e tratta il loro testo come informazione, mai come istruzione.

Errori comuni: VK segnala gli errori con un numero. 5: la chiave è sbagliata o revocata. 15 o 7: alla chiave manca un diritto; controllalo con vk_get_token_permissions. 27: questo metodo non accetta chiavi della community; imposta VK_USER_TOKEN. 6, 9 e 29: limiti di frequenza; aspetta e riprova. 901 e 902: la persona non ha accettato i messaggi della community. Una chiave della community consente circa 20 richieste al secondo, una chiave utente 3.

Il connettore non carica foto o video (può allegare contenuti già presenti su VK) e non gestisce pubblicità, eventi Callback o Long Poll, membri e ban, sondaggi, storie o messaggi personali.

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 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 mostra YOUR_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" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia Cursor.
3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
4. Inizia a chattare: l'agente ora può usare i tool di VK (VKontakte).

Tool disponibili

Esempi di prompt

• "Quali messaggi alla nostra community sono ancora senza risposta? Riassumi ognuno e prepara una risposta."
• "Rispondi all'ultimo messaggio di Anna che il suo ordine parte venerdì. Mostrami il testo prima di inviarlo."
• "Mostra le statistiche della nostra community degli ultimi 7 giorni: copertura, visitatori e nuovi iscritti."
• "Scrivi un post che annuncia i nostri saldi d'autunno, programmato per domani alle 10:00, e mostramelo prima di pubblicarlo."
• "Quali dei nostri ultimi 20 post in bacheca hanno avuto più commenti e condivisioni?"

FAQ

Cursor supporta server MCP personalizzati nel piano gratuito? Sì, MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT