ERP AI AgentДокументація

Вимоги та сумісність

Що потрібно підготувати на стороні бази 1С/BAS, робочого місця та AI-клієнта.

База 1С/BAS

ПараметрВимога
ПлатформаПідтримуються всі платформи 1С:Підприємство та BAF (BAS), починаючи з версії 8.2.13. Бажано, щоб платформа підтримувала роботу з розширеннями конфігурації: тоді встановлення й оновлення коннектора значно простіші.
КонфігураціїБудь-які: типові, доопрацьовані типові та самописні. Конкретна конфігурація не має значення, бо структуру даних коннектор читає з метаданих бази наживо. Окремий довідник метаданих не потрібен.
РозширенняРозширення конфігурації «MCP» (файл .cfe). Код розширення відкритий: клієнт бачить усе, що відбувається в його базі.
HTTP-сервісОпублікована база на веб-сервері (наприклад, Apache) з HTTP-сервісом розширення. Кореневий URL — mcp.
Ліцензії 1СТака сама вимога, як для будь-якого підключення до 1С через HTTP-сервіс. Окремої ліцензії 1С для коннектора немає.
Користувачі базиКористувач сервісу (від його імені працює AI) із роллю MCP-коннектора (її призначають обліковому запису, під яким підключається Claude) та, окремо, адміністратор MCP із роллю адміністратора MCP-коннектора (лише для людини): він керує обмеженнями та правилами роботи коннектора.
Права AI — це права користувача бази

Claude бачить і робить у базі лише те, що дозволено користувачеві сервісу. Якщо потрібно обмежити доступ до даних, використовуйте звичайні механізми 1С: ролі та обмеження доступу на рівні записів (RLS).

Робоче місце

ПараметрВимога
ОСWindows (основна підтримка) або macOS на Apple Silicon (macOS 11 і новіша). Intel Mac не підтримується.
ПраваПрава адміністратора ОС не потрібні. Налаштування виконується під тим користувачем Windows, який працюватиме в Claude Desktop.
МережаДоступ з робочого місця до HTTP-сервісу бази та доступ Claude Desktop до сервісів Anthropic.
Ліцензія коннектораЛіцензійний файл, прив’язаний до комп’ютера.

AI-клієнт

  • Claude Desktop — рекомендований клієнт: найсильніша модель дає найкращі результати. Мінімальний тариф Claude — Pro, рекомендований — Team.
  • Claude Code — для розробки та пошуку по коду конфігурації.
  • Інші клієнти. Також підтримуються Grok і ChatGPT (Codex): ви можете користуватися різними моделями та програмами, проте Claude залишається найкращим вибором.
  • Власна закрита модель — можливо без технічних перешкод, але потрібне потужне обладнання, а якість відповідей буде нижчою за Claude. Рішення — за клієнтом.

Рекомендації щодо підготовки

  • Виконуйте вивантаження конфігурації у файли регулярно й автоматично, лише зі змінами: інструмент пошуку по коду працює по цьому вивантаженню.
  • Де зберігати пароль користувача сервісу та чи використовувати HTTPS для бази, опублікованої на іншій машині, вирішує адміністратор клієнта. Це рекомендації, а не обов’язкові вимоги.
  • Для платформи 8.3.21 і новіше можлива посилена автентифікація за технологією JWT. Це окремий індивідуальний проєкт.