# 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) — справочные таблицы, глоссарий


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.onerpa.ru/mcp-servery-1c.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.