Стандарты разработки 1С под рукой у ИИ-помощника: сайт v8std.ru и бесплатный MCP-сервер

от автора

Проблема, с которой сталкивается почти каждый

Стандарты разработки 1С — вещь полезная, но неудобная в повседневной работе.

Их много: больше трёхсот отдельных стандартов. Они лежат на ИТС. Формулировки написаны так, что читать их приятно один раз, а искать в них конкретное правило под конкретную строку кода — мучительно.

Дальше становится хуже. Вы прогнали конфигурацию через АПК и получили список кодов вроде acc:1245. Или BSL Language Server подсветил AssignAliasFieldsInQuery. Или EDT с плагином v8-code-style выдал common-module-name-client-server. И вот у вас есть код предупреждения, а нужен пункт стандарта, который объясняет, почему так делать нельзя, — потому что без этого объяснения правка превращается в «замолчи, линтер».

А теперь добавьте сюда ИИ-помощника. Cursor, Claude Code, Codex, Copilot — кто чем пользуется. Он бодро пишет код на BSL и так же бодро ссылается на «стандарт 512», которого не существует, или пересказывает правило по памяти в редакции трёхлетней давности. Помощник не виноват: у него просто нет источника.

Об этом и статья — про два бесплатных инструмента, которые закрывают обе дырки. 

Что такое v8std.ru

v8std.ru — открытый сайт со стандартами разработки 1С, адаптированными для чтения и, главное, для поиска.

Что там лежит сейчас:

  • 318 стандартов — тексты переработаны так, чтобы правило читалось за минуту, а не за десять;

  • 691 диагностика АПК — Автоматической проверки конфигурации, той самой, через которую проходят на «1С:Совместимо»;

  • 186 диагностик BSL Language Server;

  • 172 проверки EDT v8-code-style;

  • 34 автозамены — правила обработки «Автоформатирование кода и локализация» с ИТС, разложенные по 15 стандартам;

  • разделы про паттерны проектирования (GoF, GRASP, SOLID) и особенности встроенного языка.

Но главная ценность не в объёме, а в связях. Каждая диагностика привязана не просто к стандарту, а к конкретному пункту стандарта.

Откройте #std437 «Оформление текстов запросов». Пункт 1 про заглавные ключевые слова помечен чипом acc:254 — это диагностика АПК, которая его проверяет, — и чипом autoformat, потому что это правило умеет чинить автоформатирование. Пункт 2 про псевдонимы полей помечен bslls:AssignAliasFieldsInQuery.

Работает и в обратную сторону: с любой страницы диагностики есть переход к пункту стандарта, который объясняет причину. Это ровно тот маршрут, которого не хватает, когда разбираешь отчёт линтера.

Поиск на сайте понимает четыре формата запроса:

Что ищем

Как пишем

Стандарт

#std437std 437стандарт 437

Диагностику BSLLS   

bslls:AssignAliasFieldsInQuery или просто AssignAliasFieldsInQuery

Диагностику АПК

acc:1245апк 1245ACC 1245

Тему по-русски

транзакцииобщие модулиправа

Плюс мелочи, которые экономят нервы: раскладка клавиатуры распознаётся (набрали nhfypfrwbb — найдутся транзакции), опечатки в кодах диагностик прощаются.

Исходные стандарты остаются на ИТС — v8std не заменяет первоисточник, а делает его пригодным для ежедневной работы. 

Теперь про MCP

MCP (Model Context Protocol) — это стандартный способ дать ИИ-помощнику доступ к внешнему источнику данных. Помощник узнаёт, что у него появились новые методы, и сам решает, когда их вызвать.

Если вы не работали с такими штуками, представьте это так: у ИИ появился справочник, в который он может заглянуть сам, без вашей просьбы. Вы спрашиваете по-русски — он в фоне лезет в v8std и отвечает со ссылкой на реальный стандарт, а не по памяти.

Публичный сервер живёт по адресу:

https://ai.v8std.ru/mcp

Без ключа, без регистрации, без лимитов по подписке.

Что именно умеет сервер

Пять методов, все — только на чтение.

v8std_search — поиск по стандартам, диагностикам и материалам сайта. Понимает обычную фразу («локализация интерфейсных текстов»), номер стандарта (std437) и код диагностики (acc:1245).

v8std_get_page — полный текст найденной страницы в чистом Markdown. Вызывается, когда помощнику мало сниппета из поиска и нужно прочитать сам стандарт.

v8std_get_related — связанные страницы. От стандарта — к диагностикам анализаторов, от диагностики — к пункту стандарта.

v8std_explain_snippet — подбор стандартов по короткому фрагменту кода 1С. Помощник отдаёт кусок BSL или SDBL, получает список применимых правил и вероятных диагностик. Метод срабатывает на характерные конструкции: ВЫБРАТЬ РАЗРЕШЕННЫЕОткрытьФормуМодальноПредупреждениеВопрос.

v8std_explain_diagnostics — разбор списка кодов после проверки проекта. Скармливаете отчёт АПК, BSLLS или EDT — получаете сгруппированные описания с привязкой к пунктам стандартов.

Отдельно подчеркну, чего сервер не делает: он не запускает анализаторы, не лезет в вашу конфигурацию и не меняет код. Это справочник, а не линтер.

Как это выглядит в работе

Типовой диалог с подключённым MCP:

Вы: Почему нельзя использовать модальные окна?

