Документация MCP-1C

Установка

Скачайте готовый бинарник для вашей операционной системы со страницы Releases на GitHub, или установите одной командой:

# Linux / macOS
curl -fsSL https://feenlace.ru/install.sh | sh

# Windows (PowerShell)
irm https://feenlace.ru/install.ps1 | iex

Подключение базы 1С

MCP-1C использует расширение конфигурации для чтения метаданных. Установите его автоматически:

# Файловая база - Windows
mcp-1c --install "C:\Users\Dev\InfoBases\ERP"

# Файловая база - Linux / macOS
mcp-1c --install ~/Documents/InfoBase

# Клиент-серверная база (MS SQL, PostgreSQL)
mcp-1c --install "srv-1c\buh_prod" --server --db-user Admin --db-password pass

Затем запустите HTTP-сервис 1С. Рекомендуемый способ -- публикация через Apache или IIS:

Конфигуратор → Администрирование → Публикация на веб-сервере

# Быстрый запуск для разработки (только Windows)
"C:\Program Files\1cv8\8.3.XX.XXXX\bin\1cv8.exe" ENTERPRISE /F "C:\путь\к\базе" /HTTPPort 8080

Параметр /HTTPPort -- недокументированный, работает только на Windows. На Linux используйте Apache или ibsrv.

Удалённая установка (клиент-серверная база)

Расширение MCP-1C можно установить как в файловые, так и в клиент-серверные базы данных. Способ установки зависит от типа информационной базы.

Файловая база (локальный путь)

Для файловой базы укажите локальный путь к каталогу информационной базы:

# Файловая база (локальный путь)
# Windows
mcp-1c --install "C:\Users\Dev\InfoBases\ERP"
# Linux / macOS
mcp-1c --install "/home/dev/bases/erp"

Клиент-серверная база (удалённо через сеть)

Для клиент-серверной базы используйте флаг --server. Установка выполняется удалённо, прямой доступ к серверу СУБД не требуется:

# Клиент-серверная база (удалённо через сеть)
mcp-1c --install "server-1c\erp" --server --db-user Admin --db-password pass

Удалённая установка polling-клиента Расширенная

В Расширенной версии polling-клиент устанавливается аналогично, с флагом --install-polling:

# Удалённая установка polling-клиента
mcp-1c-advanced --install-polling "server-1c\erp" --server --db-user Admin --db-password pass

Формат строки подключения

mcp-1c --install "server-1c\erp" --server \
  --platform "C:\Program Files\1cv8\8.3.25.1000\bin\1cv8.exe" \
  --db-user Admin --db-password pass

Настройка AI-клиента

Добавьте MCP-1C в конфигурацию вашего AI-клиента.

Claude Desktop

Файл: %APPDATA%\Claude\claude_desktop_config.json (Windows) или ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)

{
  "mcpServers": {
    "1c": {
      "command": "C:\\path\\to\\mcp-1c.exe",
      "args": ["--base", "http://localhost:8080/hs/mcp"]
    }
  }
}

Cursor

Settings → MCP → Add Server

{
  "mcpServers": {
    "1c": {
      "command": "mcp-1c",
      "args": ["--base", "http://localhost:8080/hs/mcp"]
    }
  }
}

VS Code + Copilot

Файл: .vscode/mcp.json в корне проекта

{
  "servers": {
    "1c": {
      "command": "mcp-1c",
      "args": ["--base", "http://localhost:8080/hs/mcp"]
    }
  }
}

JetBrains IDE

Settings → Tools → AI Assistant → MCP Servers → Add

{
  "servers": {
    "1c": {
      "command": "mcp-1c",
      "args": ["--base", "http://localhost:8080/hs/mcp"]
    }
  }
}

Первый запрос

Перезапустите AI-клиент и задайте вопрос о вашей конфигурации 1С. Примеры:

• •«Покажи структуру конфигурации моей базы 1С»
• •«Покажи все документы с реквизитом Организация»
• •«Напиши запрос: остатки товаров по складам за текущий месяц»
• •«Найди все использования регистра ТоварыНаСкладах»
• •«Объясни модуль менеджера документа РеализацияТоваровУслуг»

Мультибазовость Расширенная

Расширенная версия позволяет подключить несколько баз 1С одновременно. Каждая база получает имя, по которому AI-ассистент выбирает нужную:

mcp-1c-advanced \
  --base dev=http://localhost:8080/hs/mcp \
  --base prod=http://prod-server:8080/erp/hs/mcp \
  --auth dev=Admin:pass123 \
  --auth prod=ReadOnly:readonly \
  --dump dev=/path/to/dev/dump \
  --default-base dev

Аутентификация

Три способа задать учетные данные (по приоритету):

1. 1.Флаги CLI: --user и --password (или --auth NAME=USER:PASS в мультибазовом режиме)
2. 2.Переменные окружения: MCP_1C_USER и MCP_1C_PASSWORD
3. 3.Без аутентификации (если HTTP-сервис 1С не требует авторизации)

