VK MCP: как подключить ВКонтакте к Claude, Cursor и Codex

bulatko/vk-mcp-server· Проверено 12.11.2026· 17на GitHub

Подключает агента к VK API: читать стены, профили и сообщества, публиковать посты и истории от имени сообщества, разбирать сообщения группы, товары и рекламные кампании.

2 реализации:

25 готовых инструментов: стена, сообщества, истории, входящие сообщества и его события; сам скрывает инструменты, до которых не дотягивается ваш токен.

Как подключить

Что сделать до подключения

Node.js с командой npx; для Claude Desktop есть файл .mcpb на странице релизов, Node.js тогда не нужен

Токен сообщества, которым вы управляете, и сервисный ключ своего приложения VK

VK_ACCESS_TOKEN

Сообщество → Управление → Работа с API → Ключи доступа → Создать ключ, отметить wall, photos, stories, messages и manage

VK_SERVICE_KEY

Сервисный ключ на странице настроек вашего приложения VK: через него идут чтения стены, в которых VK отказывает токену сообщества

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'VK_ACCESS_TOKEN=<токен сообщества>' --env 'VK_SERVICE_KEY=<сервисный ключ приложения>' --transport stdio vkontakte \
  -- npx -y vk-mcp-server

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.vkontakte]
command = "npx"
args = ["-y", "vk-mcp-server"]

