> For the complete documentation index, see [llms.txt](https://docs.onerpa.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.onerpa.ru/mcp-servery-1c.md).

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

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

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

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

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

* Доступ к справке платформы 1С вашей версии
* Поиск по метаданным конфигурации
* Поиск по Библиотеке стандартных подсистем (БСП)
* Проверку синтаксиса кода
* Шаблоны типовых решений

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

| Сервер                                                                      | Порт | Назначение                                                                                                            | Требует данных                                      | Плагины |
| --------------------------------------------------------------------------- | ---- | --------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------- | ------- |
| [HelpSearchServer](/mcp-servery-1c/servery/help-search-server.md)           | 8003 | Справка платформы, руководства, спецификации форматов, стандарты                                                      | Нет (папка bin — только для своей версии платформы) | Да      |
| [CodeMetadataSearchServer](/mcp-servery-1c/servery/code-metadata-search.md) | 8000 | Поиск по метаданным и коду конфигурации                                                                               | Да (выгрузка)                                       | Да      |
| [Graph Metadata Search](/mcp-servery-1c/servery/graph-metadata-search.md)   | 8006 | Графовый поиск связей метаданных                                                                                      | Да (выгрузка)                                       | Да      |
| [SSLSearchServer](/mcp-servery-1c/servery/ssl-search-server.md)             | 8008 | Поиск по БСП                                                                                                          | Нет                                                 | Да      |
| [SyntaxCheckServer](/mcp-servery-1c/servery/syntax-check-server.md)         | 8002 | Проверка синтаксиса BSL                                                                                               | Нет                                                 | Да      |
| [TemplatesSearchServer](/mcp-servery-1c/servery/templates-search-server.md) | 8004 | Шаблоны кода 1С                                                                                                       | Нет                                                 | Да      |
| [1CCodeChecker](/mcp-servery-1c/servery/code-checker.md)                    | 8007 | Проверка через 1С:Напарник                                                                                            | Нет (нужен токен)                                   | Да      |
| [MCP QA](/mcp-servery-1c/servery/qa.md)                                     | 8020 | Автотестирование через 1С /TestClient                                                                                 | Тестовая база                                       | Нет     |
| [Конвертация данных 2.0 (KD20)](/mcp-servery-1c/servery/kd20.md)            | 8009 | Правила обмена КД 2.0: составление, проверка, доработка макетов; чтение и проверка обмена через EnterpriseData (КД 3) | Да (выгрузки двух конфигураций)                     | Нет     |

## Доработка под свою конфигурацию

Все семь прикладных серверов расширяются **плагинами** — одним Python-файлом в каталоге плагинов, без пересборки образа: свои термины и синонимы, пресеты инструментов, фильтрация и переупорядочивание выдачи, разметка того, что попадает в индекс. У Graph Metadata Search подсистема включена по умолчанию; `GRAPH_PLUGINS_ENABLED=false` полностью отключает чтение каталога.

Подробно, с расчётом на ИИ-агента, которому поручили доработку: [Доработка MCP: система плагинов](/mcp-servery-1c/sistema-pluginov.md).

## Теги образов

Образы публикуются под тегами `latest`, `light` и `arm64`; набор вариантов зависит от сервера. У каждого сервера свой лицензионный ключ; образы от 27.09.2026 принимают только ключи, выпущенные 27.09.2026.

Полная таблица тегов, переменные ключей и переход на образы от 27.09.2026: [Теги и ключи образов](/mcp-servery-1c/kanaly-obrazov.md).

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

{% hint style="info" %}
Начните с серверов, которые не требуют подготовки данных — это позволит быстро оценить возможности MCP.
{% endhint %}

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

1. **SyntaxCheckServer** — проверка синтаксиса кода
2. **SSLSearchServer** — если используете БСП
3. **TemplatesSearchServer** — шаблоны кода
4. **HelpSearchServer** — справка платформы, руководства и стандарты поставляются в образе

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

5. **HelpSearchServer с папкой bin** — справка именно вашей версии платформы
6. **CodeMetadataSearchServer** — метаданные вашей конфигурации
7. **Graph Metadata Search** — анализ связей объектов
8. **1CCodeChecker** — если есть токен 1С:Напарник

## Требования

* **Windows, Linux, macOS** или другая платформа, на которой можно запускать Docker-контейнеры
* **Docker Engine, Docker Desktop** или совместимая среда запуска Linux-контейнеров
* **Cursor IDE** или другой клиент с поддержкой MCP
* **8+ ГБ RAM** (рекомендуется 16 ГБ)
* **SSD** для векторных баз данных

На Apple Silicon и других ARM64-хостах используйте тег `arm64`, если он опубликован для выбранного сервера. Если ARM64-тега нет, Docker может запустить образ `linux/amd64` в режиме эмуляции; особенности конкретных серверов указаны на их страницах.

Подробнее: [Требования](/mcp-servery-1c/trebovaniya.md)

## Embedding модели

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

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

{% hint style="warning" %}
**Для пользователей из России:** При использовании CPU-моделей требуется скачивание с huggingface.co, который может быть заблокирован. Рекомендуем использовать LM Studio, где модели скачиваются через встроенный интерфейс.
{% endhint %}

Подробнее: [Embedding модели](/mcp-servery-1c/embedding-modeli.md)

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

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

Установите Docker Engine, Docker Desktop или другую совместимую среду для вашей ОС. На Windows рекомендуется Docker Desktop с WSL2; на Linux можно использовать Docker Engine; на macOS — Docker Desktop или другой Docker-совместимый runtime.

Проверьте установку:

```shell
docker version
docker run --rm hello-world
```

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

```shell
# 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`:

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

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

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

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

* [Видеокурс по вайбкодингу](https://vibecoding1c.ru/#course) — подробное обучение работе с MCP
* [Страница MCP серверов](https://vibecoding1c.ru/mcp_server) — описание и демонстрации

## Cursor Rules для 1С

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

* [cursor\_rules\_1c](https://github.com/comol/cursor_rules_1c) — набор правил для разработки на 1С

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

{% hint style="danger" %}
**Обязательно монтируйте тома** для сохранения векторных баз данных! Индексация может занимать от нескольких часов до суток. Без монтирования томов (`-v`) все индексы будут потеряны при перезапуске контейнера.
{% endhint %}

Подробнее: [Кеширование БД](/mcp-servery-1c/prodvinutoe-ispolzovanie/keshirovanie-bd.md)

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

* [Требования](/mcp-servery-1c/trebovaniya.md) — Docker, Cursor, сетевые настройки
* [Embedding модели](/mcp-servery-1c/embedding-modeli.md) — LM Studio (рекомендуется), CPU режим
* [MCP серверы](/mcp-servery-1c/servery.md) — установка и настройка каждого сервера
* [Интеграция](/mcp-servery-1c/integraciya.md) — mcp.json, несколько серверов
* [Доработка MCP: система плагинов](/mcp-servery-1c/sistema-pluginov.md) — как расширять серверы без пересборки образов
* [Продвинутое использование](/mcp-servery-1c/prodvinutoe-ispolzovanie.md) — скрипты, docker-compose, GPU
* [Устранение неполадок](/mcp-servery-1c/ustranenie-nepoladok.md) — решение типовых проблем
* [Приложения](/mcp-servery-1c/prilozhenia.md) — справочные таблицы, глоссарий