Resumen
Deja que tu IA funcione como un bot en VK Teams (VK WorkSpace), en la nube o en local: lee mensajes y eventos entrantes, envía y edita mensajes, envía archivos, responde a pulsaciones de botones y busca y gestiona grupos y canales. Token del bot.
Configuración guiada
Conecta VK Teams a Gemini en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta VK Teams con la configuración guiada y añade tu URL MCP a Gemini. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
Prueba a pedir
Prompts de ejemplo para VK Teams
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿No tienes instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → VK Teams, introduce la dirección de la API del bot y el token del bot de Metabot, genera una clave API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
VK Teams + Gemini
Deja que tu IA funcione como un bot en VK Teams (VK WorkSpace), en la nube o en local: lee mensajes y eventos entrantes, envía y edita mensajes, envía archivos, responde a pulsaciones de botones y busca y gestiona grupos y canales. Token del bot.
Requisitos previos
Consulta las instrucciones completas de configuración integradas en el conector (visibles en la tienda de la aplicación cuando seleccionas el conector). Las variables de entorno requeridas para este conector son:
VK_TEAMS_API_URL, VK_TEAMS_BOT_TOKEN
Paso 1 — Obtener credenciales
La configuración tarda unos 3 minutos.
- En VK Teams, abre un chat con Metabot (busca
@metabot) y envía/newbot. Elige un nombre y un apodo que termine enbot. Metabot responde con el token del bot, que se ve como001.2659914704.0218887601:747432131. - Pega el token en
VK_TEAMS_BOT_TOKEN. Se envía como el parámetro de consultatokende cada llamada, por lo que aparece en la URL de cada solicitud: trata la dirección a continuación como infraestructura de confianza únicamente. - Establece
VK_TEAMS_API_URLen la dirección de la API del bot. Para la nube de VK Teams eshttps://myteam.mail.ru/bot/v1. Una instalación en local tiene su propia dirección que termina en/bot/v1; tu administrador de VK Teams lo sabe. En AnythingMCP Cloud, la dirección debe ser accesible desde internet. - Para permitir que el bot funcione en un grupo o canal, permite que se una a grupos en Metabot (
/setjoingroups), luego añádelo como miembro (como administrador para fijar, renombrar y las listas de miembros).
Dónde empezar: vk_teams_get_self verifica el token y la dirección. vk_teams_get_events devuelve lo que la gente escribió al bot y los ids que necesitas: payload.chat.chatId para un chat y payload.msgId para un mensaje. No hay llamada que liste los chats del bot, así que guarda los ids que ves.
Mensajes: vk_teams_send_text (plano, MarkdownV2 o HTML; respuesta, reenvío y botones en línea), vk_teams_edit_text, vk_teams_delete_messages (desactivado en la instalación). Archivos: vk_teams_upload_file obtiene un archivo de una URL y lo envía; vk_teams_send_file envía un archivo que ya está en el servidor por su fileId; vk_teams_get_file_info convierte un fileId que alguien envió en nombre, tamaño y un enlace de descarga. vk_teams_answer_callback_query responde a una pulsación de botón, vk_teams_send_chat_actions muestra que está escribiendo.
Grupos y canales: 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 y vk_teams_set_chat_about.
Notas de campo
chatId: una persona se dirige por id de usuario (en VK Teams generalmente la dirección de correo electrónico corporativa) o@nick; un id de grupo o canal termina en@chat.agent.msgIdes un número de 64 bits. Pásalo como texto exactamente como se recibió; el conector también devuelve tales números como texto para que no se pierda ningún dígito.- Eventos:
vk_teams_get_eventsconlast_event_id0 devuelve todo lo que está esperando. Una vez que pases un id más alto, el servidor olvida los eventos hasta ese punto, así que solo hazlo después de manejarlos. Otro programa que consulta el mismo bot quita eventos de este. - La API responde HTTP 200 incluso para un rechazo y lo informa como
ok: falsecon unadescription(por ejemploInvalid token); el conector convierte eso en un error. - La mayoría de los métodos son solicitudes GET, incluidas las que envían; un mensaje se entrega en el momento en que se realiza la llamada.
- Formateo: con
parse_modeMarkdownV2 escapa los caracteres que el formato reserva, o usa HTML, que es más fácil de acertar.
Paso 2 — Instalar el adaptador
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 Gemini
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 muestraYOUR_SERVER_ID.
Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- 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. - Guarda el archivo y reinicia
gemini. - Ejecuta
/mcpdentro de Gemini CLI (ogemini mcp listen tu terminal):anythingmcpdebería aparecer como conectado. - Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de
VK Teams.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
vk_teams_get_self | Lee el bot detrás del token: userId, nick, firstName, about y photo. Úsalo para verificar el token y la dirección de la API. Solo lectura |
vk_teams_get_events | Lee los eventos que esperan al bot (polling largo): events[] con eventId, type (newMessage, editedMessage, deletedMessage, pinnedMessage… |
vk_teams_send_text | Envía un mensaje de texto como el bot a un usuario, grupo o canal, opcionalmente formateado, como respuesta, como reenvío, o con botones en línea. Devuelve… |
vk_teams_send_file | Envía un archivo que ya está en los servidores de VK Teams, por su fileId, con un pie de foto opcional. El fileId proviene de una carga anterior… |
vk_teams_upload_file | Sube un archivo desde una URL y envíalo como el bot a un usuario, grupo o canal, con un pie de foto opcional. El conector descarga el archivo (hasta… |
vk_teams_edit_text | Cambia el texto de un mensaje que envió el bot, y opcionalmente sus botones en línea. Devuelve ok. Solo se pueden editar los mensajes del propio bot |
vk_teams_delete_messages | Elimina uno o más mensajes de un chat para todos. El bot puede eliminar sus propios mensajes dentro de las 48 horas y, como administrador de un… |
vk_teams_answer_callback_query | Responde a la pulsación de un botón en línea (un evento callbackQuery): muestra al usuario un aviso breve o una alerta, o abre una URL. Devuelve ok. Responde… |
vk_teams_send_chat_actions | Muestra lo que el bot está haciendo en un chat durante unos 10 segundos: escribiendo un mensaje o mirando el chat. Pasa una lista vacía para dejar de mostrarlo.… |
vk_teams_get_chat_info | Lee un chat: tipo (privado, grupo o canal) y, para una persona, firstName, lastName, nick, about y isBot; para un grupo o canal, title… |
vk_teams_list_chat_admins | Lista los administradores de un grupo o canal: admins[] con userId y creator (true para el propietario). El bot debe ser miembro. Solo lectura |
vk_teams_list_chat_members | Lista los miembros de un grupo o canal: members[] con userId y las banderas creator y admin, además de cursor cuando hay más. El bot debe… |
vk_teams_list_blocked_users | Lista los usuarios bloqueados en un grupo o canal: users[] con userId. El bot debe ser un administrador allí. Solo lectura |
vk_teams_list_pending_users | Lista los usuarios que esperan aprobación para unirse a un grupo o canal con moderación de unirse: users[] con userId. El bot debe ser un administrador… |
vk_teams_pin_message | Fija un mensaje en un grupo o canal para que permanezca en la parte superior. El bot debe ser un administrador allí. Devuelve ok |
vk_teams_unpin_message | Desfija un mensaje fijado en un grupo o canal; el mensaje en sí permanece. El bot debe ser un administrador allí. Devuelve ok |
vk_teams_set_chat_title | Cambia el título de un grupo o canal. Cada miembro ve el nuevo título de inmediato, así que confírmalo con el usuario. El bot debe ser un… |
vk_teams_set_chat_about | Cambia la descripción (texto sobre) de un grupo o canal. El bot debe ser un administrador allí. Devuelve ok |
vk_teams_get_file_info | Lee los detalles de un archivo en los servidores de VK Teams por su fileId: tipo (imagen, video, audio, etc.), tamaño en bytes, nombre de archivo y url, un… |
Ejemplos de mensajes
- "¿Qué han escrito las personas al bot desde esta mañana?"
- "Envía el mensaje La versión 2.4 está en vivo al grupo Anuncios de Desarrollo."
- "¿Quiénes son los administradores y miembros del canal Equipo de Ventas?"
- "Fija el último mensaje en el grupo Anuncios de Desarrollo."
- "¿Qué hay en el archivo que Anna envió al bot, y cuán grande es?"
Preguntas frecuentes
¿De dónde provienen el token y la dirección? Escribe /newbot a Metabot (@metabot) en VK Teams, elige un nombre y un apodo que termine en bot, y copia el token con el que responde. La dirección de la API del bot de la nube de VK Teams es https://myteam.mail.ru/bot/v1; una instalación en local tiene su propia dirección que termina en /bot/v1. En AnythingMCP Cloud, esa dirección debe ser accesible desde internet.
¿Qué puede ver y hacer el bot? Todo sucede como el bot: lee los eventos enviados a él, alcanza a los usuarios que le escribieron primero y chats a los que fue añadido, envía y edita mensajes, envía archivos, responde a pulsaciones de botones y lee y gestiona sus grupos y canales (fijar, títulos y listas de miembros necesitan derechos de administrador). No hay llamada que liste los chats del bot, y otro programa que consulta el mismo bot quita eventos de este.
¿Qué herramientas se instalan desactivadas? vk_teams_delete_messages. Actívala en la página del conector solo si la IA debe usarla. Los mensajes se envían en el momento en que se realiza la llamada, así que la IA te muestra cada uno primero.
¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.
Próximos pasos
¿Te ha sido útil esta guía?