{
  "markdown": "# vk-mcp-ru\n\n<!-- mcp-name: io.github.ilyautov/vk-mcp-ru -->\n\nVK API для ИИ-ассистентов: товары магазина сообщества, посты, рекламные кампании и статистика, диалоги с клиентами, лид-формы. Каталог из официальной схемы, у каждого метода класс доступа.\n\n[![PyPI](https://img.shields.io/pypi/v/vk-mcp-ru?label=pypi&color=B5491F)](https://pypi.org/project/vk-mcp-ru/)\n[![CI](https://github.com/ilyautov/vk-mcp-ru/actions/workflows/ci.yml/badge.svg)](https://github.com/ilyautov/vk-mcp-ru/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n[![Методов](https://img.shields.io/badge/%D0%BC%D0%B5%D1%82%D0%BE%D0%B4%D0%B0-373-2D7D4F)](#карта-методов)\n[![Сайт](https://img.shields.io/badge/%D1%81%D0%B0%D0%B9%D1%82-business--mcp--ru-9A3E1A)](https://business-mcp-ru.aifrontier.tech/vk-api.html)\n[![Звёзды](https://img.shields.io/github/stars/ilyautov/vk-mcp-ru?style=flat&label=%D0%B7%D0%B2%D1%91%D0%B7%D0%B4%D1%8B&color=B5491F&logo=github&logoColor=white)](https://github.com/ilyautov/vk-mcp-ru/stargazers)\n\n[![Install in VS Code](https://img.shields.io/badge/VS_Code-%D0%BF%D0%BE%D1%81%D1%82%D0%B0%D0%B2%D0%B8%D1%82%D1%8C-0098FF?logo=visualstudiocode&logoColor=white)](https://vscode.dev/redirect/mcp/install?name=vk&config=%7B%22command%22%3A%20%22uvx%22%2C%20%22args%22%3A%20%5B%22vk-mcp-ru%22%5D%2C%20%22env%22%3A%20%7B%22VK_TOKEN%22%3A%20%22%24%7Binput%3Avk_token%7D%22%7D%7D&inputs=%5B%7B%22id%22%3A%20%22vk_token%22%2C%20%22type%22%3A%20%22promptString%22%2C%20%22description%22%3A%20%22%D0%A1%D0%B5%D1%80%D0%B2%D0%B8%D1%81%D0%BD%D1%8B%D0%B9%20%D0%BA%D0%BB%D1%8E%D1%87%20%D0%BF%D1%80%D0%B8%D0%BB%D0%BE%D0%B6%D0%B5%D0%BD%D0%B8%D1%8F%20VK%20%D0%B8%D0%BB%D0%B8%20%D1%82%D0%BE%D0%BA%D0%B5%D0%BD%20%D1%81%D0%BE%D0%BE%D0%B1%D1%89%D0%B5%D1%81%D1%82%D0%B2%D0%B0%20%D1%81%20%D0%BD%D1%83%D0%B6%D0%BD%D1%8B%D0%BC%D0%B8%20%D0%BF%D1%80%D0%B0%D0%B2%D0%B0%D0%BC%D0%B8.%22%2C%20%22password%22%3A%20true%7D%5D)\n[![Install in Cursor](https://img.shields.io/badge/Cursor-%D0%BF%D0%BE%D1%81%D1%82%D0%B0%D0%B2%D0%B8%D1%82%D1%8C-000000?logo=cursor&logoColor=white)](https://cursor.com/en/install-mcp?name=vk&config=eyJjb21tYW5kIjogInV2eCIsICJhcmdzIjogWyJ2ay1tY3AtcnUiXSwgImVudiI6IHsiVktfVE9LRU4iOiAiIn19)\n\n<p align=\"center\">\n  <a href=\"https://business-mcp-ru.aifrontier.tech/\">\n    <img src=\"assets/social-preview.png\" alt=\"vk-mcp-ru: VK API в ИИ-ассистенте. 373 метода, поиск метода словами, гейт безопасности перед записью\" width=\"760\">\n  </a>\n</p>\n\nКаталог собран из первоисточника (официальная схема `VKCOM/vk-api-schema`) и лежит в репозитории как\n`vk_mcp/endpoints.yaml`: **373 метода**, из них 159 на чтение,\n173 на запись и 41 необратимых. Сервер исполняет ровно этот файл,\nпоэтому таблица ниже не может разойтись с кодом.\n\n## Установка\n\n```bash\nuvx vk-mcp-ru\n```\n\nClaude Desktop, `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"vk-mcp\": {\n      \"command\": \"uvx\",\n      \"args\": [\"vk-mcp-ru\"],\n      \"env\": { \"VK_TOKEN\": \"...\" }\n    }\n  }\n}\n```\n\n## Ключи\n\ndev.vk.com → приложение → сервисный ключ доступа, либо токен сообщества с правами market, messages, ads, stats. Запрашивайте только те права, которые реально нужны.\n\n| переменная | секрет | что это |\n|---|---|---|\n| `VK_TOKEN` | да | Сервисный ключ приложения VK или токен сообщества с нужными правами. |\n\nКлючи можно не держать в окружении: сервер умеет кабинеты и кладёт их в\n`~/.ru-mcp/cabinets.json` с правами 600, вне репозитория.\n\n## Карта методов\n\n| раздел | методов | чтение | запись | необратимое |\n|---|---|---|---|---|\n| Сообщества | 51 | 20 | 25 | 6 |\n| Диалоги | 48 | 21 | 22 | 5 |\n| Реклама | 47 | 24 | 16 | 7 |\n| Товары и магазин | 45 | 16 | 23 | 6 |\n| Фотографии | 44 | 18 | 22 | 4 |\n| Видео | 34 | 9 | 20 | 5 |\n| Записи на стене | 25 | 7 | 16 | 2 |\n| Обсуждения | 13 | 2 | 9 | 2 |\n| Документы | 12 | 7 | 4 | 1 |\n| Вики-страницы | 8 | 4 | 4 | 0 |\n| Лид-формы | 7 | 3 | 3 | 1 |\n| Заказы | 7 | 5 | 2 | 0 |\n| Утилиты | 7 | 6 | 0 | 1 |\n| Карточки в записях | 6 | 3 | 2 | 1 |\n| Пользователи | 5 | 4 | 1 | 0 |\n| VK Donut | 4 | 4 | 0 | 0 |\n| Статистика | 3 | 2 | 1 | 0 |\n| Хранилище приложения | 3 | 2 | 1 | 0 |\n| Уведомления | 3 | 1 | 2 | 0 |\n| Подкасты | 1 | 1 | 0 | 0 |\n| **всего** | **373** | **159** | **173** | **41** |\n\n## Как это выглядит в чате\n\nВы: посты на стене сообщества\n\n```\nvk_search_methods(\"посты на стене сообщества\")\n  vk_wall_get        POST /method/wall.get      чтение\n  vk_wall_search     POST /method/wall.search   чтение\n  vk_wall_get_by_id  POST /method/wall.getById  чтение\n\nvk_describe_method(\"vk_wall_get\")\n  Returns a list of posts on a user wall or community wall.\n  POST api.vk.com/method/wall.get\n  параметры: domain, offset, count, filter, extended, fields\n  класс доступа: чтение\n\nvk_call_method(\"vk_wall_get\", {\"domain\": \"...\", \"offset\": \"...\"})\n```\n\nТри инструмента вместо 373 функций: агент ищет метод словами,\nчитает его карточку и вызывает. Запись и необратимое спрашивают подтверждение.\n\nЧто обычно просят:\n\n- Свести заказы и товары магазина сообщества в таблицу.\n- Посмотреть статистику сообщества и постов за период.\n- Собрать расходы и показатели рекламных кампаний VK Ads.\n- Разобрать непрочитанные диалоги и подготовить ответы на согласование.\n\n## Безопасность\n\nСервер работает на машине пользователя, ключи наружу не уходят. У методов три\nкласса доступа: чтение идёт сразу, запись и необратимые действия требуют\nподтверждения. Заголовок авторизации не покидает домены сервиса даже при вызове\nпроизвольного пути.\n\n## Проверить установку\n\n```bash\nuvx vk-mcp-ru doctor\n```\n\nПечатает, сколько методов загрузилось, найдены ли ключи и откуда. Секреты не\nпоказывает. С `--live` делает один дешёвый реальный вызов на чтение.\n\n## Родня\n\nЯдро вынесено в [schema-mcp-core](https://github.com/ilyautov/schema-mcp-core).\nСоседние серверы: [hh-mcp-ru](https://github.com/ilyautov/hh-mcp-ru), [diadoc-mcp-ru](https://github.com/ilyautov/diadoc-mcp-ru), [sbis-mcp-ru](https://github.com/ilyautov/sbis-mcp-ru), [chestny-znak-mcp-ru](https://github.com/ilyautov/chestny-znak-mcp-ru).\nМаркетплейсы живут отдельно: [marketplaces-mcp-ru](https://github.com/ilyautov/marketplaces-mcp-ru).\n\nMIT. Автор [Илья Утов](https://github.com/ilyautov).\n\nВсе проекты одним списком, разобранные по назначению:\n[ilyautov.github.io](https://ilyautov.github.io/).\n",
  "bytes": 6293,
  "sha": "891e74f59c67d7cc647dc892cafa48519167a4a6cff679026e5f02d46cdf6ff1",
  "repo_slug": "ilyautov/vk-mcp-ru",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_ilyautov_vk_mcp_ru_5f4ca4ae/readme"
}