Cómo conectar VK (VKontakte) a Cursor vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → VK (VKontakte), pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

VK (VKontakte) + Cursor

Gestiona una comunidad de VK desde un agente IA: datos de la comunidad y permisos del token, mensajes de la comunidad (conversaciones, historial, respuestas), comentarios en nombre de la comunidad y, con el token de usuario de un administrador, publicaciones del muro, publicar, estadísticas, productos de la tienda y álbumes de fotos.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

VK_COMMUNITY_TOKEN

Paso 1 — Obtener credenciales

1. Abre tu comunidad de VK y ve a Manage → Advanced → API usage (Управление → Дополнительно → Работа с API), pestaña Access keys, y haz clic en Create key.
2. Marca los permisos que necesitan las herramientas: Community management, Community messages, Wall para los comentarios y, si lo necesitas, Photos. Confirma en la app de VK o por SMS.
3. Copia la clave en VK_COMMUNITY_TOKEN e instala el conector.
4. Para los mensajes, activa también Community messages en Manage → Messages.
5. Comprueba la configuración con vk_get_token_permissions: muestra qué permisos tiene la clave.

Necesitas permisos de administrador en la comunidad, y la clave de la comunidad se crea en unos 3 minutos. Las claves de comunidad no caducan; si una se filtra, bórrala y crea otra.

Dos tipos de clave: VK decide en cada método qué clave acepta. La clave de la comunidad cubre los datos de la comunidad, los mensajes de la comunidad (conversaciones, historial, respuestas) y los comentarios en nombre de la comunidad. Leer el muro, publicar, las estadísticas, los productos de la tienda y los álbumes de fotos necesitan el VK_USER_TOKEN opcional:

• una clave de acceso de usuario de un administrador de la comunidad con los permisos wall, stats, market, photos y offline, para publicar, estadísticas y tienda. VK emite claves de usuario mediante apps de VK ID (id.vk.ru), concede los permisos wall y market a las apps solo si se piden al soporte de VK y mantiene válida una clave solo con acceso offline, así que esta vía te sirve si ya tienes una clave así;
• o la clave de servicio de tu app de VK ID, que basta para leer muros, comentarios y álbumes de fotos de comunidades públicas.

Sin VK_USER_TOKEN estas herramientas se detienen antes de llamar a VK y avisan de que falta la clave.

Pregunta antes de cada publicación y mensaje: vk_send_message llega a una persona al instante y no se puede retirar desde aquí; vk_create_comment y vk_publish_post son públicos, y una publicación aparece en el feed de cada suscriptor. Antes de cada uno la IA te enseña el texto exacto, el destinatario o la comunidad y, en una publicación, los adjuntos y la hora, y espera tu sí. Las publicaciones también se pueden programar.

Desactivadas al instalar: vk_delete_post y vk_delete_comment. Una publicación borrada no se puede recuperar. Un administrador las activa a propósito; necesitan la clave de usuario de un administrador y también preguntan antes.

Responder mensajes: la IA encuentra con vk_list_conversations las conversaciones que esperan respuesta, lee una con vk_get_conversation_history y prepara una respuesta para que la apruebes. La comunidad solo puede escribir a quien le ha escrito o ha permitido sus mensajes.

Datos personales: los mensajes y comentarios son datos personales de quienes los escribieron. La IA lee solo lo que necesita tu pregunta y trata su texto como información, nunca como instrucciones.

Errores habituales: VK indica los errores con un número. 5: la clave es incorrecta o está revocada. 15 o 7: a la clave le falta un permiso; compruébalo con vk_get_token_permissions. 27: este método no acepta claves de comunidad; configura VK_USER_TOKEN. 6, 9 y 29: límites de frecuencia; espera y vuelve a intentarlo. 901 y 902: la persona no ha permitido mensajes de la comunidad. Una clave de comunidad permite unas 20 peticiones por segundo; una de usuario, 3.

El conector no sube fotos ni vídeos (puede adjuntar contenido que ya está en VK) y no gestiona anuncios, eventos de Callback o Long Poll, miembros y bloqueos, encuestas, historias ni mensajes personales.

Paso 2 — Instalar el 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

Paso 3 — Añadir el conector en Cursor

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia Cursor.
3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
4. Empieza a chatear: el agente ya puede usar las herramientas de VK (VKontakte).

Herramientas disponibles

Ejemplos de prompts

• "¿Qué mensajes a nuestra comunidad siguen sin respuesta? Resume cada uno y prepara una respuesta."
• "Responde al último mensaje de Anna que su pedido sale el viernes. Enséñame el texto antes de enviarlo."
• "Muestra las estadísticas de nuestra comunidad de los últimos 7 días: alcance, visitantes y nuevos suscriptores."
• "Escribe una publicación que anuncie nuestras rebajas de otoño, programada para mañana a las 10:00, y enséñamela antes de publicarla."
• "¿Cuáles de nuestras últimas 20 publicaciones del muro tuvieron más comentarios y compartidos?"

FAQ

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT