vk-mcp-ru
VK API для ИИ-ассистентов: товары магазина сообщества, посты, рекламные кампании и статистика, диалоги с клиентами, лид-формы. Каталог из официальной схемы, у каждого метода класс доступа.
Каталог собран из первоисточника (официальная схема VKCOM/vk-api-schema) и лежит в репозитории как
vk_mcp/endpoints.yaml: 373 метода, из них 159 на чтение,
173 на запись и 41 необратимых. Сервер исполняет ровно этот файл,
поэтому таблица ниже не может разойтись с кодом.
Установка
Два пути, выбирайте по тому, есть ли у вас терминал.
Без терминала: файл .mcpb
Скачайте vk-mcp-ru-vX.Y.Z.mcpb со страницы релизов
и откройте двойным щелчком. Claude Desktop поставит сервер сам и спросит ключи
в отдельном окне, в конфиг лезть не придётся. Нужен Python 3.10 или новее:
зависимости сервер доставит себе при первом запуске.
В терминале
uvx vk-mcp-ru
Claude Desktop, claude_desktop_config.json:
{
"mcpServers": {
"vk-mcp": {
"command": "uvx",
"args": ["vk-mcp-ru"],
"env": { "VK_TOKEN": "..." }
}
}
}
Ключи
dev.vk.com → приложение → сервисный ключ доступа, либо токен сообщества с правами market, messages, ads, stats. Запрашивайте только те права, которые реально нужны.
| переменная | секрет | что это |
|---|
VK_TOKEN | да | Сервисный ключ приложения VK или токен сообщества с нужными правами. |
Ключи можно не держать в окружении: сервер умеет кабинеты и кладёт их в
~/.ru-mcp/cabinets.json с правами 600, вне репозитория.
Карта методов
| раздел | методов | чтение | запись | необратимое |
|---|
| Сообщества | 51 | 20 | 25 | 6 |
| Диалоги | 48 | 21 | 22 | 5 |
| Реклама | 47 | 24 | 16 | 7 |
| Товары и магазин | 45 | 16 | 23 | 6 |
| Фотографии | 44 | 18 | 22 | 4 |
| Видео | 34 | 9 | 20 | 5 |
| Записи на стене | 25 | 7 | 16 | 2 |
| Обсуждения | 13 | 2 | 9 | 2 |
| Документы | 12 | 7 | 4 | 1 |
| Вики-страницы | 8 | 4 | 4 | 0 |
| Лид-формы | 7 | 3 | 3 | 1 |
| Заказы | 7 | 5 | 2 | 0 |
| Утилиты | 7 | 6 | 0 | 1 |
| Карточки в записях | 6 | 3 | 2 | 1 |
| Пользователи | 5 | 4 | 1 | 0 |
| VK Donut | 4 | 4 | 0 | 0 |
| Статистика | 3 | 2 | 1 | 0 |
| Хранилище приложения | 3 | 2 | 1 | 0 |
| Уведомления | 3 | 1 | 2 | 0 |
| Подкасты | 1 | 1 | 0 | 0 |
| всего | 373 | 159 | 173 | 41 |
Как это выглядит в чате
Вы: посты на стене сообщества
vk_search_methods("посты на стене сообщества")
vk_wall_get POST /method/wall.get чтение
vk_wall_search POST /method/wall.search чтение
vk_wall_get_by_id POST /method/wall.getById чтение
vk_describe_method("vk_wall_get")
Returns a list of posts on a user wall or community wall.
POST api.vk.com/method/wall.get
параметры: domain, offset, count, filter, extended, fields
класс доступа: чтение
vk_call_method("vk_wall_get", {"domain": "...", "offset": "..."})
Три инструмента вместо 373 функций: агент ищет метод словами,
читает его карточку и вызывает. Запись и необратимое спрашивают подтверждение.
Что обычно просят:
- Свести заказы и товары магазина сообщества в таблицу.
- Посмотреть статистику сообщества и постов за период.
- Собрать расходы и показатели рекламных кампаний VK Ads.
- Разобрать непрочитанные диалоги и подготовить ответы на согласование.
Безопасность
Сервер работает на машине пользователя, ключи наружу не уходят. У методов три
класса доступа: чтение идёт сразу, запись и необратимые действия требуют
подтверждения. Заголовок авторизации не покидает домены сервиса даже при вызове
произвольного пути.
Проверить установку
uvx vk-mcp-ru doctor
Печатает, сколько методов загрузилось, найдены ли ключи и откуда. Секреты не
показывает. С --live делает один дешёвый реальный вызов на чтение.
Родня
Ядро вынесено в schema-mcp-core.
Соседние серверы: diadoc-mcp-ru, sbis-mcp-ru, chestny-znak-mcp-ru.
Маркетплейсы живут отдельно: marketplaces-mcp-ru.
MIT. Автор Илья Утов.
Все проекты одним списком, разобранные по назначению:
ilyautov.github.io.
Privacy Policy
vk-mcp-ru не собирает и не передаёт ваши данные: ключи лежат локально в
~/.ru-mcp/cabinets.json, запросы идут только в API VK, телеметрии нет.
Полный текст: PRIVACY_POLICY.md.
