VK API MCP (RU) — товары, сообщества, реклама

vk-mcp-ru

AI アシスタント向け VK API：コミュニティのショップ商品、投稿、広告キャンペーンと統計、顧客との会話、リードフォーム。公式スキーマから作成したカタログで、各メソッドにアクセス区分があります。

カタログは一次資料（公式スキーマ VKCOM/vk-api-schema）から作成され、リポジトリ内の vk_mcp/endpoints.yaml に格納されています。373 メソッドの内訳は、読み取りが159、 書き込みが173、取り消し不能な操作が41です。サーバーはこのファイルだけを実行するため、 以下の表がコードと食い違うことはありません。

インストール

方法は2つあります。ターミナルが使えるかどうかに応じて選んでください。

ターミナルなし：.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.