Справочник
Решение проблем
Начните с симптома. Большинство проблем решается проверкой подключения, прав доступа или точности запроса.
Безопасная диагностика
Не отправляйте в чат пароли, OAuth-токены и ручные ключи. Для проверки достаточно названия подключения, времени ошибки и текста сообщения без секретов.
AI-клиент не подключается
- Проверьте адрес подключения: https://mcp.omnitera.ru/mcp — без пробелов и дополнительных символов.
- Убедитесь, что входите в тот аккаунт Omnitera, где создано нужное пространство.
- Вернитесь в личный кабинет и проверьте, что подключение amoCRM активно.
- Удалите неудачное подключение из ChatGPT или Claude и пройдите подключение заново по инструкции.
Запрашивается повторный вход или доступ
- Сессия Omnitera могла завершиться. Войдите снова и повторите запрос.
- Если доступ amoCRM был отозван или истёк, переподключите amoCRM в личном кабинете.
- Если AI-подключение отключено, создайте или заново разрешите доступ только для нужного клиента.
AI не находит нужные данные
- Уточните период, воронку, этап и ответственного — одинаковые названия могут встречаться в разных воронках.
- Попросите AI сначала показать доступные воронки, этапы или поля, а затем повторите основной запрос.
- Проверьте права пользователя, через которого подключена amoCRM: Omnitera не может увидеть больше, чем разрешено этому пользователю.
- Для больших выборок попросите обработать все страницы или использовать готовый отчёт вместо одной страницы списка.
Результат выглядит неполным или неверным
- Попросите показать применённые фильтры и идентификаторы найденных записей.
- Для переходов между этапами укажите, нужен текущий этап или факт входа на этап за период — это разные выборки.
- Для дат назовите часовой пояс и точные границы периода, например «с 00:00 до 23:59 по Москве».
- Перед массовым изменением попросите сначала вывести список затрагиваемых записей без записи в CRM.
Запрос остановился из-за лимита
- Слишком широкую задачу разделите по периоду, воронке или ответственным.
- Для массовых операций используйте партии до 50 записей; AI обычно делает это автоматически.
- Если закончился лимит вызовов тарифа, дождитесь нового расчётного периода или смените тариф в личном кабинете.
Изменение не появилось в amoCRM
- Попросите AI вернуть ID записи и результат вызова, а затем обновите карточку amoCRM.
- Проверьте, что поле доступно для записи и значение соответствует его типу.
- Откройте журнал изменений через инструмент audit_list: там видно, какой записывающий инструмент запускался и чем завершился.
Передайте контекст поддержке
Приложите время ошибки, название AI-клиента, название пространства и точный текст запроса. Секреты и персональные данные удалите.
Обратиться в поддержку