BSL MCP: справка по языку 1С и проверка кода для Claude Code и Cursor

1c-syntax/bsl-language-server· Проверено 13.11.2026· 505на GitHub

Дают агенту знания о языке 1С: справку по типам и функциям платформы, проверку модулей, поиск определений и вызовов в выгруженных исходниках. Работают с файлами на диске и справкой платформы, к самой базе 1С не подключаются.

4 реализации:

Режим mcp в самом BSL Language Server: диагностики, навигация по коду и справка по типам платформы и OneScript; появился в версии 1.0.0 и пока экспериментальный; лицензия LGPL-3.0.

Как подключить

Что сделать до подключения

Java 21 или новее

bsl-language-server.jar со страницы Releases репозитория 1c-syntax/bsl-language-server, версия 1.0.0 или новее

Исходники конфигурации или проекта OneScript на диске, например выгрузка в src/cf

Конфиг для вашего клиента

Впишите ключи, и они встанут во все конфиги ниже. Конфиг собирается в браузере.

Аргумент запуска

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio bsl \
  -- java -jar '<путь к bsl-language-server.jar>' mcp

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.bsl]
command = "java"
args = ["-jar", "<путь к bsl-language-server.jar>", "mcp"]

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "bsl": {
      "command": "java",
      "args": ["-jar", "<путь к bsl-language-server.jar>", "mcp"]
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "bsl": {
      "type": "stdio",
      "command": "java",
      "args": ["-jar", "<путь к bsl-language-server.jar>", "mcp"]
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "bsl": {
      "command": "java",
      "args": ["-jar", "<путь к bsl-language-server.jar>", "mcp"]
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "bsl": {
      "command": "java",
      "args": ["-jar", "<путь к bsl-language-server.jar>", "mcp"]
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "bsl": {
        "type": "local",
        "command": ["java", "-jar", "<путь к bsl-language-server.jar>", "mcp"]
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "bsl": {
      "command": "java",
      "args": ["-jar", "<путь к bsl-language-server.jar>", "mcp"]
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "bsl": {
      "command": "java",
      "args": ["-jar", "<путь к bsl-language-server.jar>", "mcp"]
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Собрать вместе с другими серверами в одном mcp.json →

Инструменты сервера

analyze_fileвыдаёт диагностики по файлу

document_symbolsстроит дерево символов модуля

find_referencesищет все ссылки на символ

call_hierarchyпоказывает входящие и исходящие вызовы

definitionпереходит к объявлению

hoverпоказывает сигнатуру и документацию

type_infoописывает тип платформы

global_member_infoописывает глобальную функцию или свойство

global_member_searchищет по глобальному контексту

type_at_positionвыводит тип выражения

Только справка: читает встроенную справку установленной платформы 1С и ищет по функциям, типам, методам и свойствам с нечётким совпадением; 5 инструментов; лицензия MIT.

Как подключить

Что сделать до подключения

Java 17 или новее

Установленная платформа 1С:Предприятие, рекомендуется 8.3.20 или новее

mcp-bsl-context-<версия>.jar со страницы Releases

Конфиг для вашего клиента

Впишите ключи, и они встанут во все конфиги ниже. Конфиг собирается в браузере.

Аргумент запускаАргумент запуска

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio mcp-bsl-platform-context \
  -- java -Dfile.encoding=UTF-8 -jar '<путь к mcp-bsl-context-0.3.2.jar>' --platform-path '<каталог установки платформы 1С>'

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.mcp-bsl-platform-context]
command = "java"
args = ["-Dfile.encoding=UTF-8", "-jar", "<путь к mcp-bsl-context-0.3.2.jar>", "--platform-path", "<каталог установки платформы 1С>"]

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "mcp-bsl-platform-context": {
      "command": "java",
      "args": [
        "-Dfile.encoding=UTF-8",
        "-jar",
        "<путь к mcp-bsl-context-0.3.2.jar>",
        "--platform-path",
        "<каталог установки платформы 1С>"
      ]
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "mcp-bsl-platform-context": {
      "type": "stdio",
      "command": "java",
      "args": [
        "-Dfile.encoding=UTF-8",
        "-jar",
        "<путь к mcp-bsl-context-0.3.2.jar>",
        "--platform-path",
        "<каталог установки платформы 1С>"
      ]
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "mcp-bsl-platform-context": {
      "command": "java",
      "args": [
        "-Dfile.encoding=UTF-8",
        "-jar",
        "<путь к mcp-bsl-context-0.3.2.jar>",
        "--platform-path",
        "<каталог установки платформы 1С>"
      ]
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "mcp-bsl-platform-context": {
      "command": "java",
      "args": [
        "-Dfile.encoding=UTF-8",
        "-jar",
        "<путь к mcp-bsl-context-0.3.2.jar>",
        "--platform-path",
        "<каталог установки платформы 1С>"
      ]
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "mcp-bsl-platform-context": {
        "type": "local",
        "command": [
          "java",
          "-Dfile.encoding=UTF-8",
          "-jar",
          "<путь к mcp-bsl-context-0.3.2.jar>",
          "--platform-path",
          "<каталог установки платформы 1С>"
        ]
      }
    }
  }
}

{
  "mcpServers": {
    "mcp-bsl-platform-context": {
      "command": "java",
      "args": [
        "-Dfile.encoding=UTF-8",
        "-jar",
        "<путь к mcp-bsl-context-0.3.2.jar>",
        "--platform-path",
        "<каталог установки платформы 1С>"
      ]
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "mcp-bsl-platform-context": {
      "command": "java",
      "args": [
        "-Dfile.encoding=UTF-8",
        "-jar",
        "<путь к mcp-bsl-context-0.3.2.jar>",
        "--platform-path",
        "<каталог установки платформы 1С>"
      ]
    }
  }
}

Собрать вместе с другими серверами в одном mcp.json →

Инструменты сервера

searchищет по API платформы

infoвыдаёт подробную справку по элементу

getMemberописывает метод или свойство типа

getMembersперечисляет методы и свойства типа

getConstructorsперечисляет конструкторы типа

Анализ больших конфигураций: агент присылает Python-скрипт, сервер выполняет его в песочнице с 67 хелперами и возвращает только вывод print(); исходники CF, EDT и MDO; лицензия MIT.

Как подключить

Что сделать до подключения

Python 3.10 или новее и uv

Установка со службой одной командой: simple-install-from-pip.ps1 в PowerShell от имени администратора на Windows или simple-install-from-pip.sh на Linux

Выгрузка исходников конфигурации в формате CF, EDT или MDO

RLM_LLM_API_KEY

необязателен: ключ OpenAI-совместимого сервиса или Anthropic API для хелперов llm_query; без него остальные хелперы работают

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport http rlm-tools-bsl http://127.0.0.1:9000/mcp

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.rlm-tools-bsl]
url = "http://127.0.0.1:9000/mcp"

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "rlm-tools-bsl": {
      "url": "http://127.0.0.1:9000/mcp"
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "rlm-tools-bsl": {
      "type": "http",
      "url": "http://127.0.0.1:9000/mcp"
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "rlm-tools-bsl": {
      "httpUrl": "http://127.0.0.1:9000/mcp"
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "rlm-tools-bsl": {
      "httpUrl": "http://127.0.0.1:9000/mcp"
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "rlm-tools-bsl": {
        "type": "remote",
        "url": "http://127.0.0.1:9000/mcp"
      }
    }
  }
}

Customize → Connectors → добавить свой коннектор.
Адрес сервера: http://127.0.0.1:9000/mcp

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "rlm-tools-bsl": {
      "url": "http://127.0.0.1:9000/mcp"
    }
  }
}

Собрать вместе с другими серверами в одном mcp.json →

Инструменты сервера

rlm_projectsведёт реестр проектов

rlm_indexстроит и обновляет индекс

rlm_startоткрывает сессию анализа

rlm_helpвыдаёт рецепты и описания хелперов

rlm_executeвыполняет скрипт в песочнице

rlm_endзакрывает сессию

Мост к BSL Language Server в Docker-контейнере: полный граф вызовов, оценка сложности, автоисправления и переименование по проекту; 19 инструментов; лицензия Apache-2.0.

Как подключить

Что сделать до подключения

Docker и Docker Compose, 8 ГБ оперативной памяти или больше

Клон репозитория и файл .env из env.example: минимум MCP_PROJECT_NAME и WORKSPACE_ROOT

Сборка и запуск контейнера: docker compose -f docker-compose.yml build, затем up -d

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio mcp-bsl-lsp-bridge \
  -- docker exec -i 1c-dev-mcp-bsl-rlm mcp-lsp-bridge

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.mcp-bsl-lsp-bridge]
command = "docker"
args = ["exec", "-i", "1c-dev-mcp-bsl-rlm", "mcp-lsp-bridge"]

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "mcp-bsl-lsp-bridge": {
      "command": "docker",
      "args": ["exec", "-i", "1c-dev-mcp-bsl-rlm", "mcp-lsp-bridge"]
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "mcp-bsl-lsp-bridge": {
      "type": "stdio",
      "command": "docker",
      "args": ["exec", "-i", "1c-dev-mcp-bsl-rlm", "mcp-lsp-bridge"]
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "mcp-bsl-lsp-bridge": {
      "command": "docker",
      "args": ["exec", "-i", "1c-dev-mcp-bsl-rlm", "mcp-lsp-bridge"]
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "mcp-bsl-lsp-bridge": {
      "command": "docker",
      "args": ["exec", "-i", "1c-dev-mcp-bsl-rlm", "mcp-lsp-bridge"]
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "mcp-bsl-lsp-bridge": {
        "type": "local",
        "command": ["docker", "exec", "-i", "1c-dev-mcp-bsl-rlm", "mcp-lsp-bridge"]
      }
    }
  }
}

{
  "mcpServers": {
    "mcp-bsl-lsp-bridge": {
      "command": "docker",
      "args": ["exec", "-i", "1c-dev-mcp-bsl-rlm", "mcp-lsp-bridge"]
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "mcp-bsl-lsp-bridge": {
      "command": "docker",
      "args": ["exec", "-i", "1c-dev-mcp-bsl-rlm", "mcp-lsp-bridge"]
    }
  }
}

Собрать вместе с другими серверами в одном mcp.json →

Инструменты сервера

project_analysisищет символы, файлы и текст

symbol_exploreпоказывает символ с кодом и документацией

definitionпереходит к определению

hoverпоказывает сигнатуру и документацию

completionперечисляет члены типа после точки

signature_helpподсказывает параметры метода

get_range_contentдостаёт фрагмент кода

call_hierarchyпоказывает вызовы на один уровень

call_graphстроит полный граф вызовов

symbol_impactоценивает радиус правки процедуры

document_diagnosticsнаходит ошибки и замечания

quality_diagnosticsищет риски безопасности, производительности и SQL

complexityсчитает сложность методов

module_healthранжирует методы модуля по проблемам

code_actionsпредлагает автоисправления

prepare_renameпроверяет возможность переименования

renameпереименовывает символ везде

lsp_statusпоказывает прогресс индексации

did_change_watched_filesсообщает об изменении файлов

Что попросить агента

«Какие методы и конструкторы есть у типа <ТаблицаЗначений>?»Агент вызовет getMembers и getConstructors в mcp-bsl-platform-context или type_info в BSL Language Server

«Проверь модуль <путь к файлу .bsl> на ошибки»Агент вызовет analyze_file в BSL Language Server или document_diagnostics в мосте

«Где вызывается процедура <ИмяПроцедуры> и что она вызывает сама?»Агент найдёт ссылки через find_references и вызовы через call_hierarchy; в мосте полный граф даст call_graph

«Разберись, как работает проведение документа <АвансовыйОтчет> в проекте <ЕРП>»Агент откроет сессию rlm_start по проекту и будет выполнять хелперы через rlm_execute

«Оцени сложность методов модуля <путь к файлу> и скажи, что чинить первым»Агент вызовет module_health, при нужде complexity и quality_diagnostics

Для каких задач

Дать агенту сигнатуры и описания типов и глобальных функций платформы, чтобы он не выдумывал методы

Проверить модуль BSL на ошибки и замечания BSL Language Server

Найти объявление процедуры, все места вызова и построить граф вызовов

Разобраться в большой конфигурации по частям, не загружая модули в контекст целиком

Оценить сложность методов и переименовать символ по всему проекту

Ограничения

Серверы видят исходники на диске и справку платформы: данных базы, запросов и журнала регистрации у них нет — для этого нужны серверы со страницы «MCP-сервер для 1С»

Режим MCP в BSL Language Server экспериментальный, API может меняться; в версиях 1.0.x каталог проекта сервер получает только через MCP roots клиента

Для mcp-bsl-platform-context нужна установленная платформа 1С: справку сервер читает из её каталога

Docker на Windows медленный: rlm-tools-bsl через WSL2 работает в 5–10 раз медленнее, мост к BSL LS читает 40 тысяч файлов около 12 минут

Если не работает

На Windows mcp-bsl-platform-context отвечает с испорченной кириллицей

Запускайте java с ключом -Dfile.encoding=UTF-8 перед -jar, как в примере для Windows; в версии 0.3.2 исправлены проблемы с кодировкой на Windows.

BSL Language Server не хватает памяти на большой конфигурации

Добавьте в args перед -jar параметр -Xmx, например -Xmx4g; объём зависит от размера кодовой базы.

rlm-tools-bsl отвечает по 60–90 секунд или падает по таймауту

Постройте SQLite-индекс: попросите агента вызвать rlm_index с action build или выполните rlm-bsl-index index build. На HDD и сетевых дисках индекс фактически обязателен.

Агент не пользуется rlm-tools-bsl и ищет grep по всей папке

Проверьте, что rlm_start есть в списке инструментов, и напишите в промпте: «начни с rlm_start по проекту <имя>». Слабым моделям добавьте это правило в инструкции.

Служба rlm-tools-bsl на Windows не запускается, ошибка 1053

Запустите от имени администратора diagnose-service-win.ps1 из репозитория: PowerShell -ExecutionPolicy Bypass -File .\diagnose-service-win.ps1.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
BSL Language Server	1c-syntax	505	локально	не нужен	10	12 ноября 2026
MCP BSL Platform Context	alkoleft	207	локально	не нужен	5	10 марта 2026
rlm-tools-bsl	Dach-Coin	232	HTTP	не нужен	6	12 ноября 2026
MCP BSL LS Bridge	SteelMorgan	71	локально	не нужен	19	28 сентября 2026

Частые вопросы

Чем эти серверы отличаются от MCP-серверов для 1С?

Серверы со страницы «MCP-сервер для 1С» подключаются к базе или к 1C:EDT: читают метаданные, выполняют запросы, смотрят журнал регистрации. Серверы BSL работают с языком: справка по платформе и анализ исходников, выгруженных на диск. Базу публиковать и запускать 1С для них не нужно.

Что выбрать для справки по синтаксису?

BSL Language Server отвечает через type_info, global_member_info и global_member_search и заодно проверяет код. mcp-bsl-platform-context занят только справкой: читает встроенную справку из установленной платформы 1С, путь к ней передаётся в --platform-path.

Зачем rlm-tools-bsl, если агент сам умеет искать по файлам?

Встроенные grep и чтение файлов отдают в контекст сырые данные целиком, и на конфигурации в 20 000 файлов он забивается за несколько запросов. В rlm-tools-bsl агент вызывает хелперы вроде extract_procedures и read_procedure на сервере и получает только итог; экономия контекста — 25–95%.

Какие нужны исходники?

rlm-tools-bsl читает выгрузки CF из Конфигуратора, EDT и MDO, расширения из src/cfe подхватывает сам. BSL Language Server и мост работают с каталогом проекта; мост понимает основную конфигурацию с расширениями, если в WORKSPACE_ROOT указать их общий родительский каталог.

Сколько памяти нужно?

Мост к BSL LS просит 8 ГБ оперативной памяти и больше. Для BSL Language Server на большом проекте задают предел памяти Java параметром -Xmx, например -Xmx4g; mcp-bsl-platform-context нужно от 512 МБ.

Что такое MCP BSL Platform Context?

Сервер alkoleft/mcp-bsl-platform-context на Kotlin: даёт агенту встроенную справку платформы 1С — поиск по функциям, типам, методам и свойствам, сигнатуры и конструкторы. Справку читает из установленной платформы, запускается через java -jar с параметром --platform-path.

Есть ли MCP в BSL Language Server?

Есть с версии 1.0.0, в экспериментальном режиме: команда java -jar bsl-language-server.jar mcp запускает сервер по stdio, с --protocol sse или streamable — по HTTP на порту из --server.port. Флаг --mcp поднимает MCP рядом с обычным LSP.

Где скачать BSL MCP на GitHub?

bsl-language-server.jar и mcp-bsl-context-<версия>.jar лежат на страницах Releases репозиториев 1c-syntax/bsl-language-server и alkoleft/mcp-bsl-platform-context. rlm-tools-bsl ставится из PyPI скриптом из Dach-Coin/rlm-tools-bsl, мост собирается в Docker из SteelMorgan/mcp-bsl-lsp-bridge.

Как подключить BSL MCP к Claude Code?

Для rlm-tools-bsl после установки службы выполните claude mcp add --transport http rlm-tools-bsl http://127.0.0.1:9000/mcp. Для остальных вариантов готовые команды — во вкладке Claude Code блока «Как подключить», путь к jar-файлу подставьте свой.

Работает ли сервер из России?

Все четыре сервера запускаются у вас, зарубежные аккаунты и ключи не нужны; ключ LLM в rlm-tools-bsl необязателен.

BSL MCP: справка по языку 1С и проверка кода для Claude Code и Cursor

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы