> 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С:Напарник                                       | Нет (нужен токен)                                   | Да (в beta) |

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

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

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

## Каналы поставки

Образы публикуются в каналах **stable** (`latest`, `light`, `arm64`) и **beta** (`latest-beta`, `light-beta`, `arm64-beta`). Набор вариантов зависит от сервера; новые контракты и функции, описанные в документации, сначала появляются в beta. Лицензионный ключ должен соответствовать каналу, а суффикс `-beta` всегда пишется через дефис.

Полная таблица тегов, переменных ключей и правила безопасного переключения: [Каналы образов: stable и beta](/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) — справочные таблицы, глоссарий