MCP серверы для 1С

MCP-серверы (Model Context Protocol) — это набор Docker-контейнеров, которые расширяют возможности ИИ и позволяют ему работать с 1С так же, как опытный программист. ИИ начинает понимать код, метаданные, справку, бизнес-логику и конфигурации 1С.

Зачем нужны MCP-серверы?

При работе с ИИ-ассистентами (Cursor, Claude и др.) в контексте разработки на 1С возникает проблема: ИИ не знает специфику платформы 1С, не имеет доступа к справке вашей версии платформы и не понимает структуру вашей конфигурации.

MCP-серверы решают эту проблему, предоставляя ИИ:

• Доступ к справке платформы 1С вашей версии

• Поиск по метаданным конфигурации

• Поиск по Библиотеке стандартных подсистем (БСП)

• Проверку синтаксиса кода

• Шаблоны типовых решений

• Контекст для генерации форм

Список MCP-серверов

Сервер	Порт	Назначение	Требует данных
HelpSearchServer	8003	Поиск по справке платформы 1С	Да (папка bin)
CodeMetadataSearchServer	8000	Поиск по метаданным и коду конфигурации	Да (выгрузка)
Graph Metadata Search	8006	Графовый поиск связей метаданных	Да (выгрузка)
SSLSearchServer	8008	Поиск по БСП	Нет
SyntaxCheckServer	8002	Проверка синтаксиса BSL	Нет
TemplatesSearchServer	8004	Шаблоны кода 1С	Нет
FormsServer	8011	Схемы для генерации форм	Нет
1CCodeChecker	8007	Проверка через 1С:Напарник	Нет (нужен токен)

Рекомендуемый порядок установки

Начните с серверов, которые не требуют подготовки данных — это позволит быстро оценить возможности MCP.

Быстрый старт (без подготовки данных)

1. SyntaxCheckServer — проверка синтаксиса кода

2. FormsServer — контекст для генерации форм

3. SSLSearchServer — если используете БСП

4. TemplatesSearchServer — шаблоны кода

Полная настройка (требуется подготовка)

1. HelpSearchServer — справка по вашей версии платформы

2. CodeMetadataSearchServer — метаданные вашей конфигурации

3. Graph Metadata Search — анализ связей объектов

4. 1CCodeChecker — если есть токен 1С:Напарник

Требования

• Windows 10 (версия 2004+) или Windows 11

• Docker Desktop с WSL2

• Cursor IDE или другой клиент с поддержкой MCP

• 8+ ГБ RAM (рекомендуется 16 ГБ)

• SSD для векторных баз данных

Подробнее: Требования

Embedding модели

Большинство MCP-серверов используют embedding модели для семантического поиска. Рекомендуем:

Вариант	Когда использовать
LM Studio + Qwen	Есть GPU NVIDIA — лучшее качество и скорость
CPU режим	Нет GPU — работает везде, но медленнее

Для пользователей из России: При использовании CPU-моделей требуется скачивание с huggingface.co, который может быть заблокирован. Рекомендуем использовать LM Studio, где модели скачиваются через встроенный интерфейс.

Подробнее: Embedding модели

Быстрый старт

1. Установите Docker Desktop

# Установите WSL2
wsl --install

# Скачайте и установите Docker Desktop
# https://www.docker.com/products/docker-desktop/

2. Запустите простой сервер

# SyntaxCheckServer — не требует настройки
docker run -d -p 8002:8002 `
  --name 1c_syntaxcheck_mcp `
  -e LICENSE_KEY=YOUR_LICENSE_KEY `
  comol/1c_syntaxcheck_mcp:latest

3. Настройте Cursor

Создайте файл mcp.json:

{
  "mcpServers": {
    "1c-syntax-checker-mcp": {
      "url": "http://localhost:8002/mcp",
      "connection_id": "1c_lsp_service_001"
    }
  }
}

4. Проверьте работу

В Cursor попросите ИИ проверить синтаксис кода 1С — он должен использовать MCP-сервер.

Видеоматериалы

• Видеокурс по вайбкодингу — подробное обучение работе с MCP

• Страница MCP серверов — описание и демонстрации

Cursor Rules для 1С

Для эффективной работы MCP-серверов рекомендуется использовать специальные правила Cursor:

• cursor_rules_1c — набор правил для разработки на 1С

Важно: сохранение индексов

Обязательно монтируйте тома для сохранения векторных баз данных! Индексация может занимать от нескольких часов до суток. Без монтирования томов (-v) все индексы будут потеряны при перезапуске контейнера.

Подробнее: Кеширование БД

Структура документации

• Требования — Docker, Cursor, сетевые настройки

• Embedding модели — LM Studio (рекомендуется), CPU режим

• MCP серверы — установка и настройка каждого сервера

• Интеграция — mcp.json, несколько серверов

• Продвинутое использование — скрипты, docker-compose, GPU

• Устранение неполадок — решение типовых проблем

• Приложения — справочные таблицы, глоссарий