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

MCP-1C это MCP-сервер для платформы 1С:Предприятие. Он даёт AI-ассистенту доступ к метаданным конфигурации, коду на BSL и текстам запросов, проверяет безопасность и помогает генерировать код на BSL.

Установка

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

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

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

При регистрации вы получите 14-дневный пробный период Профессиональной версии со всеми возможностями. Скачайте бинарник mcp-1c-pro в личном кабинете.

Расширенная: Бинарник mcp-1c-advanced доступен в личном кабинете после оформления подписки.

Профессиональная: Скачивание бинарника mcp-1c-pro доступно в личном кабинете после регистрации. 14 дней пробного периода, без привязки карты.

Проверьте установку и узнайте версию бинарника:

mcp-1c-advanced --version    # выводит версию и атрибуцию BSL-LS

Активация триала: зарегистрируйтесь на feenlace.ru → подтвердите почту → получите 14 дней Профессиональной версии без привязки карты. Бинарник mcp-1c-pro и ключ доступны в личном кабинете. Подробнее об активации, статусе и переносе лицензии читайте в разделе Лицензирование.

Данные синтакс-помощника (Расширенная / Профессиональная)

Инструмент code_search(action: "syntax_help") и проверка API check_bsl_api используют справочник встроенных функций, методов и типов платформы. В Расширенной и Профессиональной версиях он не встроен в бинарник, его нужно один раз собрать из синтакс-помощника вашей установленной платформы 1С:

# автоопределение установленной платформы (берётся самая новая версия)
mcp-1c-advanced --update-syntax                                   # или mcp-1c-pro

# явный путь к каталогу платформы, если автоопределение не сработало
mcp-1c-advanced --update-syntax --platform /opt/1cv8/8.3.27.1000

Команда разбирает файл shcntx_ru.hbk вашей платформы и сохраняет справочник в локальный кэш (~/.cache/mcp-1c/syntax/ на Linux, ~/Library/Caches/mcp-1c/syntax/ на macOS, %LocalAppData%\mcp-1c\syntax на Windows). После выполнения перезапустите MCP-сервер. Повторяйте команду после обновления платформы 1С.

Кэш общий для всех подключённых баз и хранит один набор данных. Если базы работают на разных версиях платформы, справочник соответствует той версии, на которую вы указали при последнем запуске (при автоопределении самой новой установленной). Для смешанного парка укажите нужную версию через --platform.

Если платформа 1С не установлена локально (например, вы работаете через EDT с удалённой базой), скопируйте файл shcntx_ru.hbk из каталога любой подходящей версии платформы (с сервера, с машины коллеги или из дистрибутива платформы) в отдельную папку и укажите её: mcp-1c-advanced --update-syntax --platform /путь/к/папке. Файл должен называться именно shcntx_ru.hbk. Синтаксис платформы в основном стабилен между минорными версиями 8.3.x, поэтому подойдёт файл близкой версии. После сборки кэша справочник работает без установленной локально платформы.

Подключение базы 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

Что произойдёт при установке

1. В базу 1С загрузится расширение "MCP" (~50 КБ)
2. Расширение добавит HTTP-сервис для обмена данными с AI
3. Расширение Открытой версии работает только на чтение, не изменяет данные и конфигурацию
4. Расширенная версия добавляет возможность выполнения кода через sandbox с подтверждением и аудит-логом
5. Расширение можно отключить или удалить в любой момент через Конфигуратор

Затем опубликуйте HTTP-сервис 1С на веб-сервере. Это штатный способ на всех платформах: на Windows через Apache или IIS, на Linux через Apache или ibsrv.

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

После публикации HTTP-сервис доступен по адресу, который включает алиас публикации, например http://localhost/base/hs/mcp-1c/version. Проверьте этот адрес и укажите его в параметре --base при настройке AI-клиента.

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

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

# Удалённая установка polling-клиента
mcp-1c-advanced --install-polling "server-1c\erp" --server --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/base/hs/mcp-1c"]
    }
  }
}

Claude Code (CLI)

Файл: %USERPROFILE%\.claude.json (Windows) или ~/.claude.json (Linux/macOS). Альтернатива: команда claude mcp add.

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

Cursor

Settings → MCP → Add Server

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

VS Code + Copilot

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

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

JetBrains IDE

Settings → Tools → AI Assistant → MCP Servers → Add

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

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

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

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