Серверы без плагинов

Из перечисленных в документации компонентов без системы плагинов остаётся CloudEmbeddingsServer. Прикладные MCP-серверы, включая 1CCodeChecker, получили общий контракт в новых beta-сборках. Для CloudEmbeddingsServer рычаги прежние: переменные окружения, состав данных и правила на стороне клиента.

CodeMetadataSearchServer систему плагинов поддерживает — см. Справочник хуков. Рычаги окружения ниже остаются актуальными для него как более дешёвая альтернатива derived-state хуку.

Как проверить, поддерживает ли образ плагины

Не полагайтесь на память версий — спросите образ:

# Есть плагины: команда напечатает путь
docker run --rm comol/1c_help_mcp:latest ls /app/plugin_api.py

# CodeMetadataSearchServer держит справочник глубже — проверяйте оба пути
docker run --rm comol/1c_code_metadata_mcp:latest-beta ls /app/src/plugin_api.py

# 1CCodeChecker тоже хранит справочник не в корне образа
docker run --rm comol/1c-code-checker:latest-beta `
  ls /app/MCP_1copilot/plugin_api.py /app/plugins

Если файл есть — читайте его: это полный контракт, и дальше действует общая система плагинов. Если файла нет — смотрите разделы ниже.

Проверять только /app/plugin_api.py недостаточно: у CodeMetadataSearchServer справочник лежит в /app/src/plugin_api.py, у 1CCodeChecker — в /app/MCP_1copilot/plugin_api.py.

CodeMetadataSearchServer — рычаги окружения

Поиск по метаданным и коду конфигурации. Плагины сервер поддерживает, но и без них его поведение задаётся тем, что индексируется и как ранжируется — и это дешевле, чем derived-state хук.

Рычаг	Переменные	Что даёт
Состав данных	METADATA_PATH, CODE_PATH, INDEX_NESTED_CONFIGURATIONS, NESTED_CONFIGURATION_PATHS	Главный рычаг: сервер ищет ровно по тому, что вы смонтировали. Ограничьте выгрузку — сузите и ускорите поиск
Баланс поиска	BM25_ALPHA (вес семантики против полнотекста), MIN_SCORE_THRESHOLD	Смещение выдачи в сторону точных имён или смысла
Глубина выборки	OVERFETCH_MULTIPLIER, SEMANTIC_OVERFETCH_MULTIPLIER	Сколько кандидатов рассматривается до отсечения
Переранжирование	ENABLE_RERANKER, RERANKER_MODEL, RERANKER_TOP_K	Cross-encoder поверх выдачи, когда важнее качество, чем скорость
Профиль векторного хранилища	VECTOR_PROFILE (fast_index, balanced, memory_saver, quality)	Компромисс «скорость сборки / память / качество»
Обновление индекса	INCREMENTAL_INDEXING, REINDEX_INTERVAL_SEC, BACKGROUND_INDEXING, GENERATION_RETENTION_COUNT	Как часто и как дорого обновляется индекс
Эмбеддинги	EMBEDDING_MODEL, EMBEDDING_API_BASE, EMBEDDING_DIMENSIONS, EMBEDDING_PROVIDER	Качество семантического поиска

Полный список: Переменные окружения и Конфигурация CodeMetadataSearchServer.

Смена модели эмбеддингов или размерности делает сохранённый индекс несовместимым и вызывает переиндексацию — по стоимости это сопоставимо с правкой derived-state хука у серверов с плагинами.

CloudEmbeddingsServer

Индексация и поиск через внешний embedding-API. Плагинов нет; всё поведение задаётся окружением.

Рычаг	Переменные	Что даёт
Провайдер и модель	EMBEDDING_PROVIDER, EMBEDDING_MODEL, OPENAI_API_BASE и ключи провайдеров	Куда уходят тексты и каким качеством считаются векторы
Состав данных	SOURCE_PATH, AUTO_INDEX	Что именно индексируется при старте
Нарезка	CHUNK_SIZE, CHUNK_OVERLAP	Гранулярность найденного фрагмента — ближайший аналог «доработки индексации»
Пропускная способность	EMBEDDING_CONCURRENCY, EMBEDDING_BATCH_SIZE, MAX_BATCH_SIZE	Скорость индексации против нагрузки на API
Выдача	DEFAULT_SEARCH_LIMIT	Сколько результатов возвращается по умолчанию

Если рычагов окружения не хватает

Задача	Решение
Нужен свой инструмент с бизнес-логикой 1С	Конструктор MCP серверов для 1С — инструменты пишутся на встроенном языке и публикуются HTTP-сервисом 1С
Нужно поменять поведение ИИ, а не сервера	Cursor Rules для 1С — правила задают, когда и как агент вызывает инструменты
Нужны свои пресеты инструментов и словари терминов	Используйте TOOL_PRESETS: они есть у HelpSearchServer, Graph Metadata Search, CodeMetadataSearchServer и 1CCodeChecker
Нужен разбор связей объектов вместо поиска по коду	Graph Metadata Search работает по той же выгрузке и плагины поддерживает

Состав образов меняется — CodeMetadataSearchServer и 1CCodeChecker перешли на общий контракт именно так. Прежде чем закладываться на отсутствие плагинов, проверяйте текущий beta-образ командами из первого раздела: появление plugin_api.py означает, что система плагинов применима.