Усунення несправностей

Інструменти не з'являються

Це найчастіша ситуація, і причиною майже завжди є ключ.

Ключ, якого платформа не приймає, обриває все з'єднання. Ваш клієнт повідомить, що не зміг під'єднатися, а не під'єднається з коротшим переліком інструментів. Тому «немає інструментів» і «не можу під'єднатися» — зазвичай одна й та сама проблема у двох виглядах.

Перевіряйте по черзі:

1. Сам ключ. Скопіюйте його ще раз із налаштувань робочого простору. Він має починатися з mk_live_ і містити крапку. Обрізаний під час вставляння ключ — найчастіша причина.
2. Заголовок. У Cursor "Authorization": "Bearer ВАШ_КЛЮЧ" — слово Bearer, один пробіл, далі ключ. Працює також "X-Api-Key": "ВАШ_КЛЮЧ", без префікса.
3. Незамінений заповнювач. Якщо в конфігурації досі стоїть щось на кшталт ${QAMERA_API_KEY} або ВАШ_КЛЮЧ_QAMERA_AI, саме цей текст і надсилається.
4. Зайві пробіли або перенесення рядка всередині ключа.
5. Чи ключ не відкликаний і не сплив його термін. Перевірте це в налаштуваннях робочого простору та за потреби створіть новий.
6. І лише потім клієнт. Перезапустіть його після збереження файлу конфігурації та переконайтеся, що JSON коректний — без коми в кінці переліку, а запис сервера всередині mcpServers.

Сервер пише, що не вдалося перевірити ключ

Це інше повідомлення й інша проблема: воно означає, що не вдалося звернутися до платформи, аби підтвердити ключ, а не що ключ відхилено.

Не створюйте новий ключ. Ваш ніхто не відхиляв. Зачекайте трохи й під'єднайтеся знову. Якщо це триває, спершу перевірте сервер:

curl https://mcp.qamera.ai/health

а потім напишіть нам — ця проблема на нашому боці, не на вашому.

Працює все, крім перевірки статусу генерування

Якщо асистент виводить продукти, замовляє генерування та показує попередні перегляди, але повідомляє про помилку щоразу, коли перевіряє, чи генерування завершилося, ключеві бракує одного дозволу.

Перевірка статусу потребує Читання статусу контенту (content.read). Усе решта потребує Реєстрації контенту (content.register). Під час створення ключа нічого не позначено за замовчуванням, тож легко лишитися з ключем, що має тільки перший дозвіл.

Це має вигляд зупиненого генерування, але ним не є. Генерування працює нормально; відхиляється саме питання про нього. Створіть новий ключ з обома позначеними дозволами, оновіть конфігурацію клієнта та видаліть старий ключ.

Узагалі не вдається під'єднатися

Якщо з'єднання не вдається ще до питання про ключ:

1. Виконайте перевірку стану сервера вище. Якщо він відповідає, сервер працює, а проблема ближче до вас.
2. Перевірте, що адреса в конфігурації — точно https://mcp.qamera.ai, із https і без жодного шляху після неї.
3. Перевірте фаєрвол або проксі. Якщо ви досі на старішій адресі, вона використовує порт 3002, який у корпоративних мережах іноді заблоковано; поточна адреса працює звичайним HTTPS.
4. Якщо ви на VPN, спробуйте без нього.

Запити час від часу починають не спрацьовувати

Це обмеження кількості запитів. Попросіть асистента сповільнитися — додати паузу між пакетними операціями й не запускати кілька сесій з одним ключем водночас. Якщо ваша робота справді потребує вищого ліміту, напишіть нам.

Генерування завершується помилкою про кредити

Перевірте баланс у розділі Кредити в Qamera AI і поповніть його або змініть план.

Перегляд списків, відкриття попередніх переглядів і збереження оцінок нічого не коштують. Кредити витрачають лише кроки, що генерують: пекшоти, фотосесії, моделі, сценерії та відео.

Досі не працює

Напишіть команді Qamera AI своїм звичним каналом підтримки й додайте те, що повідомив ваш клієнт, і приблизний час. Ніколи не надсилайте ключ API — ані в повідомленні, ані на знімку екрана. Якщо припускаєте, що ключ став відомий стороннім, видаліть його в налаштуваннях робочого простору та створіть новий.