Помилки
Типові помилки Listano Control MCP та рекомендації щодо їх усунення.
Інструменти Listano Control MCP можуть повертати помилки автентифікації, дозволів, валідації, перевірки готовності або збоїв запитів до бекенду.
Найбезпечніший спосіб відновлення:
- перевірити помилку
- викликати
whoami, якщо незрозуміло щодо дозволів - викликати
get-offering, якщо незрозумілий поточний стан чернетки - виправити лише конкретні невалідні або відсутні дані
- знову викликати
check-offering-publish-readinessперед публікацією
Помилки дозволів
Помилка дозволів означає, що автентифікована інтеграція не має необхідного scope.
| Операція | Необхідний scope |
|---|---|
| перегляд/читання/перевірка | catalog:read |
| створення/оновлення/переклад/відкидання | catalog:write |
| публікація/зняття з продажу | catalog:publish |
Відновлення:
- викликати
whoami - підтвердити надані scope
- запросити надання відсутнього scope
Помилки «не знайдено»
Пропозицію може не бути знайдено, якщо:
offeringIdє хибним- пропозиція належить іншій компанії
- інтеграція автентифікована для іншої компанії
Відновлення:
- викликати
list-offeringsз назвою, SKU або іншим відомим ідентифікатором - підтвердити обрану пропозицію перед її мутацією
Помилки валідації
Помилки валідації зазвичай означають, що форма вхідних даних або значення поля є невалідними.
Типові причини:
| Причина | Виправлення |
|---|---|
category_id без category_label | Вкажіть обидва поля. |
| Невалідний мовний код | Використайте get-supported-languages. |
| Основна мова включена до перекладів | Видаліть основну мову з перекладів. |
| Невалідний код одиниці виміру | Використайте валідний 3-символьний код одиниці. |
Атрибут має unit, але нечислове значення | Використайте числове значення. |
Атрибут має valueLabel, але нерядкове значення | Використайте рядкове значення. |
Спроба змінити kind або language | Відкиньте чернетку та створіть нову пропозицію. |
Помилки готовності до публікації
check-offering-publish-readiness повертає:
{
offeringId: string
publishable: boolean
errors: unknown[]
}Якщо publishable має значення false, не викликайте publish-offering.
Типові проблеми готовності:
- відсутня назва, опис або одиниця виміру основною мовою
- відсутні переклади для підтримуваних мов (крім основної)
- відсутні перекладені мітки категорій
- відсутні переклади атрибутів
- невалідне поєднання значення атрибута та одиниці виміру
- відсутні перекладені описи атрибутів або мітки значень
Відновлення:
- виправити повернені помилки
- знову викликати
check-offering-publish-readiness - публікувати лише тоді, коли
publishableмає значенняtrue
Помилки життєвого циклу чернетки
Якщо kind або language є хибними, не намагайтеся їх виправити патчем.
Ці поля є незмінними. Правильний спосіб відновлення — відкинути чернетку за допомогою discard-offering-draft і створити нову пропозицію.
Якщо пропозиція вже має опубліковану поточну версію, відкидання чернетки не видаляє активну версію.
Помилки публікації
publish-offering може не виконатися, якщо чернетка є неповною або невалідною.
Відновлення:
- викликати
check-offering-publish-readiness - виправити повернені помилки
- спробувати публікацію лише після підтвердження готовності
Збої запитів до бекенду
Інструмент може повернути збій запиту, якщо запит до бекенду завершується невдало до отримання валідної відповіді.
Відновлення:
- повторити ту саму операцію лише для читання, якщо це доцільно
- уникати повторення викликів мутацій, якщо поточний стан не перевірено за допомогою
get-offering - повідомити про повідомлення про помилку, якщо збій повторюється