VK·ilyautov
VK MCP — подключение и инструкция
VK MCP RU подключает агента к VK API: товарам сообщества, постам, сообщениям и другим доступным методам.
Что умеет этот сервер
VK MCP RU подключает агента к VK API: товарам сообщества, постам, сообщениям и другим доступным методам.
Каталог методов строится по официальной API-схеме, но сервер остаётся community-проектом ilyautov.
Начни с чтения тестового сообщества и каталога товаров.
Задача для знакомства
Через VK MCP прочитай данные выбранного тестового сообщества. Посты, сообщения и рекламу не создавай.
Уточнить результат
Сверь токен, community ID и класс доступа метода. Doctor без live-вызова не подтверждает API-доступ; небольшой разрешённый read-тест проверяется отдельно.
Как подключить
Выберите подходящий способПодключить VK MCP
Для Claude Desktop можно установить .mcpb из Releases. В терминальном варианте добавь uvx vk-mcp-ru и VK_TOKEN в env. Команда uvx vk-mcp-ru doctor проверяет загрузку методов и доступов без печати секретов.
Что понадобится
- Python 3.10+, uv/uvx либо MCPB-совместимый Claude Desktop, VK token нужного типа.
- 01
Подготовь окружение
Python 3.10+, uv/uvx либо MCPB-совместимый Claude Desktop, VK token нужного типа.
- 02
Установи и настрой
Для Claude Desktop можно установить .mcpb из Releases. В терминальном варианте добавь uvx vk-mcp-ru и VK_TOKEN в env. Команда uvx vk-mcp-ru doctor проверяет загрузку методов и доступов без печати секретов.
- 03
Открой новую сессию
Убедись, что клиент видит инструменты именно этого сервера, и выполни первый небольшой сценарий.
Пример MCP-конфигурации на основе README
{
"mcpServers": {
"vk-mcp": {
"command": "uvx",
"args": [
"vk-mcp-ru"
],
"env": {
"VK_TOKEN": "..."
}
}
}
}Первый запрос — пример для чата агента
Через VK MCP прочитай данные выбранного тестового сообщества. Посты, сообщения и рекламу не создавай.Как проверить
Сверь токен, community ID и класс доступа метода. Doctor без live-вызова не подтверждает API-доступ; небольшой разрешённый read-тест проверяется отдельно.
Подставь собственные пути, адреса и доступы только в локальные настройки. Команды запуска, MCP-конфигурация и текст первого запроса вводятся в разных местах; их назначение указано над примером.
README и установка автораЧто умеет VK
VK MCP RU подключает агента к VK API: товарам сообщества, постам, сообщениям и другим доступным методам.
Каталог методов строится по официальной API-схеме, но сервер остаётся community-проектом ilyautov. Доступ к методам зависит от класса и прав токена.
Что подготовить перед подключением
Python 3.10+, uv/uvx либо MCPB-совместимый Claude Desktop, VK token нужного типа.
Как установить и подключить
Для Claude Desktop можно установить .mcpb из Releases. В терминальном варианте добавь uvx vk-mcp-ru и VK_TOKEN в env. Команда uvx vk-mcp-ru doctor проверяет загрузку методов и доступов без печати секретов.
Добавь выбранную запись в существующую конфигурацию клиента, сохранив остальные серверы. Формат и расположение настроек зависят от клиента: JSON-пример для Claude Desktop не нужно целиком вставлять в TOML-файл другого приложения. После изменения перечитай конфигурацию или открой новую сессию.
Как пользоваться: первый сценарий
Начни с чтения тестового сообщества и каталога товаров. Для поста, ответа или рекламы сначала уточни адресата и подготовь черновик действия.
Как проверить результат и решить проблемы
Сверь токен, community ID и класс доступа метода. Doctor без live-вызова не подтверждает API-доступ; небольшой разрешённый read-тест проверяется отдельно.
Если инструмент не появился, проверь запуск процесса или доступность endpoint, журнал клиента и права доступа. Если соединение есть, но операция не выполняется, сверяй входные параметры и ограничения сервиса; повторять изменяющий запрос без проверки результата не стоит.
Ограничения
VK user token и community token не взаимозаменяемы. Каталог методов не означает, что текущему токену разрешены все записи, сообщения и рекламные операции.
Исходники и документация
Репозиторий: ilyautov/vk-mcp-ru. В README доступны актуальные варианты установки, требования и примеры настройки. Перед обновлением сохрани рабочую конфигурацию и проверь изменения версии.
Другие подключения — в каталоге MCP-серверов Нейролюба.