Помощник вызывает v8std_search с запросом «модальные окна», находит bslls:UsingModalWindows и #std703, затем через v8std_get_page читает полный текст. В ответе — объяснение про веб-клиент и список запрещённых методов глобального контекста, со ссылкой на источник.

Или так:

Вы: Вот кусок кода из формы, какие стандарты он нарушает?

Помощник отправляет фрагмент в v8std_explain_snippet, получает список правил и разбирает код по пунктам — не «мне кажется, тут нехорошо», а «пункт 2 стандарта 437, полю не присвоен псевдоним».

Или так — мой любимый сценарий:

Вы: Разбери отчёт АПК, вот коды: 1245, 254, 1407, 68.

v8std_explain_diagnostics возвращает описания и связанные пункты стандартов. Помощник группирует их по темам и объясняет, какие правки действительно нужны, а какие — вопрос вкуса.

Кто и зачем этим пользуется

По ролям это выглядит примерно так.

Разработчик — спрашивает правило в момент написания кода, не переключаясь в браузер и не разлогиниваясь из контекста задачи.

Ревьюер и тимлид — прогоняет диф через помощника с MCP и получает замечания со ссылками на пункты стандартов. Спор «мне так не нравится» превращается в «вот пункт, вот диагностика, которая это ловит». Заметно снижает температуру обсуждения.

Тот, кто готовит конфигурацию к «1С:Совместимо» — берёт отчёт АПК на несколько сотен строк и разбирает его пачками через v8std_explain_diagnostics, а не по одному коду в поиске ИТС.

Новичок в команде — задаёт вопросы своими словами, без знания номеров стандартов и кодов диагностик, и получает ответы с маршрутом к первоисточнику.

Сам ИИ-помощник — перестаёт выдумывать стандарты. Это, пожалуй, главный эффект: не «помощник стал умнее», а «помощник перестал врать с уверенным лицом».

Подключиться может любой клиент с поддержкой MCP по Streamable HTTP: Claude Code, Cursor, Codex, Kiro, Antigravity, плагины для JetBrains и VS Code.

Подключение

Для Claude Code — одна команда:

claude mcp add --transport http v8std https://ai.v8std.ru/mcp

Для Codex:

codex mcp add v8std --url https://ai.v8std.ru/mcp

Для Cursor — файл .cursor/mcp.json в проекте или ~/.cursor/mcp.json для всех проектов:

{  "mcpServers": {    "v8std": {      "url": "https://ai.v8std.ru/mcp"    }  }}

Для Kiro — тот же JSON в .kiro/settings/mcp.json. Для Antigravity — в mcp_config.json, только поле называется serverUrl.

Инструкции по всем клиентам собраны на странице v8std.ru/mcp.

Про закрытый код: поднимаем MCP локально

Публичный сервис видит текст запросов, которые отправляет ваш помощник. Отправлять туда фрагменты закрытого проекта, коммерческие данные и внутренние наработки — плохая идея.

Для таких случаев MCP поднимается локально одной командой:

docker compose -f docker-compose/docker-compose.yml up -d v8std-mcp

Дальше сервер доступен на http://127.0.0.1:8765/mcp, читает локальный индекс из репозитория и работает полностью автономно — без интернета. Подключается точно так же, только адрес другой.

Это же решение подходит, если вы работаете в закрытом контуре или хотите проверить изменения сайта до публикации.

Всё это бесплатно. По-настоящему

Обычно в этом месте начинается «бесплатно, но». Здесь — нет.

  • Сайт открыт, без регистрации и подписки.

  • Публичный MCP работает без ключа, токена и лимитов.

  • Контент опубликован под CC0 — это общественное достояние. Берите тексты, встраивайте в свои инструменты, публикуйте у себя, используйте коммерчески. Разрешения не нужны.

  • Исходники целиком лежат на GitHub: github.com/zeegin/v8std. И сайт, и MCP-сервер.

  • Локальный запуск — тот же код, тот же индекс, никакой урезанной версии.

Отдельно для тех, кто строит свои инструменты: сайт публикует машиночитаемые артефакты.

Файл

Что внутри

/llms.txt

Компактная карта сайта для LLM

/llms-full.txt

Полный корпус в чистом Markdown

/ai/pages.jsonl   

JSONL-индекс страниц, алиасов и связей

Плюс у любой публичной страницы есть Markdown-версия по исходному пути: HTML https://v8std.ru/std/437/ → Markdown https://v8std.ru/std/437.md. Удобно, если хочется затащить корпус в свой RAG или собрать собственный набор правил для код-ревью. 

Что дальше

Если хочется подтягивать стандарты понемногу, а не залпом: в Telegram-канале @v8std по понедельникам, средам и пятницам выходит один стандарт с короткой выжимкой. Три раза в неделю встраивается в рабочий ритм и не бросается через неделю.

Если нашли ошибку в тексте или хотите улучшить формулировку — на каждой странице есть иконка редактирования, ведущая прямо в GitHub. Pull Request принимаются, issues читаются.


Короткая версия для тех, кто листал по диагонали:

  1. v8std.ru — стандарты 1С со связями «диагностика ↔ пункт стандарта» и нормальным поиском.

  2. https://ai.v8std.ru/mcp — MCP-сервер, после подключения ИИ-помощник отвечает по стандартам со ссылками, а не по памяти.

  3. Одна команда для Claude Code: claude mcp add --transport http v8std https://ai.v8std.ru/mcp

  4. Для закрытого кода — локальный MCP через Docker.

  5. Всё бесплатно, контент под CC0, исходники на GitHub.

ссылка на оригинал статьи https://habr.com/ru/articles/1068094/