[mcp_servers.vkontakte.env]
VK_ACCESS_TOKEN = "<токен сообщества>"
VK_SERVICE_KEY = "<сервисный ключ приложения>"

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "vkontakte": {
      "command": "npx",
      "args": ["-y", "vk-mcp-server"],
      "env": {
        "VK_ACCESS_TOKEN": "<токен сообщества>",
        "VK_SERVICE_KEY": "<сервисный ключ приложения>"
      }
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "vkontakte": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "vk-mcp-server"],
      "env": {
        "VK_ACCESS_TOKEN": "<токен сообщества>",
        "VK_SERVICE_KEY": "<сервисный ключ приложения>"
      }
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "vkontakte": {
      "command": "npx",
      "args": ["-y", "vk-mcp-server"],
      "env": {
        "VK_ACCESS_TOKEN": "<токен сообщества>",
        "VK_SERVICE_KEY": "<сервисный ключ приложения>"
      }
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "vkontakte": {
      "command": "npx",
      "args": ["-y", "vk-mcp-server"],
      "env": {
        "VK_ACCESS_TOKEN": "<токен сообщества>",
        "VK_SERVICE_KEY": "<сервисный ключ приложения>"
      }
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "vkontakte": {
        "type": "local",
        "command": ["npx", "-y", "vk-mcp-server"],
        "environment": {
          "VK_ACCESS_TOKEN": "<токен сообщества>",
          "VK_SERVICE_KEY": "<сервисный ключ приложения>"
        }
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "vkontakte": {
      "command": "npx",
      "args": ["-y", "vk-mcp-server"],
      "env": {
        "VK_ACCESS_TOKEN": "<токен сообщества>",
        "VK_SERVICE_KEY": "<сервисный ключ приложения>"
      }
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "vkontakte": {
      "command": "npx",
      "args": ["-y", "vk-mcp-server"],
      "env": {
        "VK_ACCESS_TOKEN": "<токен сообщества>",
        "VK_SERVICE_KEY": "<сервисный ключ приложения>"
      }
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

vk_users_getчитает профили пользователей

vk_wall_getчитает посты со стены

vk_wall_postпубликует пост

vk_wall_create_commentпишет комментарий к посту

vk_groups_get_by_idчитает данные сообщества

vk_groups_searchищет сообщества

vk_groups_get_membersчитает участников сообщества

vk_photos_getчитает фото из альбомов

vk_stories_post_photoпубликует фото-историю

vk_stories_post_videoпубликует видео-историю

vk_messages_get_conversationsпоказывает входящие сообщества

vk_messages_get_historyчитает переписку

vk_messages_sendотвечает от имени сообщества

vk_events_listenвключает приём событий сообщества

vk_events_getчитает новые комментарии и лайки

vk_stats_getчитает статистику сообщества

vk_token_infoпоказывает, что умеет токен

Показано 17 из 25.

373 метода VK API за тремя инструментами: агент ищет метод словами, читает его карточку и вызывает; есть товары магазина, реклама, лид-формы и заказы.

Как подключить

Что сделать до подключения

uv с командой uvx; для Claude Desktop есть файл .mcpb, ему нужен Python 3.10 или новее

VK_TOKEN

dev.vk.com → приложение → сервисный ключ доступа, либо токен сообщества с правами market, messages, ads, stats

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --env 'VK_TOKEN=<сервисный ключ или токен сообщества>' --transport stdio vk-mcp-ru \
  -- uvx vk-mcp-ru

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.vk-mcp-ru]
command = "uvx"
args = ["vk-mcp-ru"]

[mcp_servers.vk-mcp-ru.env]
VK_TOKEN = "<сервисный ключ или токен сообщества>"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "vk-mcp-ru": {
      "command": "uvx",
      "args": ["vk-mcp-ru"],
      "env": {
        "VK_TOKEN": "<сервисный ключ или токен сообщества>"
      }
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "vk-mcp-ru": {
      "type": "stdio",
      "command": "uvx",
      "args": ["vk-mcp-ru"],
      "env": {
        "VK_TOKEN": "<сервисный ключ или токен сообщества>"
      }
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "vk-mcp-ru": {
      "command": "uvx",
      "args": ["vk-mcp-ru"],
      "env": {
        "VK_TOKEN": "<сервисный ключ или токен сообщества>"
      }
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "vk-mcp-ru": {
      "command": "uvx",
      "args": ["vk-mcp-ru"],
      "env": {
        "VK_TOKEN": "<сервисный ключ или токен сообщества>"
      }
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "vk-mcp-ru": {
        "type": "local",
        "command": ["uvx", "vk-mcp-ru"],
        "environment": {
          "VK_TOKEN": "<сервисный ключ или токен сообщества>"
        }
      }
    }
  }
}

{
  "mcpServers": {
    "vk-mcp-ru": {
      "command": "uvx",
      "args": ["vk-mcp-ru"],
      "env": {
        "VK_TOKEN": "<сервисный ключ или токен сообщества>"
      }
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "vk-mcp-ru": {
      "command": "uvx",
      "args": ["vk-mcp-ru"],
      "env": {
        "VK_TOKEN": "<сервисный ключ или токен сообщества>"
      }
    }
  }
}

Инструменты сервера

vk_search_methodsищет метод VK API словами

vk_describe_methodпоказывает параметры метода

vk_call_methodвызывает метод

Что попросить агента

«Покажи 5 последних постов сообщества <адрес сообщества>»Агент вызовет vk_wall_get и выведет посты с просмотрами, лайками и репостами

«Насколько большое сообщество <адрес> и как заходят его свежие посты?»Агент узнает размер через vk_groups_get_by_id, прочитает стену через vk_wall_get и сравнит посты

«Разбери непрочитанные сообщения группы и предложи ответы»Агент найдёт непрочитанное через vk_messages_get_conversations, прочитает vk_messages_get_history и после вашего согласия ответит через vk_messages_send

«Сведи заказы и товары магазина сообщества <адрес> в таблицу»vk-mcp-ru найдёт методы заказов и товаров через vk_search_methods, уточнит параметры vk_describe_method и вызовет их через vk_call_method

Для каких задач

Собрать сводку по последним постам сообщества и найти, что набрало больше лайков и комментариев

Подготовить пост в тоне сообщества и опубликовать его после вашего согласия

Разобрать непрочитанные сообщения группы и набросать ответы

Отвечать на новые комментарии в цикле, пока работает сервер

Свести заказы и товары магазина сообщества в таблицу

Собрать расходы и показатели рекламных кампаний VK Ads

Ограничения

Новым приложениям VK больше не выдаёт полный пользовательский токен: правка и удаление постов, загрузка фото на стену, статистика, лайки, поиск и лента через доступные токены закрыты

Токен VK ID из --login только читает публичные профили, стены и сообщества: публикация и статистика отвечают error 1051

Сообщество пишет только тем, кто написал ему первым или разрешил сообщения; события VK не хранит, видно только то, что пришло, пока работает сервер

У vk-mcp-ru 3 звезды на GitHub: проект молодой и маленький

Если не работает

error 27: Group authorization failed

Токен сообщества попросил то, что VK ему не даёт, например чтение стены. Задайте VK_SERVICE_KEY: чтения пойдут через ключ, правка, удаление и статистика останутся закрыты.

error 8: Application is blocked

Заблокировано приложение VK, которое выдало токен: все его токены падают так же. Создайте своё приложение и выпустите новый токен.

error 5 с subcode 1130

VK привязал токен к IP, с которого вы входили, а сервер работает с другого, например с VPS. Получите токен на машине с сервером или возьмите токен сообщества.

No VK token configured на каждом инструменте

Клиент не передал VK_ACCESS_TOKEN серверу: проверьте блок env в конфиге клиента. Токен из вашего терминала до сервера, который запускает клиент, не доходит.

error 1051 или error 28

Токен VK ID или сервисный ключ вызвал закрытый для него метод. Для публикации нужен токен сообщества.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
VK MCP Server	bulatko	17	локально	токен	25	10 октября 2026
vk-mcp-ru	Илья Утов	3	локально	токен	3	5 октября 2026

Частые вопросы

Какой токен нужен, чтобы агент публиковал посты?

Токен сообщества: Управление → Работа с API → Ключи доступа → Создать ключ, с правами wall, photos, stories, messages и manage. Он не истекает и не привязан к браузеру или IP. Чтобы агент ещё и читал стены, добавьте рядом сервисный ключ приложения в VK_SERVICE_KEY.

Как узнать, что умеет мой токен?

Запустите VK_ACCESS_TOKEN=<токен> npx vk-mcp-server --check: команда определит тип токена (пользователь, сообщество или сервисный) и проверит, до чего он дотягивается, не вызывая методы записи. Внутри чата то же покажет инструмент vk_token_info.

Чем отличаются два сервера?

VK MCP Server даёт 25 готовых инструментов под стену, истории и сообщения сообщества. vk-mcp-ru открывает 373 метода VK API через поиск метода словами: там есть товары, реклама, лид-формы и заказы. Запись и необратимые действия vk-mcp-ru выполняет только после подтверждения.

Может ли агент отправить сообщение без спроса?

Инструменты, которые что-то меняют во ВКонтакте, помечены аннотациями readOnlyHint и destructiveHint, и клиент может спрашивать перед ними. В vk-mcp-ru чтение идёт сразу, а запись и необратимые методы требуют подтверждения.

Есть ли MCP для VK Ads?

В vk-mcp-ru есть раздел «Реклама» из 47 методов VK API: агент собирает расходы и показатели кампаний VK Ads. Нужен токен сообщества с правом ads.

Как подключить ВК MCP к Claude Code?

Добавьте сервер в .mcp.json проекта: command npx, args -y vk-mcp-server и токен в VK_ACCESS_TOKEN. Готовые конфиги для Claude Code, Cursor и Codex — во вкладках блока «Как подключить».

Работает ли сервер из России?

Оба сервера работают на вашем компьютере и ходят напрямую в api.vk.com: зарубежный аккаунт и оплата не нужны.

VK MCP: как подключить ВКонтакте к Claude, Cursor и Codex

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы