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

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

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

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

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

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

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

| Сервер                                                                                         | Порт | Назначение                              | Требует данных    |
| ---------------------------------------------------------------------------------------------- | ---- | --------------------------------------- | ----------------- |
| [HelpSearchServer](https://docs.onerpa.ru/mcp-servery-1c/servery/help-search-server)           | 8003 | Поиск по справке платформы 1С           | Да (папка bin)    |
| [CodeMetadataSearchServer](https://docs.onerpa.ru/mcp-servery-1c/servery/code-metadata-search) | 8000 | Поиск по метаданным и коду конфигурации | Да (выгрузка)     |
| [Graph Metadata Search](https://docs.onerpa.ru/mcp-servery-1c/servery/graph-metadata-search)   | 8006 | Графовый поиск связей метаданных        | Да (выгрузка)     |
| [SSLSearchServer](https://docs.onerpa.ru/mcp-servery-1c/servery/ssl-search-server)             | 8008 | Поиск по БСП                            | Нет               |
| [SyntaxCheckServer](https://docs.onerpa.ru/mcp-servery-1c/servery/syntax-check-server)         | 8002 | Проверка синтаксиса BSL                 | Нет               |
| [TemplatesSearchServer](https://docs.onerpa.ru/mcp-servery-1c/servery/templates-search-server) | 8004 | Шаблоны кода 1С                         | Нет               |
| [1CCodeChecker](https://docs.onerpa.ru/mcp-servery-1c/servery/code-checker)                    | 8007 | Проверка через 1С:Напарник              | Нет (нужен токен) |

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

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

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

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

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

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

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

* **Windows 10** (версия 2004+) или **Windows 11**
* **Docker Desktop** с WSL2
* **Cursor IDE** или другой клиент с поддержкой MCP
* **8+ ГБ RAM** (рекомендуется 16 ГБ)
* **SSD** для векторных баз данных

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

## Embedding модели

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

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

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

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

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

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

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

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

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

```powershell
# 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 %}

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

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

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