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

Діагностика та FAQ

Типові повідомлення, де дивитися журнали та відповіді на найчастіші запитання.

Де дивитися

  • Журнал коннектора — лежить поруч із програмою.
  • Режим перевірки коннектора — показує статус ліцензії та з’єднання з базою (деталі надаємо за запитом).
  • Журнал реєстрації 1С — інструмент get_event_log або штатний журнал бази.
  • Журнал Claude Desktop — помилки запуску MCP-сервера.

Типові проблеми

СимптомПричинаЩо робити
Інструменти відповідають, що ліцензію не знайденоЛіцензійний файл не встановлено.Надішліть постачальнику код комп’ютера (він є в тексті відмови та в утиліті налаштування) і встановіть отриманий файл. Перезапуск не потрібен.
Ліцензія для іншого комп’ютераФайл випущено для іншого коду.Після перевстановлення Windows або заміни материнської плати код змінюється — запросіть нову ліцензію.
Файл ліцензії пошкоджено або підпис неправильнийФайл змінено або втрачено частину.Встановіть файл заново через утиліту налаштування.
Версія новіша за оплаченуЛіцензія обмежена датою оновлень.Поверніть попередню версію або продовжте оновлення.
400 «Недостатньо прав»У користувача сервісу немає прав на об’єкт.Перевірте ролі та обмеження доступу на рівні записів.
403 на запит із ПОДСТРОКА / ПОДОБНО / ВЫРАЗИТЬСпрацювала перевірка запитів до замаскованих даних.Переформулюйте запит без обробки рядків замаскованих полів.
У відповіді замість значень — токени виду [Справочник.…]Поле входить у правила анонімізації. Це штатна поведінка.Щоб побачити реальні значення, використайте розшифрування токенів локально. Змінити правила може лише адміністратор налаштувань.
Claude не бачить сервер MCPПомилка в claude_desktop_config.json або не перезапущено Claude Desktop.Перевірте шлях до файла та синтаксис, повністю перезапустіть Claude Desktop.
Запис не виконуєтьсяЗапис вимкнено.Перевірте ключ MCP_РазрешитьЗапись у регістрі налаштувань. Перед висновком перечитайте налаштування: їх можуть змінювати в реальному часі.

Якщо не вдається підключитися

Коннектор звертається до бази через веб-сервер, на якому опублікована ваша 1С. Якщо база не відповідає, пройдіть основні перевірки по порядку:

  1. Веб-сервер запущено. Перевірте, що служба веб-сервера працює.
  2. Адреса правильна. Відкрийте адресу сервісу в браузері (вона закінчується на /hs/mcp). Помилка 404 найчастіше означає хибну адресу або непідключений сервіс.
  3. Сервіс опубліковано. HTTP-сервіс розширення має бути відмічений у публікації бази.
  4. Зміни застосовано. Після встановлення чи оновлення розширення оновіть конфігурацію бази та перезапустіть веб-сервер.
  5. Логін і пароль. Перевірте ім’я та пароль користувача сервісу й те, що йому призначено роль MCP-коннектора. Не вписуйте пароль у файл публікації бази.
  6. Мережа. Переконайтеся, що з комп’ютера користувача є доступ до сервера й порт веб-сервера не закрито брандмауером.
  7. Журнал веб-сервера. Він зазвичай прямо показує причину відмови.
Швидкий тест

Відкрийте адресу сервісу в браузері на самому сервері. Якщо тут усе гаразд, а з комп’ютера користувача ні, проблема в мережі чи адресі. Якщо відповіді немає й тут, перевірте веб-сервер і публікацію.

FAQ

Чи потрібен окремий сервер?

Ні. Локальний коннектор працює на робочому місці користувача. Вимоги до сервера бази — ті самі, що для звичайної роботи з 1С.

Чи потрібна додаткова ліцензія 1С?

Ні, ліцензування 1С таке ж, як для будь-якого HTTP-підключення до бази.

Чи потрапляють імена контрагентів до хмари AI?

Значення, що входять до правил анонімізації, замінюються токенами на боці 1С до відправлення відповіді. Обмеження моделі захисту описані у розділі «Безпека та доступи».

Чи можна користуватися з телефона?

Коннектор працює з Claude Desktop на комп’ютері користувача, тому основний сценарій — робоче місце з Windows або macOS (Apple Silicon).

Який мінімальний тариф Claude?

Pro. Для командної роботи рекомендований Team.

Чи можна працювати з власною закритою моделлю?

Технічних перешкод немає, але потрібне потужне обладнання, а якість відповідей буде нижчою. Реальних проєктів поки не було.

Що буде, якщо перевстановити Windows?

Код комп’ютера зміниться, і ліцензію потрібно випустити заново. Зверніться до постачальника з новим кодом.

Чи можна змінити код розширення?

Код відкритий для перегляду. Зміни у власній копії розширення виконуються на вашу відповідальність, оновлення постачальника доведеться переносити.