Кратко
Позволь своему AI работать как бот в VK Teams (VK WorkSpace), в облаке или на месте: читай входящие сообщения и события, отправляй и редактируй сообщения, отправляй файлы, отвечай на нажатия кнопок и управляй группами и каналами. Токен бота.
Пошаговая настройка
Подключи VK Teams к Claude, ChatGPT или Copilot за 2 минуты
Начни бесплатный пробный период в AnythingMCP Cloud, подключи VK Teams в пошаговой настройке и добавь свой MCP URL в своего ИИ-ассистента. Без кода и без собственного сервера.
Без банковской карты · 7 дней пробного периода · Есть вариант self-host
Попробуй спросить
Примеры промптов для VK Teams
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Нет установки? Используй cloud.anythingmcp.com напрямую. Войди в систему, нажми Connectors → VK Teams, введи адрес Bot API и токен бота от Metabot, создай ключ API MCP и готово. Никакого Docker, никакого
git clone, никакого локального сервера.
VK Teams
Позволь своему AI работать как бот в VK Teams (VK WorkSpace), в облаке или на месте: читай входящие сообщения и события, отправляй и редактируй сообщения, отправляй файлы, отвечай на нажатия кнопок и управляй группами и каналами. Токен бота.
Настройка
Настройка занимает около 3 минут.
- В VK Teams открой чат с Metabot (поиск по
@metabot) и отправь/newbot. Выбери имя и ник, заканчивающийся наbot. Metabot ответит токеном бота, который выглядит как001.2659914704.0218887601:747432131. - Вставь токен в
VK_TEAMS_BOT_TOKEN. Он отправляется как параметр запросаtokenкаждого вызова, поэтому он появляется в URL каждого запроса: рассматривай адрес ниже как доверенную инфраструктуру. - Установи
VK_TEAMS_API_URLна адрес Bot API. Для облака VK Teams этоhttps://myteam.mail.ru/bot/v1. У локальной установки есть свой адрес, заканчивающийся на/bot/v1; твой администратор VK Teams знает его. На AnythingMCP Cloud адрес должен быть доступен из интернета. - Чтобы бот работал в группе или канале, разреши ему присоединяться к группам в Metabot (
/setjoingroups), затем добавь его в качестве участника (в качестве администратора для закрепления, переименования и списков участников).
С чего начать: vk_teams_get_self проверяет токен и адрес. vk_teams_get_events возвращает то, что люди написали боту, и идентификаторы, которые тебе нужны: payload.chat.chatId для чата и payload.msgId для сообщения. Нет вызова, который перечисляет чаты бота, поэтому сохраняй идентификаторы, которые ты видишь.
Сообщения: vk_teams_send_text (обычный, MarkdownV2 или HTML; ответ, пересылка и встроенные кнопки), vk_teams_edit_text, vk_teams_delete_messages (отключено при установке). Файлы: vk_teams_upload_file загружает файл по URL и отправляет его; vk_teams_send_file отправляет файл, который уже на сервере по его fileId; vk_teams_get_file_info преобразует fileId, который кто-то отправил, в имя, размер и ссылку для скачивания. vk_teams_answer_callback_query отвечает на нажатие кнопки, vk_teams_send_chat_actions показывает, что бот печатает.
Группы и каналы: 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 и vk_teams_set_chat_about.
Полевые заметки
chatId: человек адресуется по user id (в VK Teams обычно корпоративный адрес электронной почты) или@nick; id группы или канала заканчивается на@chat.agent.msgId— это 64-битное число. Передавай его как текст точно так, как он получен; коннектор также возвращает такие числа как текст, чтобы ни одна цифра не была потеряна.- События:
vk_teams_get_eventsсlast_event_id0 возвращает все ожидающие. Как только ты передаешь более высокий id, сервер забывает события до него, поэтому делай это только после их обработки. Другая программа, опрашивающая того же бота, забирает события у этого. - API отвечает HTTP 200 даже при отказе и сообщает об этом как
ok: falseсdescription(например,Неверный токен); коннектор преобразует это в ошибку. - Большинство методов — это GET-запросы, включая те, что отправляют; сообщение доставляется в момент вызова.
- Форматирование: с
parse_modeMarkdownV2 экранируй символы, зарезервированные форматом, или используй HTML, что проще сделать правильно.
Предварительные требования: VK_TEAMS_API_URL, VK_TEAMS_BOT_TOKEN
Установи коннектор локально
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
Открой http://localhost:3000/connectors/store, выбери VK Teams и вставь переменные окружения, указанные в предварительных требованиях.
Доступные инструменты
| Инструмент | Что он делает |
|---|---|
vk_teams_get_self | Читает бота за токеном: userId, nick, firstName, about и photo. Используй его для проверки токена и адреса API. Только для чтения |
vk_teams_get_events | Читает события, ожидающие бота (долгое опрашивание): events[] с eventId, type (newMessage, editedMessage, deletedMessage, pinnedMessage… |
vk_teams_send_text | Отправляет текстовое сообщение от имени бота пользователю, группе или каналу, опционально отформатированное, как ответ, пересылка или с встроенными кнопками. Возвращает… |
vk_teams_send_file | Отправляет файл, который уже на серверах VK Teams, по его fileId, с опциональной подписью. fileId приходит из предыдущей загрузки… |
vk_teams_upload_file | Загружает файл по URL и отправляет его от имени бота пользователю, группе или каналу, с опциональной подписью. Коннектор загружает файл (в… |
vk_teams_edit_text | Изменяет текст сообщения, отправленного ботом, и опционально его встроенные кнопки. Возвращает ok. Можно редактировать только собственные сообщения бота |
vk_teams_delete_messages | Удаляет одно или несколько сообщений из чата для всех. Бот может удалить свои собственные сообщения в течение 48 часов и, как администратор группы… |
vk_teams_answer_callback_query | Отвечает на нажатие встроенной кнопки (событие callbackQuery): показывает пользователю короткое уведомление или предупреждение, или открывает URL. Возвращает ok. Ответ… |
vk_teams_send_chat_actions | Показывает, что бот делает в чате в течение примерно 10 секунд: печатает сообщение или смотрит на чат. Передай пустой список, чтобы прекратить показ.… |
vk_teams_get_chat_info | Читает чат: тип (приватный, группа или канал) и, для человека, firstName, lastName, nick, about и isBot; для группы или канала, title… |
vk_teams_list_chat_admins | Перечисляет администраторов группы или канала: admins[] с userId и creator (true для владельца). Бот должен быть участником. Только для чтения |
vk_teams_list_chat_members | Перечисляет участников группы или канала: members[] с userId и флагами creator и admin, плюс курсор, когда следуют другие. Бот должен… |
vk_teams_list_blocked_users | Перечисляет пользователей, заблокированных в группе или канале: users[] с userId. Бот должен быть администратором там. Только для чтения |
vk_teams_list_pending_users | Перечисляет пользователей, ожидающих одобрения для присоединения к группе или каналу с модерацией присоединения: users[] с userId. Бот должен быть администратором… |
vk_teams_pin_message | Закрепляет сообщение в группе или канале, чтобы оно оставалось на верху. Бот должен быть администратором там. Возвращает ok |
vk_teams_unpin_message | Снимает закрепление с закрепленного сообщения в группе или канале; само сообщение остается. Бот должен быть администратором там. Возвращает ok |
vk_teams_set_chat_title | Изменяет название группы или канала. Каждый участник сразу видит новое название, поэтому подтвердите его с пользователем. Бот должен быть администратором… |
vk_teams_set_chat_about | Изменяет описание (текст о) группы или канала. Бот должен быть администратором там. Возвращает ok |
vk_teams_get_file_info | Читает детали файла на серверах VK Teams по его fileId: тип (изображение, видео, аудио и так далее), размер в байтах, имя файла и url, а… |
Примеры запросов
- "Что люди написали боту с утра?"
- "Отправь сообщение 'Релиз 2.4 в эфире' в группу 'Объявления разработчиков'."
- "Кто администраторы и участники канала 'Команда продаж'?"
- "Закрепи последнее сообщение в группе 'Объявления разработчиков'."
- "Что в файле, который Анна отправила боту, и каков его размер?"
Следующие шаги
Это руководство помогло?