VK MCP Server
MCP-сервер для API ВКонтакте: профили, стены, сообщества, фото, лайки и статистика, публикация постов с подтверждением
Установка
{
"mcpServers": {
"vk": {
"command": "npx",
"args": ["-y", "vk-mcp-server"],
"env": {
"VK_ACCESS_TOKEN": "your_access_token_here"
}
}
}
}Файл .mcp.json проекта. Тот же блок подходит для claude_desktop_config.json.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту 19 инструментов для ВКонтакте: поиск и чтение профилей, записи со стен, информация о сообществах и их участниках, фотоальбомы, друзья, лента, лайки и статистика сообщества. Инструменты записи публикуют, редактируют и удаляют посты, оставляют комментарии, загружают фото и вступают в сообщества, они помечены аннотациями, чтобы клиент спрашивал подтверждение. Готовые промпты делают дайджест сообщества, отчет по вовлеченности, портрет аудитории и черновик поста в тоне сообщества. Команда --check определяет тип токена и проверяет, какие методы ему доступны, а в клиентах с поддержкой MCP Apps стены и профили показываются карточками.
Для кого. Для SMM-специалистов и маркетологов, которые ведут и анализируют сообщества ВКонтакте.
Подходит, если
- Нужно понять, какие посты сообщества собрали больше всего реакций
- Нужно подготовить и опубликовать пост в своем сообществе
- Нужно найти и сравнить сообщества по теме
Не подходит, если
- Нужны личные сообщения или массовые рассылки
- Нужна полная статистика и публикация, а есть только токен VK ID
Пример запроса к агенту
Сделай отчет по вовлеченности за последние 30 постов нашего сообщества и объясни, что общего у самых удачныхОграничения
Возможности зависят от типа токена. Токен VK ID из команды --login читает только публичные профили, стены и сообщества, публикация, фото, друзья, лента и статистика вернут ошибку 1051. Для записи нужен токен сообщества с правами wall и photos. Пользовательские токены VK ограничивает несколькими запросами в секунду и может привязать к IP.
Как отключить. Удалите блок vk из конфигурации MCP клиента или расширение в Claude Desktop и отзовите токен в настройках сообщества.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| VK_ACCESS_TOKEN обязательная, секрет | Токен API ВКонтакте: сообщества, пользователя или сервисный |
| VK_TIMEOUT_MS | Таймаут запроса в миллисекундах, по умолчанию 30000 |
| VK_API_BASE | Базовый адрес API, по умолчанию https://api.vk.com/method |
Проверка безопасности
- Публикует, редактирует и удаляет посты от имени сообщества или пользователя
- Хранит бессрочный токен сообщества
Коротко о README
README описывает установку в один клик через .mcpb для Claude Desktop и кнопку для VS Code, запуск через npx и публикацию в официальном реестре MCP. Подробно разобраны три типа токенов VK и что каждый умеет, приведены конфигурации для Claude Desktop и Claude Code и переменные окружения. Есть таблица типичных ошибок VK с решениями, список инструментов с пометками записи и готовые промпты. Лицензия MIT.
Частые вопросы
Какой токен выбрать?
Для публикации нужен токен сообщества: Управление, Работа с API, Ключи доступа. Для чтения публичных данных хватит токена VK ID или сервисного ключа.
Что значит ошибка 5 с подкодом 1130?
VK привязал токен к IP, с которого его выдали. Получите токен на машине, где работает сервер, или используйте токен сообщества.
Похожие
Marketing Skills: маркетинговые скиллы для агентов
Marketing Skills for AI Agents
Около пятидесяти скиллов по CRO, копирайтингу, SEO, аналитике, рекламе и запуску продукта для кодовых агентов
Скилл, который убирает из текста приметы ИИ-письма по списку Википедии и не добавляет выдуманных фактов
Скиллы для контента: иллюстрации к статьям, обложки, инфографика, комиксы, перевод, конвертация URL в Markdown и публикация в соцсети
Китайская версия скилла Humanizer: находит и убирает приметы AI-текста в материалах на китайском