business-mcp-ru → VK API в ИИ-ассистенте

VK API в ИИ-ассистенте

MCP-сервер для VK API: 373 метода по бизнес-разделам. Товары магазина сообщества, посты, рекламные кампании и статистика, диалоги с клиентами, лид-формы.

Установка

uvx vk-mcp-ru

Переменные окружения: VK_TOKEN. Ключи можно не держать в окружении: у сервера есть инструменты управления кабинетами, они кладут ключи в локальный файл с правами 600.

Где взять ключ

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

Карта методов: 373 метода

Таблица собрана из того же каталога, который сервер исполняет в рантайме (источник: официальная схема VKCOM/vk-api-schema). Класс доступа определяет поведение: чтение идёт сразу, запись и необратимые действия требуют подтверждения.

Раздел	Методов	Чтение	Запись	Необратимое
Сообщества	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 Ads.
Разобрать непрочитанные диалоги и подготовить ответы на согласование.

Как это работает в чате

vk_search_methods("...")   поиск метода словами, а не по имени эндпоинта
vk_describe_method(...)   параметры, пагинация, класс доступа
vk_call_method(...)       вызов; запись спрашивает подтверждение

Частые ошибки и что они значат

Пришёл HTTP 200, а данных нет

У VK ошибка лежит в теле ответа, а не в HTTP-коде: успешный запрос к серверу и неуспешный вызов метода это разные вещи. Смотрите объект error в ответе, там есть код и текст.

Метод отвечает иначе, чем в документации

Скорее всего дело в версии API. Сервер пинует v=5.199, и это осознанно: старая версия не ругается, а молча отдаёт другой формат ответа. Если сверяете с примером из интернета, сверьте и версию, под которую он написан.

Кажется, что любой вызов это запись

Не кажется, но и не так. Все 373 метода VK идут через POST, поэтому HTTP-глагол тут ничего не говорит о намерении. Класс доступа в каталоге проставлен по смыслу метода, и гейт подтверждения работает именно по нему, а не по глаголу.

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

Как получить токен VK API?

dev.vk.com, создать приложение и взять сервисный ключ доступа, либо выпустить токен сообщества. Права запрашивайте точечно: market для товаров, messages для диалогов, ads для рекламы, stats для статистики.

Чем сервисный ключ отличается от токена сообщества?

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

Где документация VK API?

dev.vk.com/method, а машиночитаемая схема лежит в репозитории VKCOM/vk-api-schema. Каталог собран из этой схемы, поэтому список методов не расходится с тем, что сервер умеет вызывать.

Сколько методов VK поддерживает vk-mcp-ru?

373, сгруппированных по деловым разделам: товары и магазин, сообщества, реклама, диалоги, статистика, лид-формы. Агент ищет метод словами, а не листает список.