Запросы к базе 1С для агентов
1c-llm-requests
Маленькое расширение 1С с HTTP-сервисом и скилл, чтобы агент сам писал запросы на языке 1С и получал данные базы в TSV
- 56 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Агент читает данные рабочей базы, включая персональные
- Учетные данные базы хранятся в файле .env
Установка
- Работает в
- Сервисы
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/1c-llm-requestsОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент читает данные рабочей базы, включая персональные
- Учетные данные базы хранятся в файле .env
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Расширение публикует HTTP-сервис, который принимает текст запроса на языке 1С, проверяет его синтаксис и возвращает результат таблицей с разделителями. Скилл 1c-queries дает агенту скрипты для bash и PowerShell, которые читают адрес и учетные данные из .env, и подробные правила составления запросов: без параметров через амперсанд, с ограничением ПЕРВЫЕ N, со сравнением ссылок через реквизиты. Так агент разбирает, почему не проводится документ, опираясь на реальные данные, или делает произвольный анализ базы. Автор советует подключать вместе с MCP по метаданным, чтобы агент сначала читал структуру.
Для кого. Для разработчиков и аналитиков 1С, которые разбирают ошибки и данные в базе вместе с агентом.
Подходит, если
- Нужно понять, почему документ не проводится, на конкретных данных
- Нужен разовый анализ данных базы без написания отчета
- Нужно проверить, что запрос на языке 1С корректен и возвращает ожидаемое
Не подходит, если
- Данные базы нельзя передавать во внешнюю модель
- Нужно изменять данные: сервис только читает
Пример запроса к агенту
Почему не проводится чек ККМ ССНФ-000002 от 2 января? Посмотри данные в базеОграничения
Агент читает любые данные, доступные пользователю 1С, включая персональные: за конфиденциальность отвечает владелец базы, автор советует обезличивать данные. Нужно установить расширение и опубликовать HTTP-сервис на веб-сервере или через автономный сервер ibsrv. Логин и пароль базы хранятся в .env в папке скилла.
Как отключить. Удалите папку .claude/skills/1c-queries из проекта и отключите расширение АПРО_ВнешниеЗапросы или публикацию HTTP-сервиса.
Частые вопросы
Может ли агент что-то сломать в базе?
По словам автора, нет: сервис выполняет только запросы на чтение. Но прочитать агент может все, что доступно пользователю.
Почему ответ в TSV, а не в JSON?
Таблица с разделителями занимает заметно меньше токенов, а модели хорошо ее понимают.
Обсуждение
Вопросов и отзывов пока нет.
MCP-сервер на Go одним бинарником: агент видит метаданные базы 1С, ищет по коду, выполняет запросы на чтение и пишет точный BSL
Скиллы 1С для ИИ-агентов
1C Skills for AI Agents
Сборник скиллов для разработки на 1С под Codex и Claude Code: XML-исходники, формы, СКД, базы, веб-публикация и HTTP-мост для тестов
Скилл пакетных операций с платформой 1С: сборка и разборка обработок, загрузка и выгрузка конфигураций и расширений, запуск базы
Локальный MCP-сервер на OneScript для поиска по выгрузке конфигурации 1С прямо из Cursor
Бесплатный MCP-сервер для рабочей базы 1С: агент читает данные по обычной просьбе и получает структуру метаданных любой конфигурации
Гайд с рабочими скриптами по безопасному подключению агента к 1С и Bitrix24: OData, вебхуки и каталог из 14 проверенных инструментов
Коротко о README
README объясняет, что расширение занимает около двадцати строк кода и выросло из задачи разбирать ошибки проведения на реальных данных. Быстрый старт: подключить расширение, опубликовать HTTP-сервис для клиент-серверной или файловой базы, проверить его через curl и заполнить .env скилла. Автор подчеркивает роль подробного SKILL.md и проверки синтаксиса запроса как обратной связи для агента, приводит примеры отчетов и альтернативные решения. Лицензия MIT.
Бейдж для README
Исходный SKILL.md
--- name: 1c-queries description: Выполняет запросы к базе данных 1С:Предприятие через HTTP-сервис. Используй этот навык когда нужно получить данные из 1С, выполнить анализ данных в базе 1С, написать или проверить запрос на языке 1С. --- # Выполнение запросов к базе 1С:Предприятие ## Обзор Этот навык позволяет выполнять запросы к базе данных 1С:Предприятие через HTTP-сервис. Используй его для анализа данных и получения информации из 1С. ## Скрипты для выполнения запросов Скрипты читают `.env` автоматически и отправляют запрос в 1С. **Windows (PowerShell):** ```powershell .\.claude\skills\1c-queries\scripts\query-1c.ps1 -Query 'ВЫБРАТЬ Кассы.Код, Кассы.Наименование ИЗ Справочник.Кассы КАК Кассы ГДЕ Кассы.Наименование = "Основная касса"' ``` **Linux (bash):** ```bash ./.claude/skills/1c-queries/scripts/query-1c.sh 'ВЫБРАТЬ Кассы.Код, Кассы.Наименование ИЗ Справочник.Кассы КАК Кассы ГДЕ Кассы.Наименование = "Основная касса"' ``` ## Формат ответа - Ответ в формате TSV (Tab-Separated Values) - Первая строка — заголовки колонок - Следующие строки — данные - При ошибке: HTTP 400 с описанием ошибки