​

Rozwiązywanie problemów

​

Problemy z połączeniem

​

Serwer nie odpowiada

• Asystent AI nie może się połączyć z serwerem MCP
• Błędy timeout
• Odmowa połączenia

https://mcp.hexjobs.com/mcp

{
  "mcpServers": {
    "hexjobs": {
      "url": "https://mcp.hexjobs.com/mcp"
    }
  }
}

​

Narzędzia są niedostępne

• Serwer MCP łączy się, ale narzędzia nie pojawiają się
• Asystent mówi “Nie mam dostępu do narzędzi wyszukiwania ofert”

1. Zweryfikuj status połączenia
   • Sprawdź, czy serwer MCP pokazuje się jako połączony w twoim kliencie
   • Szukaj zielonego wskaźnika lub statusu “połączony”
2. Uruchom ponownie klienta
   • Całkowicie zamknij i uruchom ponownie asystenta AI
   • Poczekaj na inicjalizację MCP
3. Sprawdź logi
   • Claude Desktop: Szukaj błędów w konsoli deweloperskiej
   • LM Studio: Sprawdź logi serwera MCP
   • Cursor: Sprawdź panel wyjściowy
4. Przeinstaluj konfigurację
   • Usuń serwer z konfiguracji
   • Zapisz plik
   • Dodaj ponownie konfigurację serwera
   • Uruchom ponownie klienta

​

Problemy z wyszukiwaniem

​

Nie znaleziono wyników

• Wyszukiwanie zwraca puste wyniki
• "total": 0 w odpowiedzi

Jakie kategorie ofert są dostępne?
Ile ofert w Polsce?

​

Nieoczekiwane wyniki

• Wyniki nie pasują do zapytania
• Zwrócone nieistotne oferty pracy

1. Bądź bardziej szczegółowy
   Kopiuj

   ❌ "Znajdź oferty"
   ✅ "Znajdź oferty programisty Python w Warszawie"
   
2. Użyj filtrów
   Kopiuj

   ❌ "Oferty IT"
   ✅ "Oferty IT w Polsce, poziom senior, praca zdalna"
   
3. Sprawdź pisownię
   • Nazwy miast: “Warszawa” nie “Warsaw” dla polskich ofert
   • Nazwy kategorii: Użyj dokładnych nazw z available_categories
4. Zrozum wyszukiwanie semantyczne
   • Wyszukiwanie automatycznie znajduje podobne terminy
   • “CTO” znajduje również “Chief Technology Officer”, “Dyrektor Techniczny”
   • To jest funkcja, nie błąd!

​

Problemy z konfiguracją

​

Claude Desktop nie wczytuje konfiguracji

• Zmiany w pliku konfiguracyjnym nie działają
• Stara konfiguracja nadal aktywna

# 1. Zamknij całkowicie Claude
killall Claude

# 2. Zweryfikuj lokalizację pliku konfiguracyjnego
cat ~/Library/Application\ Support/Claude/claude_desktop_config.json

# 3. Sprawdź składnię JSON
python3 -m json.tool ~/Library/Application\ Support/Claude/claude_desktop_config.json

# 4. Uruchom ponownie Claude
open -a Claude

​

Błędy składni JSON

• Plik konfiguracyjny nie jest parsowany
• Klient nie uruchamia się

{
  "mcpServers": {
    "hexjobs": {
      "url": "https://mcp.hexjobs.com/mcp"
    }  // Brakujący przecinek jeśli więcej wpisów następuje
    "other": {
      "url": "..."
    }
  }
}

​

Problemy z wydajnością

​

Wolne odpowiedzi

• Wyszukiwania zajmują dużo czasu
• Występują timeouty

1. Zmniejsz zestaw wyników
   • Użyj mniejszego limit (domyślnie jest 20)
   • Dodaj bardziej szczegółowe filtry
   • Zawęź kryteria wyszukiwania
2. Sprawdź prędkość internetu
   • Przetestuj połączenie z serwerem
   • Spróbuj na innej sieci
3. Uprość zapytanie
   • Unikaj bardzo złożonych wyszukiwań z wieloma filtrami
   • Podziel na wiele prostszych zapytań

​

Limity zapytań

• Błędy “Zbyt wiele zapytań”
• Tymczasowe blokady

• Dodaj opóźnienia między automatycznymi zapytaniami
• Użyj paginacji zamiast wielu wyszukiwań
• Cachuj wyniki gdy to możliwe
• Użyj offers_count przed pobieraniem pełnych danych

​

Problemy z danymi

​

Brakujące pola danych

• Niektóre oferty pracy nie mają informacji o wynagrodzeniu
• Brak logo firmy
• Niekompletne opisy

• Wynagrodzenie: wiele firm nie publikuje przedziałów wynagrodzeń
• Loga: niektóre firmy nie dostarczają log
• Opisy: jakość różni się w zależności od źródła

​

Nieaktualne oferty

• Zwrócone stare ogłoszenia o pracę
• Wygasłe stanowiska

1. Mogą być nadal aktywne
2. Firma nie ustawiła daty wygaśnięcia
3. Stanowisko może być evergreen (zawsze rekrutują)

​

Problemy specyficzne dla klientów

​

LM Studio

• Upewnij się, że LM Studio jest zaktualizowany
• Spróbuj zamiast tego konfiguracji ręcznej
• Sprawdź dokumentację MCP w LM Studio

​

ChatGPT Desktop

mkdir -p ~/Library/Application\ Support/OpenAI/ChatGPT

New-Item -ItemType Directory -Force -Path "$env:APPDATA\OpenAI\ChatGPT"

​

Cursor

1. Zaktualizuj Cursor do najnowszej wersji
2. Włącz Features → Model Context Protocol w ustawieniach
3. Uruchom ponownie Cursor

​

Cline

1. Sprawdź, czy rozszerzenie Cline jest w najnowszej wersji
2. Przeładuj okno VS Code
3. Sprawdź panel wyjściowy VS Code pod kątem błędów

​

Uzyskiwanie pomocy

​

Przed skontaktowaniem się ze wsparciem

​

Kontakt ze wsparciem

• Nazwa klienta i wersja (Claude Desktop 1.2.3, itd.)
• System operacyjny (macOS 14.0, Windows 11, itd.)
• Komunikaty błędów (dokładny tekst lub zrzuty ekranu)
• Plik konfiguracyjny (usuń dane wrażliwe)
• Kroki do odtworzenia problemu

​

Podsumowanie typowych rozwiązań

​

Znane ograniczenia

​

Prośby o funkcje

• Email: contact@hexjobs.com
• GitHub: github.com/apptivitypl

• Wyszukiwanie wieloregionalne (zaimplementowane!)
• Wyszukiwanie semantyczne (zaimplementowane!)
• Webhooki w czasie rzeczywistym (planowane)
• Śledzenie aplikacji (planowane)