Rozwiązywanie problemów

Narzędzia się nie pojawiają

To najczęstszy problem, a przyczyną prawie zawsze jest klucz.

Klucz, którego platforma nie akceptuje, przerywa całe połączenie. Twój klient zgłosi, że nie mógł się połączyć, zamiast połączyć się z krótszą listą narzędzi. Dlatego „brak narzędzi" i „nie mogę się połączyć" to zwykle ten sam problem w dwóch odsłonach.

Sprawdź po kolei:

1. Sam klucz. Skopiuj go ponownie z ustawień workspace'u. Musi zaczynać się od mk_live_ i zawierać kropkę. Klucz ucięty przy wklejaniu to zdecydowanie najczęstsza przyczyna.
2. Nagłówek. W Cursorze "Authorization": "Bearer TWOJ_KLUCZ" — słowo Bearer, jedna spacja, potem klucz. Działa też "X-Api-Key": "TWOJ_KLUCZ", bez przedrostka.
3. Niepodmieniony placeholder. Jeśli w konfiguracji nadal stoi coś w rodzaju ${QAMERA_API_KEY} albo TWOJ_KLUCZ_QAMERA_AI, to właśnie ten tekst zostaje wysłany.
4. Przypadkowe spacje albo złamanie wiersza wewnątrz klucza.
5. Czy klucz nie został unieważniony lub nie wygasł. Sprawdź to w ustawieniach workspace'u i w razie potrzeby utwórz nowy.
6. Dopiero na końcu klient. Uruchom go ponownie po zapisaniu pliku konfiguracyjnego i upewnij się, że JSON jest poprawny — bez przecinka na końcu listy, a wpis serwera wewnątrz mcpServers.

Serwer pisze, że nie udało się sprawdzić klucza

To inny komunikat i inny problem: oznacza, że nie udało się połączyć z platformą, żeby potwierdzić klucz — a nie, że klucz został odrzucony.

Nie twórz nowego klucza. Twój nie został odrzucony. Odczekaj chwilę i połącz się ponownie. Jeśli to się utrzymuje, sprawdź najpierw serwer:

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

a potem napisz do nas — ten problem jest po naszej stronie, nie po Twojej.

Działa wszystko poza sprawdzaniem statusu generowania

Jeśli asystent wypisuje produkty, zamawia generowanie i pokazuje podglądy, ale zgłasza błąd zawsze, gdy sprawdza, czy generowanie się skończyło, kluczowi brakuje jednego uprawnienia.

Sprawdzanie statusu wymaga Odczytu statusu treści (content.read). Cała reszta wymaga Rejestrowania treści (content.register). Przy tworzeniu klucza nic nie jest zaznaczone domyślnie, więc łatwo skończyć z kluczem mającym tylko pierwsze uprawnienie.

Wygląda to jak zatrzymane generowanie, a nim nie jest. Generowanie działa normalnie; odrzucane jest samo pytanie o nie. Utwórz nowy klucz z oboma zaznaczonymi uprawnieniami, zaktualizuj konfigurację klienta i usuń stary klucz.

W ogóle nie da się połączyć

Jeśli połączenie zawodzi, zanim w ogóle dojdzie do pytania o klucz:

1. Wykonaj sprawdzenie stanu serwera powyżej. Jeśli odpowiada, serwer działa, a problem jest bliżej Ciebie.
2. Sprawdź, czy adres w konfiguracji to dokładnie https://mcp.qamera.ai — z https i bez żadnej ścieżki na końcu.
3. Sprawdź zaporę sieciową albo proxy. Jeśli nadal korzystasz ze starszego adresu, używa on portu 3002, który bywa blokowany w sieciach firmowych; obecny adres działa po zwykłym HTTPS.
4. Jeśli korzystasz z VPN, spróbuj bez niego.

Żądania zaczynają się nie udawać co jakiś czas

To ograniczenie liczby żądań. Poproś asystenta, żeby zwolnił — dodał przerwę między operacjami wsadowymi i nie uruchamiał kilku sesji na tym samym kluczu naraz. Jeśli Twoja praca naprawdę wymaga wyższego limitu, napisz do nas.

Generowanie kończy się błędem o kredytach

Sprawdź stan konta w sekcji Kredyty w Qamera AI i doładuj je albo zmień plan.

Przeglądanie list, otwieranie podglądów i zapisywanie ocen nic nie kosztuje. Kredyty zużywają wyłącznie kroki, które generują: packshoty, sesje zdjęciowe, modele, scenerie i filmy.

Nadal nie działa

Napisz do zespołu Qamera AI swoim zwykłym kanałem wsparcia i dołącz to, co zgłosił Twój klient, oraz mniej więcej kiedy. Nigdy nie wysyłaj klucza API — ani w wiadomości, ani na zrzucie ekranu. Jeśli podejrzewasz, że klucz wyciekł, usuń go w ustawieniach workspace'u i utwórz nowy.