MCP-серверы для российских деловых сервисов

MCP-серверы для российских деловых сервисов: VK, Диадок, СБИС и Честный знак. 565 методов в каталоге, у каждого описание и класс доступа. Ставится двойным щелчком или одной командой.

Ставится двумя способами: файлом .mcpb двойным щелчком, без терминала, или одной командой в терминале. Ссылки на бандлы в таблице ниже.

uvx vk-mcp-ru

Четыре сервиса

Что где лежит

Таблица собрана из тех же каталогов, которые серверы исполняют в рантайме, поэтому разойтись с кодом она не может. Класс доступа определяет поведение: чтение идёт сразу, запись и необратимые действия требуют подтверждения.

Рядом живёт второй набор, под маркетплейсы: Wildberries, Ozon, Яндекс Маркет и Авито, ещё 1022 метода. Вместе это 1587 методов российских деловых API, разложенных одинаково.

Зачем каталог, если есть OpenAPI

Обычный путь это одна функция на эндпоинт. На 565 методах он ломается: описания занимают контекст, модель начинает путать похожие методы, а стоимость запроса растёт на каждом вызове, даже когда нужен один метод из пятисот.

Здесь каталог лежит файлом рядом с сервером, а инструментов всегда 18, сколько бы методов в каталоге ни было. Агент сначала ищет метод словами, потом читает его карточку, потом вызывает. Это три шага вместо одного, зато они не зависят от размера API. Чтение, запись и удаление разведены по разным инструментам, поэтому чтение идёт без подтверждения, а запись без него не уходит.

vk_search_methods("статистика сообщества") поиск словами, не по имени эндпоинта
vk_describe_method(...)                    параметры, пагинация, класс доступа
vk_call_method(...)                        чтение: идёт сразу, без подтверждения
vk_write_method(...)                       запись: нужен confirm_write
vk_delete_method(...)                      удаление: нужны оба подтверждения

Что нужно, чтобы начать

Установка одинаковая везде, а вот доступ у сервисов стоит по-разному. Это первое, обо что спотыкаются, поэтому вот честный порядок от простого к сложному.

Безопасность

Сервер работает на машине пользователя, ключи наружу не уходят. Их можно не держать в переменных окружения: кабинеты кладут ключи в ~/.ru-mcp/cabinets.json с правами 600, вне репозитория, и ни один инструмент их не возвращает.

У каждого сервера свой список разрешённых доменов, и заголовок авторизации не покидает домен сервиса даже при вызове произвольного пути. Класс доступа проставлен в каталоге, а не угадывается по HTTP-глаголу: у VK все методы идут через POST, у СБИС тоже, и глагол там не говорит о намерении ничего.

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

Чем это отличается от обёртки над OpenAPI?

Обёртка отдаёт агенту сотни функций и надеется, что он разберётся. Здесь методы лежат каталогом: поиск словами, у каждого метода описание, пагинация и класс доступа. Перед записью агент обязан спросить.

Почему восемнадцать инструментов, а не по одному на метод?

Потому что 565 описаний не помещаются в контекст и мешают модели думать. Сервер показывает 18 инструментов независимо от размера каталога: поиск метода, карточка метода, отдельно чтение, запись и удаление, работа с произвольным путём, карта разделов и кабинеты. Каталог при этом остаётся полным.

Ключи уходят куда-то на сервер?

Нет. Сервер работает на машине пользователя, ключи лежат локально с правами 600. У каждого сервера список разрешённых доменов, и заголовок авторизации не покидает домен сервиса даже при вызове произвольного пути.

Что мешает агенту удалить что-нибудь важное?

Класс доступа у каждого метода. Чтение идёт сразу, запись и необратимые действия требуют явного подтверждения. Классы проставлены в каталоге, а не угадываются по HTTP-глаголу: у VK и СБИС через POST идёт и чтение тоже.

Нужен ли программист, чтобы это поставить?

Нужна одна команда и ключ сервиса. Сложность не в установке, а в получении доступа: у VK ключ выдаётся сразу, у Диадока нужна лицензия, у Честного знака электронная подпись.

Почему у Честного знака методы помечены непроверенными?

Машиночитаемой спеки у ЦРПТ нет, поэтому пути взяты из открытых SDK, а не сгенерированы автоматически. Документация открыта на docs.crpt.ru, сверить есть с чем, и сервер честно показывает статус вместо догадки.

Можно поставить только один сервис?

Так и задумано. Каждый сервис это отдельный пакет и отдельная команда установки: для работы с документами не нужен каталог маркировки. Общее у них только ядро, и оно вынесено в отдельный пакет.

Где серверы для маркетплейсов?

Wildberries, Ozon, Яндекс Маркет и Авито живут отдельным набором на marketplaces-mcp-ru.aifrontier.tech, там ещё 1022 метода. Устроены так же, каталогом и тремя инструментами. По одному маркетплейсу ставятся отдельные пакеты: ozon-mcp-ru, wildberries-mcp-ru, yandex-market-mcp-ru, avito-mcp-ru.

С какими клиентами это работает?

С любым, который умеет MCP по stdio: Claude Desktop, Claude Code, Cursor, VS Code, Codex. Настройка это одна команда и переменные окружения.

Сколько это стоит?

Серверы бесплатны, лицензия MIT, исходники открыты. Платить может потребоваться самому сервису: у Диадока лицензия, у Честного знака электронная подпись.