VK·ilyautov

VK MCP — подключение и инструкция

VK MCP RU подключает агента к VK API: товарам сообщества, постам, сообщениям и другим доступным методам.

Рабочие сервисыЛокальноAPI-ключ

Что умеет этот сервер

01

VK MCP RU подключает агента к VK API: товарам сообщества, постам, сообщениям и другим доступным методам.

02

Каталог методов строится по официальной API-схеме, но сервер остаётся community-проектом ilyautov.

03

Начни с чтения тестового сообщества и каталога товаров.

Задача для знакомства

Через 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 нужного типа.
  1. 01

    Подготовь окружение

    Python 3.10+, uv/uvx либо MCPB-совместимый Claude Desktop, VK token нужного типа.

  2. 02

    Установи и настрой

    Для Claude Desktop можно установить .mcpb из Releases. В терминальном варианте добавь uvx vk-mcp-ru и VK_TOKEN в env. Команда uvx vk-mcp-ru doctor проверяет загрузку методов и доступов без печати секретов.

  3. 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-серверов Нейролюба.

Вопросы о VK

VK MCP RU подключает агента к VK API: товарам сообщества, постам, сообщениям и другим доступным методам.
Вернуться в библиотеку