MCP для управления сообществом VK
vk-community-mcp
MCP-сервер для управления сообществом ВКонтакте: настройки, стена, обложка и аватар, фотоальбомы, товары и мониторинг, 28 инструментов
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Публикует, редактирует и удаляет посты на стене сообщества
- Меняет обложку, аватар и настройки сообщества
- Токен получается способом, который README сам называет серой зоной условий VK
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/vk-community-mcpОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Собрано автоматически, проверьте перед установкой.
У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.
Выполните в терминале
claude mcp add --transport stdio --env 'VK_TOKEN=<ваш VK_TOKEN>' --env VK_API_VERSION=5.199 vk-community -- npx -y vk-community-mcpИли добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"vk-community": {
"command": "npx",
"args": [
"-y",
"vk-community-mcp"
],
"env": {
"VK_TOKEN": "<ваш VK_TOKEN>",
"VK_API_VERSION": "5.199"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
VK_TOKENсекрет, обязательная- User access token with admin rights on target communities
VK_DEFAULT_GROUP_IDнеобязательная- Numeric community id used when tool group_id arg is not provided
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"vk-community": {
"command": "npx",
"args": [
"-y",
"vk-community-mcp"
],
"env": {
"VK_TOKEN": "<ваш VK_TOKEN>",
"VK_API_VERSION": "5.199"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Ключи и настройки
VK_TOKENсекрет, обязательная- User access token with admin rights on target communities
VK_DEFAULT_GROUP_IDнеобязательная- Numeric community id used when tool group_id arg is not provided
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
code --add-mcp '{"name":"vk-community","type":"stdio","command":"npx","args":["-y","vk-community-mcp"],"env":{"VK_TOKEN":"<ваш VK_TOKEN>","VK_API_VERSION":"5.199"}}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"vk-community": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"vk-community-mcp"
],
"env": {
"VK_TOKEN": "<ваш VK_TOKEN>",
"VK_API_VERSION": "5.199"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Ключи и настройки
VK_TOKENсекрет, обязательная- User access token with admin rights on target communities
VK_DEFAULT_GROUP_IDнеобязательная- Numeric community id used when tool group_id arg is not provided
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
codex mcp add vk-community --env 'VK_TOKEN=<ваш VK_TOKEN>' --env VK_API_VERSION=5.199 -- npx -y vk-community-mcpИли добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.vk-community]
command = "npx"
args = ["-y", "vk-community-mcp"]
env = { VK_TOKEN = "<ваш VK_TOKEN>", VK_API_VERSION = "5.199" }Если файл уже есть, допишите блок в конец.
Ключи и настройки
VK_TOKENсекрет, обязательная- User access token with admin rights on target communities
VK_DEFAULT_GROUP_IDнеобязательная- Numeric community id used when tool group_id arg is not provided
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"vk-community": {
"command": "npx",
"args": [
"-y",
"vk-community-mcp"
],
"env": {
"VK_TOKEN": "<ваш VK_TOKEN>",
"VK_API_VERSION": "5.199"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
VK_TOKENсекрет, обязательная- User access token with admin rights on target communities
VK_DEFAULT_GROUP_IDнеобязательная- Numeric community id used when tool group_id arg is not provided
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"vk-community": {
"command": "npx",
"args": [
"-y",
"vk-community-mcp"
],
"env": {
"VK_TOKEN": "<ваш VK_TOKEN>",
"VK_API_VERSION": "5.199"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Ключи и настройки
VK_TOKENсекрет, обязательная- User access token with admin rights on target communities
VK_DEFAULT_GROUP_IDнеобязательная- Numeric community id used when tool group_id arg is not provided
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"vk-community": {
"command": "npx",
"args": [
"-y",
"vk-community-mcp"
],
"env": {
"VK_TOKEN": "<ваш VK_TOKEN>",
"VK_API_VERSION": "5.199"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Ключи и настройки
VK_TOKENсекрет, обязательная- User access token with admin rights on target communities
VK_DEFAULT_GROUP_IDнеобязательная- Numeric community id used when tool group_id arg is not provided
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"vk-community": {
"command": "npx",
"args": [
"-y",
"vk-community-mcp"
],
"env": {
"VK_TOKEN": "<ваш VK_TOKEN>",
"VK_API_VERSION": "5.199"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
VK_TOKENсекрет, обязательная- User access token with admin rights on target communities
VK_DEFAULT_GROUP_IDнеобязательная- Numeric community id used when tool group_id arg is not provided
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"vk-community": {
"type": "local",
"command": [
"npx",
"-y",
"vk-community-mcp"
],
"environment": {
"VK_TOKEN": "<ваш VK_TOKEN>",
"VK_API_VERSION": "5.199"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Ключи и настройки
VK_TOKENсекрет, обязательная- User access token with admin rights on target communities
VK_DEFAULT_GROUP_IDнеобязательная- Numeric community id used when tool group_id arg is not provided
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"vk-community": {
"command": "npx",
"args": [
"-y",
"vk-community-mcp"
],
"env": {
"VK_TOKEN": "<ваш VK_TOKEN>",
"VK_API_VERSION": "5.199"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Ключи и настройки
VK_TOKENсекрет, обязательная- User access token with admin rights on target communities
VK_DEFAULT_GROUP_IDнеобязательная- Numeric community id used when tool group_id arg is not provided
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"vk-community": {
"command": "npx",
"args": [
"-y",
"vk-community-mcp"
],
"env": {
"VK_TOKEN": "<ваш VK_TOKEN>",
"VK_API_VERSION": "5.199"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
VK_TOKENсекрет, обязательная- User access token with admin rights on target communities
VK_DEFAULT_GROUP_IDнеобязательная- Numeric community id used when tool group_id arg is not provided
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Получи токен администратора сообщества (по официальному приложению VK ID или методом из README), добавь сервер в .mcp.json с переменными VK_TOKEN и VK_DEFAULT_GROUP_ID командой npx -y vk-community-mcp.
Другие способы из описания автора
{
"vk-community": {
"command": "npx",
"args": ["-y", "vk-community-mcp"],
"env": {
"VK_TOKEN": "${VK_TOKEN}",
"VK_DEFAULT_GROUP_ID": "YOUR_GROUP_ID"
}
}
}Фрагмент для .mcp.json из README, VK_TOKEN читается из ~/.secrets/secrets.env.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту административный доступ к одному или нескольким сообществам VK: чтение и правку настроек группы, публикацию, редактирование, удаление и закрепление постов на стене, загрузку обложки и аватара из локального файла, создание и заполнение фотоальбомов, работу с товарами маркета и статистику. Каждый инструмент принимает необязательный group_id, если нужно работать не с сообществом по умолчанию. При капче на операциях записи инструмент возвращает VkCaptchaError с картинкой и sid для повторного вызова с решением.
Для кого. Для админов сообществ ВКонтакте, которые хотят вести стену, фото и товары через агента вместо интерфейса VK.
Подходит, если
- Нужно вести несколько сообществ VK с общим набором инструментов и переключением по group_id
- Нужна загрузка обложки, аватара и фото в альбомы без ручного захода в VK
- Нужен мониторинг и работа с товарами маркета сообщества
Не подходит, если
- Нужна личная стена и сообщения, а не управление сообществом
- Не устраивает способ получения токена через OAuth Kate Mobile, описанный в README как серая зона по условиям VK
Пример запроса к агенту
Обнови обложку сообщества файлом cover.png и закрепи пост про новую коллекцию на стенеОграничения
README прямо называет способ получения токена через client_id Kate Mobile серой зоной условий использования VK: формально не разрешен, но широко применяется SMM-сервисами вроде Senler и SMMplanner, и предлагает для продакшена получать официальное приложение VK ID через devsupport@corp.vk.com. Нужен токен с правами администратора сообщества. VK может запросить капчу на операциях записи при подозрении на бота.
Как отключить. Удалите сервер vk-community из .mcp.json и отзовите токен доступа в настройках приложения VK.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| VK_TOKEN обязательная, секрет | Пользовательский токен с правами администратора сообщества. |
| VK_DEFAULT_GROUP_ID | Числовой id сообщества по умолчанию, если group_id не передан в вызове. |
| VK_API_VERSION | Переопределение версии VK API, по умолчанию 5.199. |
Проверка безопасности
- Публикует, редактирует и удаляет посты на стене сообщества
- Меняет обложку, аватар и настройки сообщества
- Токен получается способом, который README сам называет серой зоной условий VK
Коротко о README
README описывает сервер как MCP для управления сообществами VKontakte с 28 инструментами по разделам: настройки группы, стена, фото и обложка, альбомы, товары, мониторинг. Отдельно и честно описан способ получения пользовательского токена через OAuth-flow Kate Mobile с прямым предупреждением о серой зоне условий VK и рекомендацией получить официальное приложение для продакшена. Показана обработка капчи на операциях записи и лимиты запросов.
Частые вопросы
Что делать, если VK требует капчу?
Инструмент вернет VkCaptchaError с sid и ссылкой на картинку, нужно показать картинку человеку, получить решение и повторить вызов с captcha_sid и captcha_key.
Можно ли использовать сервер для нескольких сообществ?
Да, каждый инструмент принимает необязательный group_id, а VK_DEFAULT_GROUP_ID задает сообщество по умолчанию, когда group_id не передан.
Похожие
Скилл, который убирает из текста приметы ИИ-письма по списку Википедии и не добавляет выдуманных фактов
Marketing Skills: маркетинговые скиллы для агентов
Marketing Skills for AI Agents
Около пятидесяти скиллов по CRO, копирайтингу, SEO, аналитике, рекламе и запуску продукта для кодовых агентов
MCP-сервер SendPulse
SendPulse MCP
Официальный удаленный MCP-сервер SendPulse: статистика, рассылки и данные пользователей через чат с агентом
MCP Яндекс Директа из машиночитаемой схемы
yandex-direct-mcp
MCP-сервер и CLI на всех 113 методах API v5 Яндекс Директа, собранных из WSDL: по умолчанию только 9 читающих, запись включается явно