> 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/servery/help-search-server.md).

# HelpSearchServer

Поиск по справке платформы 1С конкретной версии с использованием RAG (Retrieval-Augmented Generation).

## Назначение

HelpSearchServer — это **самый важный** MCP-сервер для разработки на 1С. Он предоставляет ИИ доступ к официальной справке платформы 1С именно вашей версии.

### Почему это важно?

* Методы и параметры меняются от версии к версии
* ИИ без справки может давать устаревшую информацию
* Поиск по смыслу, а не только по названию метода

## Доступные инструменты MCP

ИИ получает следующие инструменты:

| Инструмент  | Описание                                                                |
| ----------- | ----------------------------------------------------------------------- |
| `docsearch` | Поиск по справке платформы 1С по описанию, вопросу или частичному имени |
| `docinfo`   | Получение документации по точному имени объекта, метода или свойства    |

### docsearch

Поиск по документации синтаксиса 1С с гибридным подходом (векторный + полнотекстовый). Используйте для поиска по описанию, вопросу или частичному имени. Если известно точное имя объекта или метода — используйте `docinfo`.

| Параметр | Тип    | Описание                                                                                  |
| -------- | ------ | ----------------------------------------------------------------------------------------- |
| `query`  | string | Поисковый запрос — описание нужной функциональности или ключевые слова (на русском языке) |

**Возврат**: Отформатированная строка с результатами поиска, разделёнными `---`.

**Логика поиска** зависит от длины запроса:

* 1 слово — сначала полнотекстовый, затем векторный поиск
* 2–3 слова — сначала векторный, затем полнотекстовый поиск
* 4+ слов — только векторный поиск

***

### docinfo

Получает документацию по точному имени объекта, метода или свойства платформы 1С. Используйте, когда знаете конкретное имя. Для методов и свойств объекта указывайте имя в формате `ИмяОбъекта.ИмяМетода`.

| Параметр | Тип    | Описание                                                                                      |
| -------- | ------ | --------------------------------------------------------------------------------------------- |
| `name`   | string | Точное имя объекта, метода или свойства 1С. Для членов объекта — формат `ИмяОбъекта.ИмяЧлена` |

**Возврат**: Содержимое документации в формате Markdown или сообщение об отсутствии результатов.

**Примеры значений параметра `name`:**

* `ТаблицаЗначений` — объект
* `Массив.Найти` — метод объекта
* `Запрос` — объект
* `HTTPЗапрос` — объект

**Логика поиска:**

1. Точное совпадение по полному имени (`ИмяОбъекта.ИмяМетода`)
2. Если не найдено — поиск по имени (`ИмяМетода`)
3. Если имя содержит точку — раздельный поиск по объекту и члену

{% hint style="info" %}
Если `docinfo` не нашёл результат, попробуйте `docsearch` с описанием нужной функциональности.
{% endhint %}

## Возможности

ИИ получает инструменты для:

* Получения документации по точному имени объекта или метода
* Поиска методов и их параметров по описанию
* Поиска по описанию функциональности
* Получения примеров использования
* Уточнения синтаксиса конструкций

## Примеры запросов

После подключения сервера ИИ может отвечать на вопросы:

* "Как сгенерировать случайное число?"
* "Как работать с временными таблицами в запросах?"
* "Как получить текущую дату сеанса?"
* "Какие есть методы для работы с файлами?"

А при точном знании имени — получать документацию напрямую:

* "Покажи документацию по ТаблицаЗначений"
* "Что принимает метод Массив.Найти?"

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

* Docker Desktop с WSL2
* Папка `bin` установленной платформы 1С
* Лицензионный ключ
* Embedding модель (LM Studio или CPU)

## Порт

**8003**

## Образ Docker

```
comol/1c_help_mcp:latest
```

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

```powershell
docker run -d -p 8003:8003 `
  --name 1c_help_mcp `
  -e LICENSE_KEY=YOUR_LICENSE_KEY `
  -v "C:/Program Files/1cv8/8.3.23.1997/bin:/1c_docs" `
  -v "E:/bases/mcp_docs:/app/chroma_db" `
  comol/1c_help_mcp:latest
```

Подробнее: [Установка](/mcp-servery-1c/servery/help-search-server/ustanovka.md)

## Конфигурация Cursor

```json
{
  "mcpServers": {
    "1c-docs-mcp": {
      "url": "http://localhost:8003/mcp",
      "connection_id": "1c_docs_service_001"
    }
  }
}
```

## Структура раздела

* [Установка](/mcp-servery-1c/servery/help-search-server/ustanovka.md) — команды запуска
* [Конфигурация](/mcp-servery-1c/servery/help-search-server/konfiguraciya.md) — все параметры
* [Использование](/mcp-servery-1c/servery/help-search-server/ispolzovanie.md) — примеры работы