Що потрібно підготувати на стороні бази 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. Це окремий індивідуальний проєкт.