Qamera AI
Wypróbuj za darmo

Rozwiązywanie problemów

Najczęstsze problemy i ich rozwiązania podczas korzystania z serwera MCP Qamera AI. Obejmuje problemy z połączeniem, błędy uwierzytelniania, ograniczenia częstotliwości zapytań i inne.

Sprawdzanie stanu

Przed diagnozowaniem konkretnych problemów zweryfikuj, czy serwer MCP działa:

curl http://162.55.224.224:3002/health

Pomyślna odpowiedź oznacza, że serwer jest online i przyjmuje połączenia. Jeśli to się nie powiedzie, serwer może być wyłączony lub niedostępny z Twojej sieci.

Problemy z połączeniem

Serwer nie odpowiada

Objawy: Twój klient AI wyświetla komunikat "connection failed" lub "server unreachable".

Możliwe przyczyny:

  • Hostowany serwer może być tymczasowo niedostępny
  • Twoja sieć może blokować połączenie (firewall, VPN, proxy)
  • URL serwera jest nieprawidłowy

Rozwiązania:

  1. Uruchom powyższe sprawdzenie stanu, aby zweryfikować status serwera
  2. Sprawdź ustawienia firewalla — serwer działa na porcie 3002
  3. Zweryfikuj, czy URL w konfiguracji odpowiada http://162.55.224.224:3002/mcp
  4. Jeśli korzystasz z VPN, spróbuj połączyć się bez niego

Narzędzia MCP nie pojawiają się

Objawy: Twój asystent AI nie oferuje narzędzi Qamera AI.

Rozwiązania:

  • Cursor: Uruchom ponownie Cursor po zapisaniu .cursor/mcp.json
  • Claude Desktop: Uruchom ponownie aplikację po aktualizacji konfiguracji
  • Zweryfikuj, czy Twój plik JSON konfiguracji jest poprawny (brak końcowych przecinków, prawidłowa struktura)
  • Sprawdź, czy wpis serwera MCP znajduje się pod kluczem mcpServers

Błędy uwierzytelniania

Nieprawidłowy klucz API

Objawy: Żądania kończą się błędem uwierzytelniania lub "unauthorized".

Rozwiązania:

  1. Zweryfikuj poprawność klucza API — skopiuj go ponownie z ustawień konta Qamera AI
  2. Sprawdź format nagłówka:
    • Cursor SSE: "Authorization": "Bearer YOUR_KEY" (z prefiksem "Bearer ")
    • Alternatywnie: "X-Api-Key": "YOUR_KEY" (bez prefiksu)
  3. Upewnij się, że w kluczu nie ma dodatkowych spacji ani znaków nowej linii
  4. Wygeneruj nowy klucz, jeśli obecny mógł zostać unieważniony

Wygasły klucz API

Objawy: Wcześniej działające połączenie nagle zwraca błędy uwierzytelniania.

Rozwiązania:

  1. Zaloguj się do Qamera AI i sprawdź status klucza API
  2. W razie potrzeby wygeneruj nowy klucz API
  3. Zaktualizuj klucz w konfiguracji klienta MCP
  4. Uruchom ponownie klienta AI

Ograniczenia częstotliwości zapytań

Objawy: Żądania sporadycznie kończą się błędami limitu częstotliwości, szczególnie podczas operacji zbiorczych.

Rozwiązania:

  1. Zmniejsz częstotliwość żądań — dodaj przerwy między operacjami zbiorczymi
  2. Unikaj jednoczesnego uruchamiania wielu sesji MCP z tym samym kluczem API
  3. Jeśli potrzebujesz wyższych limitów, skontaktuj się z zespołem Qamera AI

Niewystarczające kredyty

Objawy: Żądania generowania treści kończą się błędem związanym z kredytami.

Rozwiązania:

  1. Sprawdź saldo kredytów w panelu Qamera AI w sekcji Kredyty
  2. Dokup dodatkowe kredyty lub ulepsz swój plan subskrypcji
  3. Operacje tylko do odczytu (wyświetlanie produktów, przeglądanie packshotów) nie zużywają kredytów

Problemy z serwerem lokalnym

Jeśli uruchamiasz serwer MCP lokalnie:

Błędy kompilacji

cd mcp-server-for-shorts-lab
npm install
npm run build

Upewnij się, że masz zainstalowany Node.js (wersja 18 lub nowsza).

Konfiguracja środowiska

Utwórz plik .env w katalogu serwera:

QAMERA_AI_API_BASE_URL=https://qamera.ai
PORT=3002

Port już jest w użyciu

Jeśli port 3002 jest zajęty, zmień go w pliku .env i odpowiednio zaktualizuj konfigurację klienta.

Potrzebujesz dalszej pomocy?

  • Sprawdź repozytorium serwera MCP, aby uzyskać najnowszą dokumentację
  • Zgłoś problem w repozytorium w przypadku problemów specyficznych dla serwera
  • Skontaktuj się z zespołem wsparcia Qamera AI w sprawach dotyczących konta lub platformy