Типові повідомлення, де дивитися журнали та відповіді на найчастіші запитання.
Де дивитися
- Журнал коннектора — лежить поруч із програмою.
- Режим перевірки коннектора — показує статус ліцензії та з’єднання з базою (деталі надаємо за запитом).
- Журнал реєстрації 1С — інструмент
get_event_logабо штатний журнал бази. - Журнал Claude Desktop — помилки запуску MCP-сервера.
Типові проблеми
| Симптом | Причина | Що робити |
|---|---|---|
| Інструменти відповідають, що ліцензію не знайдено | Ліцензійний файл не встановлено. | Надішліть постачальнику код комп’ютера (він є в тексті відмови та в утиліті налаштування) і встановіть отриманий файл. Перезапуск не потрібен. |
| Ліцензія для іншого комп’ютера | Файл випущено для іншого коду. | Після перевстановлення Windows або заміни материнської плати код змінюється — запросіть нову ліцензію. |
| Файл ліцензії пошкоджено або підпис неправильний | Файл змінено або втрачено частину. | Встановіть файл заново через утиліту налаштування. |
| Версія новіша за оплачену | Ліцензія обмежена датою оновлень. | Поверніть попередню версію або продовжте оновлення. |
| 400 «Недостатньо прав» | У користувача сервісу немає прав на об’єкт. | Перевірте ролі та обмеження доступу на рівні записів. |
403 на запит із ПОДСТРОКА / ПОДОБНО / ВЫРАЗИТЬ | Спрацювала перевірка запитів до замаскованих даних. | Переформулюйте запит без обробки рядків замаскованих полів. |
У відповіді замість значень — токени виду [Справочник.…] | Поле входить у правила анонімізації. Це штатна поведінка. | Щоб побачити реальні значення, використайте розшифрування токенів локально. Змінити правила може лише адміністратор налаштувань. |
| Claude не бачить сервер MCP | Помилка в claude_desktop_config.json або не перезапущено Claude Desktop. | Перевірте шлях до файла та синтаксис, повністю перезапустіть Claude Desktop. |
| Запис не виконується | Запис вимкнено. | Перевірте ключ MCP_РазрешитьЗапись у регістрі налаштувань. Перед висновком перечитайте налаштування: їх можуть змінювати в реальному часі. |
Якщо не вдається підключитися
Коннектор звертається до бази через веб-сервер, на якому опублікована ваша 1С. Якщо база не відповідає, пройдіть основні перевірки по порядку:
- Веб-сервер запущено. Перевірте, що служба веб-сервера працює.
- Адреса правильна. Відкрийте адресу сервісу в браузері (вона закінчується на
/hs/mcp). Помилка 404 найчастіше означає хибну адресу або непідключений сервіс. - Сервіс опубліковано. HTTP-сервіс розширення має бути відмічений у публікації бази.
- Зміни застосовано. Після встановлення чи оновлення розширення оновіть конфігурацію бази та перезапустіть веб-сервер.
- Логін і пароль. Перевірте ім’я та пароль користувача сервісу й те, що йому призначено роль MCP-коннектора. Не вписуйте пароль у файл публікації бази.
- Мережа. Переконайтеся, що з комп’ютера користувача є доступ до сервера й порт веб-сервера не закрито брандмауером.
- Журнал веб-сервера. Він зазвичай прямо показує причину відмови.
Відкрийте адресу сервісу в браузері на самому сервері. Якщо тут усе гаразд, а з комп’ютера користувача ні, проблема в мережі чи адресі. Якщо відповіді немає й тут, перевірте веб-сервер і публікацію.
FAQ
Чи потрібен окремий сервер?
Ні. Локальний коннектор працює на робочому місці користувача. Вимоги до сервера бази — ті самі, що для звичайної роботи з 1С.
Чи потрібна додаткова ліцензія 1С?
Ні, ліцензування 1С таке ж, як для будь-якого HTTP-підключення до бази.
Чи потрапляють імена контрагентів до хмари AI?
Значення, що входять до правил анонімізації, замінюються токенами на боці 1С до відправлення відповіді. Обмеження моделі захисту описані у розділі «Безпека та доступи».
Чи можна користуватися з телефона?
Коннектор працює з Claude Desktop на комп’ютері користувача, тому основний сценарій — робоче місце з Windows або macOS (Apple Silicon).
Який мінімальний тариф Claude?
Pro. Для командної роботи рекомендований Team.
Чи можна працювати з власною закритою моделлю?
Технічних перешкод немає, але потрібне потужне обладнання, а якість відповідей буде нижчою. Реальних проєктів поки не було.
Що буде, якщо перевстановити Windows?
Код комп’ютера зміниться, і ліцензію потрібно випустити заново. Зверніться до постачальника з новим кодом.
Чи можна змінити код розширення?
Код відкритий для перегляду. Зміни у власній копії розширення виконуються на вашу відповідальність, оновлення постачальника доведеться переносити.