Выгрузка конфигурации (--dump)

Для полнотекстового поиска по коду модулей (search_code) необходима выгрузка конфигурации в файлы:

# 1. Выгрузите конфигурацию из Конфигуратора:
# Конфигурация → Выгрузить конфигурацию в файлы...

# 2. Укажите путь при запуске:
mcp-1c --base http://localhost:8080/hs/mcp \
  --dump "C:\dumps\erp"

# Принудительная перестройка индекса (игнорирует кэш):
mcp-1c --base http://localhost:8080/hs/mcp \
  --dump "C:\dumps\erp" --reindex

Индекс строится в фоне (неблокирующий старт). MCP-сервер доступен сразу, поиск заработает после завершения индексации. Дисковый кэш ускоряет повторные запуски.

Long Polling Расширенная

Long polling позволяет подключить базу 1С без Apache/IIS. Go-сервер поднимает HTTP-эндпоинт, а 1С сама ходит за задачами через регламентное задание.

[Claude/Cursor] --stdio--> [mcp-1c-advanced] --HTTP :9090--> [1С polling client]
                                ^                                    |
                                |                                    v
                            TaskQueue <--- POST /result/{id} --- [Обработка запроса]
                                |
                            GET /poll (long poll, 25 сек)

Шаг 1. Установка расширения

Файловая база:

mcp-1c-advanced --install-polling /path/to/database \
  --poll-user myuser \
  --poll-password mypassword

Клиент-серверная база:

mcp-1c-advanced --install-polling "SERVER01\MyDatabase" \
  --server \
  --poll-user myuser \
  --poll-password mypassword \
  --db-user admin \
  --db-password dbpass

Что происходит при установке:

1. 1.Находит платформу 1С автоматически
2. 2.Устанавливает расширение MCP_Polling через DESIGNER (без GUI)
3. 3.Расширение содержит модуль MCP_PollingClient и регламентное задание MCP_PollingJob
4. 4.Авторестарт при сбое: 3 попытки, интервал 60 секунд
5. 5.Настройки подключения встраиваются в код модуля

Шаг 2. Настройка AI-клиента

Флаг --base объявляет базу данных в формате NAME=URL. Схема poll:// указывает MCP-серверу маршрутизировать запросы через очередь задач вместо прямого HTTP-подключения к 1С. Флаг --listen задает адрес HTTP-сервера, к которому 1С будет подключаться для получения задач. Оба флага обязательны: --base mydb=poll:// объявляет polling-базу, --listen :9090 запускает HTTP-сервер.

Файл: claude_desktop_config.json

{
  "mcpServers": {
    "mcp-1c": {
      "command": "/path/to/mcp-1c-advanced",
      "args": [
        "--base", "mydb=poll://",
        "--listen", ":9090",
        "--poll-user", "myuser",
        "--poll-password", "mypassword"
      ]
    }
  }
}

Шаг 3. Проверка

1. 1.Запустите AI-клиент - MCP-сервер стартует и слушает :9090
2. 2.Регламентное задание автоматически начинает polling
3. 3.В журнале регистрации 1С: "MCP.Polling: polling loop started"
4. 4.Проверка здоровья: curl http://localhost:9090/health

HTTP-эндпоинты

Сравнение режимов

Отладка

• •Журнал регистрации 1С: события с источником "MCP.Polling"
• •Проверка здоровья: curl http://localhost:9090/health
• •Ручная проверка polling: curl -u user:pass http://localhost:9090/poll --max-time 30
• •Регламентное задание: Администрирование → Регламентные и фоновые задания → MCP_PollingJob
• •Файловый режим: регламентные задания работают только при открытом клиенте 1С

Флаги Открытой версии mcp-1c

Флаги Расширенной версии mcp-1c-advanced

Включает все флаги Открытой версии, плюс следующие:

Примеры команд

# Минимальный запуск (все по умолчанию)
mcp-1c

# С аутентификацией и выгрузкой
mcp-1c --base http://server:8080/erp/hs/mcp \
  --user Admin --password secret \
  --dump /dumps/erp

# Установка в клиент-серверную базу с нестандартной платформой
mcp-1c --install "srv-1c\buh_prod" --server \
  --platform "C:\Program Files\1cv8\8.3.25.1000\bin\1cv8.exe" \
  --db-user Admin --db-password pass

# Advanced: мультибазовость с polling
mcp-1c-advanced \
  --base dev=http://localhost:8080/hs/mcp \
  --base staging=poll:// \
  --auth dev=Admin:dev123 \
  --dump dev=/dumps/dev \
  --listen :9090 \
  --poll-user agent --poll-password secret \
  --default-base dev

# Advanced: обновить данные синтакс-помощника
mcp-1c-advanced --update-syntax

# Advanced: управление лицензией
mcp-1c-advanced --activate "XXXX-XXXX-XXXX-XXXX"
mcp-1c-advanced --license-status
mcp-1c-advanced --deactivate