# 1c Ai Connector

> ИИкона — AI-коннектор для 1С:Предприятие 8.3: LLM-провайдеры, агентская петля (function calling), RAG, MCP-сервер, мониторинг ошибок с ИИ-анализом, генератор диаграмм

- **Type:** MCP server
- **Install:** `agentstack add mcp-andromanpro-1c-ai-connector`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [andromanpro](https://agentstack.voostack.com/s/andromanpro)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [andromanpro](https://github.com/andromanpro)
- **Source:** https://github.com/andromanpro/1c-ai-connector
- **Website:** https://androman.pro

## Install

```sh
agentstack add mcp-andromanpro-1c-ai-connector
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# ИИкона — AI-коннектор для 1С:Предприятие

> Расширение для интеграции языковых моделей (LLM) в конфигурации 1С:Предприятие 8.3:
> единый коннектор к провайдерам, агентская петля с инструментами, RAG, MCP-сервер,
> мониторинг ошибок с ИИ-анализом и генератор диаграмм.

[](https://opensource.org/licenses/MIT)
[](https://1c.ru)
[](https://github.com/andromanpro/1c-ai-connector/releases)
[](#-качество-кода)

## 🎯 О проекте

**ИИкона (КИИ — Коннектор Искусственного Интеллекта)** — расширение для работы
с языковыми моделями прямо из 1С. Начиналась как API-коннектор с единым интерфейсом
для всех популярных провайдеров; с версии 1.3.0 это платформа ИИ-подсистем:
поверх коннектора работают агентская петля с инструментами, семантический поиск
по базе знаний (RAG), MCP-сервер для внешних ИИ-агентов, мониторинг ошибок
с ИИ-диагнозом и генератор диаграмм.

Ставится как расширение конфигурации, основную конфигурацию не изменяет.

**Готовые сценарии из коробки:**

- 🚨 Мониторинг ошибок базы: сбор из журнала регистрации, ИИ-диагноз, Telegram
- 🔍 Аудит кода по ошибке: место в исходниках + объяснение причины
- 🛠 База 1С как набор инструментов для Claude/Cursor (MCP)
- 📊 Диаграммы по текстовому описанию (mermaid/plantuml/graphviz/bpmn)

**И API для своих решений:**

- 🤖 Чат-боты для поддержки клиентов
- 📝 Генерация контента (описания товаров, документы)
- 🔍 Классификация и извлечение структурированных данных из текста
- 📚 Ответы по своей базе знаний (RAG)
- 🎯 Агенты, которые сами ходят по данным 1С инструментами

## ✨ Возможности

### Коннектор (ядро)

- **Пять форматов провайдеров** отдельными коннекторами: OpenAI-совместимые API,
  Anthropic, Google Gemini, YandexGPT, GigaChat — плюс 25+ готовых моделей
  в макете предустановок.
- **Синхронные и асинхронные запросы** (фоновые задания), история сообщений,
  системные промпты.
- **Мультимодальность**: изображения и документы во вложениях запроса,
  генерация изображений в ответе.
- **Кеш ответов** с TTL (per-model, opt-in), полное логирование запросов
  (токены, время, ошибки), поддержка прокси, OAuth2 (GigaChat), IAM (Yandex).
- **Повторы с экспоненциальным backoff** — только транзиентные коды (429/5xx),
  без задвоения POST.

### Агентская петля (function calling)

Модель вызывает инструменты 1С и продолжает рассуждение по результатам — во всех
пяти форматах провайдеров. Лимиты раундов и вызовов, дедупликация повторных
вызовов, принуждение к финальному выводу, аудит каждого вызова.

> Форматные адаптеры всех провайдеров покрыты тестами; живой прогон выполнялся
> на OpenAI-совместимых моделях. Флаги «Поддерживает инструменты» у остальных
> провайдеров в предустановках включайте после смоука со своими ключами.

### RAG — база знаний

Категории знаний, авто-нарезка документов на фрагменты, эмбеддинги
с версионированием. Знания привязываются к экспертам и подмешиваются в системный
промпт автоматически. Два бэкенда поиска: встроенный (чистый 1С, без зависимостей)
и [Qdrant](https://qdrant.tech) — с очередью синхронизации и фоновой сверкой.
Egress-политики не выпускают конфиденциальные фрагменты за пределы базы.

### MCP-сервер

HTTP-сервис (JSON-RPC 2.0): внешние ИИ-агенты работают с базой как с набором
инструментов — метаданные, структура объектов, read-only запросы, диаграммы.
Basic Auth, ограничение частоты, whitelist запросов, сокрытие секретов, аудит
с автоочисткой. ⚠ Наружу публикуйте только через HTTPS (reverse-proxy с TLS).

### Мониторинг ошибок

Регламентный сбор из журнала регистрации, нормализация и дедупликация, пакетный
ИИ-анализ и глубокий агентный разбор, уведомления в Telegram с антиспамом,
правила игнорирования, статистика, HTML-дашборд. Плюс аудитор кода: по ошибке
находит место в исходниках и объясняет причину.

### Генератор диаграмм

Описание словами → диаграмма (mermaid / plantuml / graphviz / bpmn). Mermaid
рендерится локально встроенной библиотекой mermaid.js — без внешних сервисов;
остальные форматы и серверный рендер (PNG/SVG, MCP-инструмент) — через
[kroki](https://kroki.io). Модель с инструментами сама читает метаданные
конфигурации и рисует реальные реквизиты.

## 🌐 Поддерживаемые провайдеры

| Провайдер | Формат API | Function calling | Статус |
|-----------|------------|------------------|--------|
| **OpenAI** (GPT-4/5.x) | OpenAI Compatible | ✅ | ✅ |
| **Anthropic** (Claude) | Anthropic Messages | ✅ формат готов | ✅ |
| **Google** (Gemini) | Google AI | ✅ формат готов | ✅ |
| **DeepSeek** | OpenAI Compatible | ✅ | ✅ |
| **GigaChat** (Сбер) | OAuth2 + legacy functions | ✅ формат готов | ✅ |
| **Yandex** (YandexGPT) | Yandex Cloud | ✅ формат готов | ✅ |
| **Mistral / Qwen / Groq / Grok** | OpenAI Compatible | ✅ | ✅ |
| **Ollama / LM Studio / LiteLLM** (локальные) | OpenAI Compatible | зависит от модели | ✅ |
| **OpenRouter / Together / Fireworks и др.** | OpenAI Compatible | ✅ | ✅ |

## 📦 Установка

### Требования

- **1С:Предприятие 8.3.24+** — версия 1.3.0 разрабатывалась и тестировалась
  на **8.3.27**
- **БСП (Библиотека стандартных подсистем) 3.1.10+** — тестировалось
  на демо-базе БСП 3.1.11.392
- Доступ в интернет для облачных провайдеров (локальные модели работают офлайн)
- Опционально: [Qdrant](https://qdrant.tech) для быстрого векторного поиска,
  [kroki](https://kroki.io) для рендера диаграмм

> Версии 1.0.x проверялись также на 1С:ERP 2.5.17. Версия 1.3.0 на ERP
> не перепроверялась — отчёты о работе на других конфигурациях приветствуются
> в [Issues](https://github.com/andromanpro/1c-ai-connector/issues).

### Шаги установки

1. Скачайте `.cfe` из [Releases](https://github.com/andromanpro/1c-ai-connector/releases)
2. Подключите расширение (Администрирование → Расширения конфигурации)
3. Обновите базу данных
4. Откройте справочник «Модели ИИ» и нажмите «Заполнить модели» — загрузятся
   25+ предустановок
5. Укажите API-ключи нужных моделей (хранятся в защищённом хранилище 1С,
   в выгрузки не попадают); кнопка проверки соединения — на форме модели
6. Создайте «Эксперта ИИ»: модель + системный промпт
7. Новые подсистемы включаются заполнением их настроек: Telegram-токен
   для мониторинга, адрес Qdrant для RAG, адрес kroki для диаграмм,
   пользователь API для MCP — что не настроено, то просто не работает,
   не мешая остальному

### Обновление с 1.0.x

Штатное: данные моделей и экспертов сохраняются, публичный API совместим
(`ЗапросКМодели`, `ЗапросКМоделиВФоне`, `ПараметрыМодели` — прежние сигнатуры).
Единственное поведенческое изменение: роль «КИИ Полные права» больше
не раздаёт права на объекты основной конфигурации — только на объекты
расширения (закрыта избыточная выдача).

## 🚀 Быстрый старт

### Простейший запрос (3 строки кода)

```bsl
Модель = Справочники.КИИ_МоделиИИ.НайтиПоНаименованию("gpt-4");
Ответ = КИИ_КоннекторИИ.ЗапросКМодели(Модель, "Привет! Как дела?");

Если Не Ответ.ЭтоОшибка Тогда
    ОбщегоНазначения.СообщитьПользователю(Ответ.ТекстОтвета);
КонецЕсли;
```

### С системным промптом и историей

```bsl
Промпт = Новый Структура;
Промпт.Вставить("СистемныйПромпт", "Ты — помощник программиста 1С");
Промпт.Вставить("ПользовательскийПромпт", "Как создать новый документ?");
Промпт.Вставить("ИсторияСообщений", История); // необязательно

Ответ = КИИ_КоннекторИИ.ЗапросКМодели(Модель, Промпт);
```

### Асинхронный запрос (фоновое задание)

```bsl
ДлительнаяОперация = КИИ_КоннекторИИ.ЗапросКМоделиВФоне(Модель, Промпт);
ДлительныеОперации.ОжидатьЗавершение(ДлительнаяОперация);
Ответ = ПолучитьИзВременногоХранилища(ДлительнаяОперация.АдресРезультата);
```

### Markdown → HTML

```bsl
HTML = КИИ_МаркдаунПарсерКлиентСервер.ПреобразоватьВHTML(Ответ.ТекстОтвета);
```

### Тестирование без кода

Обработка **«Тест ИИ»**: чат с экспертом, вложения (изображения/документы),
история диалога, просмотр логов — всё интерактивно.

## 📚 Документация и разработка

- **Руководство пользователя (вики)** — [1c-ai-connector-guide](https://github.com/andromanpro/1c-ai-connector-guide):
  настройка моделей и провайдеров, RAG и база знаний, мониторинг ошибок
  и аудитор кода, MCP-сервер и безопасность, генератор диаграмм.
- **Автотесты (398 YAxUnit-тестов)** — [1c-ai-connector-tests](https://github.com/andromanpro/1c-ai-connector-tests);
  для прогона нужны [YAxUnit](https://github.com/bia-technologies/yaxunit) в базе
  и тестовое расширение.
- **MCP-прокси для stdio-клиентов** — [1c-ai-connector-mcp-proxy](https://github.com/andromanpro/1c-ai-connector-mcp-proxy)
  (Claude Desktop и другие клиенты без HTTP-транспорта).

## 🔑 Получение API ключей

Инструкции по провайдерам

### OpenAI
1. [platform.openai.com](https://platform.openai.com) → API keys → создайте ключ
2. Пополните баланс

### Anthropic (Claude)
1. [console.anthropic.com](https://console.anthropic.com) → API Keys

### Google (Gemini)
1. [Google AI Studio](https://aistudio.google.com) → Get API key

### DeepSeek
1. [platform.deepseek.com](https://platform.deepseek.com) → API Keys

### GigaChat (Сбер)
1. [developers.sber.ru/gigachat](https://developers.sber.ru/gigachat)
2. Получите Authorization key (или ClientId:ClientSecret) — модуль сам обменяет
   на OAuth2-токен

### Yandex GPT
1. [Yandex Cloud](https://console.cloud.yandex.ru) → сервисный аккаунт → API-ключ
2. В модели укажите Folder ID

## 🔍 Качество кода

- ✅ **398 модульных тестов** (YAxUnit): коннекторы, агентская петля, RAG,
  мониторинг, MCP, парсеры
- ✅ **SonarQube (BSL Language Server): 0 замечаний**, рейтинги A/A,
  технический долг 0; осознанные исключения задокументированы подавлениями
  с обоснованием прямо в коде
- ✅ Проход сертификационных EDT-проверок (доккомментарии, области, роли)
- ✅ Протестировано на демо-базе БСП 3.1.11.392 / платформе 8.3.27

## 🗺️ Roadmap

### Выполнено (v1.3.0)

- [x] Vision API — изображения и документы во вложениях + генерация изображений
- [x] Улучшенная обработка rate limits — backoff, повтор только транзиентных кодов
- [x] Function calling — агентская петля во всех пяти форматах провайдеров
- [x] Embeddings API — и весь RAG поверх
- [x] Сверх плана: MCP-сервер, мониторинг ошибок с ИИ-анализом, аудитор кода,
  генератор диаграмм, 397 автотестов

### Планы

- [ ] Streaming — в чистом BSL невозможен (платформа отдаёт HTTP-ответ целиком);
  исследуется эмуляция через фоновое задание с опросом
- [ ] Live-смоук function calling на Anthropic/Google/Yandex/GigaChat
  и включение флагов в предустановках
- [ ] CI: сборка `.cfe`, прогон тестов и Sonar на каждый коммит
- [ ] Расширение покрытия тестами (инструментальное измерение покрытия)

## ❓ FAQ

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

### Какая платформа 1С поддерживается?

8.3.24+; версия 1.3.0 разрабатывалась и тестировалась на 8.3.27.

### Требуется ли БСП?

Да, БСП 3.1.10+ (тестировалось на 3.1.11.392).

### Поддерживается ли отправка изображений?

Да, с версии 1.3.0: изображения и документы прикладываются к запросу
(в «Тест ИИ» — вкладка вложений), поддерживается и генерация изображений.

### Можно ли использовать без интернета?

Да — локальные модели через Ollama/LM Studio, встроенный RAG-поиск
и локальный рендер mermaid-диаграмм тоже работают без внешних сервисов.

### Где хранятся API ключи?

В защищённом хранилище 1С; в выгрузки конфигурации не попадают.

### Как контролировать затраты?

Все запросы логируются в регистр с токенами и временем; кеш ответов
сокращает повторные обращения.

### Можно ли добавить своего провайдера?

Любой OpenAI-совместимый API работает из коробки: создайте модель, укажите
адрес, формат `OpenAI_Compatible`, имя модели и ключ.

### Можно ли использовать в коммерческих проектах?

Да, лицензия MIT.

## 🤝 Участие в проекте

- 🐛 **Нашли баг?** — [Issue](https://github.com/andromanpro/1c-ai-connector/issues)
- 💡 **Есть идея?** — [Discussions](https://github.com/andromanpro/1c-ai-connector/discussions)
- 🔧 **Хотите помочь?** — Pull Request

## 📄 Лицензия

[MIT](LICENSE) © 2026 Андриянов Роман ([androman.pro](https://androman.pro))

## 📞 Контакты

- 🌐 **Сайт**: [androman.pro](https://androman.pro)
- 💬 **Telegram**: [@andromanpro1c](https://t.me/andromanpro1c)
- 📧 **Email**: andromanpro@gmail.com

---

**Сделано с ❤️ для сообщества 1С**

[⭐ Поставьте звезду](https://github.com/andromanpro/1c-ai-connector) • [💬 Обсуждения](https://github.com/andromanpro/1c-ai-connector/discussions) • [🐛 Сообщить об ошибке](https://github.com/andromanpro/1c-ai-connector/issues)

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [andromanpro](https://github.com/andromanpro)
- **Source:** [andromanpro/1c-ai-connector](https://github.com/andromanpro/1c-ai-connector)
- **License:** MIT
- **Homepage:** https://androman.pro

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-andromanpro-1c-ai-connector
- Seller: https://agentstack.voostack.com/s/andromanpro
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.