JobHunt dla Claude i innych asystentów AI

Instrukcja konektora · English version

JobHunt pilnuje zapisanych ofert i wysłanych aplikacji: ich statusu, notatek, kolejnych kroków i historii. Konektor JobHunt pozwala asystentowi AI, np. Claude, czytać tę listę, a jeśli na to pozwolisz, także ją za Ciebie aktualizować. To zdalny serwer Model Context Protocol (MCP) pod adresem:

https://jobhunt.bieda.it/mcp

Zanim zaczniesz

Konto w JobHunt na jobhunt.bieda.it. Dopóki JobHunt działa w zamkniętej becie, nowe konto wymaga zaproszenia.
Asystent, do którego można dodać zdalny serwer MCP, np. Claude (aplikacja w przeglądarce i na komputer oraz Claude Code). W planach Team i Enterprise konektor najpierw dodaje właściciel organizacji.

Łączenie

Claude (przeglądarka i aplikacja na komputer)

Otwórz Ustawienia → Konektory i wybierz Dodaj własny konektor.
Nazwij go JobHunt i podaj adres https://jobhunt.bieda.it/mcp.
Wybierz Połącz. Claude otworzy JobHunt, gdzie się zalogujesz.
JobHunt pokaże, kto prosi o dostęp i dokąd wrócisz. Zostaw sam odczyt albo zaznacz Pozwól mu dodawać i zmieniać oferty, a potem wybierz Zezwól.
Po powrocie do Claude włącz konektor w rozmowie i zadaj pierwsze pytanie. Dodany konektor jest też dostępny w aplikacjach mobilnych Claude.

Claude Code

claude mcp add --transport http --scope user jobhunt https://jobhunt.bieda.it/mcp

Rozpocznij nową sesję, wpisz /mcp, wybierz jobhunt, a potem Authenticate. Przeglądarka otworzy tę samą stronę JobHunt co wyżej.

Inne klienty MCP

Użyj powyższego adresu z transportem Streamable HTTP. Serwer obsługuje OAuth 2.1 z PKCE i dynamiczną rejestracją klienta, więc klient zgodny ze specyfikacją autoryzacji MCP nie wymaga dodatkowej konfiguracji.

Na co asystent może sobie pozwolić

Przy łączeniu wybierasz jeden z dwóch poziomów. Bez Twojej decyzji na stronie JobHunt asystent nie dostaje niczego:

Poziom	Na co pozwala
Tylko odczyt (domyślnie)	Czytanie Twoich ofert, notatek, tagów, kolejnych kroków i historii.
Dodawanie i zmiany	Dodatkowo: dodawanie ofert, zmiana ich danych i statusu, dopisywanie notatek i tagów.

Na żadnym poziomie asystent nie usunie oferty, nie zastąpi ani nie wymaże Twoich notatek, nie usunie tagu, nie wyeksportuje danych i nie zobaczy ani nie zmieni konta, hasła, ustawień czy innych połączeń. Przed każdą zmianą Claude prosi Cię o potwierdzenie.

Narzędzia

Narzędzie	Co robi	Poziom
`list_jobs`	Lista ofert i aplikacji, z filtrem po statusie, firmie, tagu lub słowach, bez opisów i notatek.	Odczyt
`get_job`	Wszystko o jednej ofercie: opis, Twoje notatki, tagi, kolejny krok i historia.	Odczyt
`list_follow_ups`	Otwarte rekrutacje bez zmian od dłuższego czasu (14 dni, jeśli tego nie zmieniłeś), od najdłużej milczących.	Odczyt
`add_job`	Dodaje ofertę lub aplikację.	Zmiany
`update_job`	Zmienia dane oferty: tytuł, firmę, link, lokalizację, wynagrodzenie, opis, kolejny krok.	Zmiany
`change_status`	Przenosi ofertę do innego statusu i zapisuje to w historii.	Zmiany
`add_history_note`	Zapisuje, co się wydarzyło, bez zmiany statusu.	Zmiany
`log_follow_up`	Zapisuje, że przypomniałeś się firmie.	Zmiany
`append_notes`	Dopisuje tekst na końcu Twoich notatek do oferty.	Zmiany
`add_tag`	Dodaje tag do oferty.	Zmiany

Przykładowe polecenia

Te działają przy połączeniu tylko do odczytu:

O które rekrutacje powinienem się przypomnieć? Przygotuj krótką wiadomość do każdej firmy.
Co mnie czeka w poszukiwaniu pracy w najbliższych siedmiu dniach?
Podsumuj moją aplikację do Globex i pomóż mi przygotować się do rozmowy technicznej.
Jak idzie moje poszukiwanie pracy? Podaj liczby dla każdego etapu i powiedz, co zwraca uwagę.

Te wymagają połączenia, które może dodawać i zmieniać:

Contoso Cloud zaprosiło mnie na rozmowę techniczną w przyszły wtorek o 10:00. Zaktualizuj aplikację.
Zapisz ofertę: Senior Platform Engineer w Acme, zdalnie, 28 000 PLN netto B2B, https://example.com/jobs/123. Dodaj tag kubernetes.
Wysłałem dziś przypomnienia do Northwind Systems i Contoso Cloud. Zapisz to.

Odłączanie

W JobHunt otwórz Konto → Asystent AI. Są tam wszystkie połączone asystenty, z tym, na co mogą sobie pozwolić i kiedy były ostatnio używane; Odłącz od razu kończy dostęp. Samo usunięcie konektora w Claude nie informuje o tym JobHunt, więc odłącz go także w JobHunt. Połączenie nieużywane przez 60 dni kończy się samo, a każde trzeba zatwierdzić ponownie po 180 dniach.

Prywatność i bezpieczeństwo

Asystent dostaje tylko to, co narzędzie zwraca w odpowiedzi na Twoje pytanie: Twoje oferty, notatki i historię. Nigdy nie dostaje Twojego hasła i nie ma dostępu do danych innych osób.
JobHunt nie dostaje Twojej rozmowy. Widzi wywołania narzędzi (np. „lista ofert z tagiem kubernetes”) i nie zapisuje o nich nic poza czasem ostatniego użycia połączenia oraz zmianami, o które poprosiłeś.
To, co asystent robi z odczytanymi danymi, regulują regulamin i polityka prywatności jego dostawcy (dla Claude: Anthropic).
Opisy ofert pochodzą z zewnętrznych stron i ogłoszenie może zawierać tekst, który ma wprowadzić asystenta w błąd. Dlatego połączenie domyślnie tylko czyta, niczego nie da się przez nie usunąć, a Claude pyta przed każdą zmianą.

Zobacz Politykę prywatności i Regulamin.

Rozwiązywanie problemów

Komunikaty, które asystent dostaje od JobHunt, są po angielsku, więc są tu przytoczone w tej formie.

Co widzisz	Co zrobić
Claude mówi, że nie może niczego dodać ani zmienić	Połączenie jest tylko do odczytu. Odłącz je w Konto → Asystent AI, połącz ponownie i zaznacz Pozwól mu dodawać i zmieniać oferty.
„Needs authentication” albo konektor prosi o ponowne połączenie	Połączenie wygasło (odłączone w JobHunt, nieużywane przez 60 dni albo starsze niż 180 dni). Wybierz ponownie Połącz; w Claude Code: `/mcp` → jobhunt → Authenticate.
„The user has to accept the updated terms of service”	Otwórz JobHunt w przeglądarce, zaakceptuj nowy regulamin i zapytaj ponownie.
JobHunt pokazuje „Tego żądania nie można użyć” zamiast przycisku Zezwól	Link jest niepełny albo został po drodze zmieniony. Zamknij kartę i zacznij łączenie od nowa w asystencie.
JobHunt ostrzega, że żądanie pochodzi z programu na Twoim komputerze	Tak ma być dla Claude Code i innych aplikacji uruchamianych na komputerze. Zezwól tylko wtedy, gdy przed chwilą samodzielnie zacząłeś łączenie.
Nie możesz się zalogować ani założyć konta	W zamkniętej becie konto wymaga zaproszenia. Poproś o nie przez kontakt poniżej.
„A job with this URL is already on the list”	Ta oferta jest już zapisana. Poproś asystenta, żeby ją znalazł i zaktualizował.
„Too many changes – try again later” albo komunikat o limicie konta	JobHunt ogranicza tempo dodawania ofert i pojemność konta. Odczekaj minutę albo usuń stare oferty w aplikacji.
Claude Code nie pokazuje jobhunt w `/mcp`	Serwer został dodany tylko dla jednego folderu. Dodaj go ponownie z `--scope user`, jak wyżej, i rozpocznij nową sesję.
JobHunt informuje, że połączono zbyt wielu asystentów	Odłącz nieużywanego asystenta w Konto → Asystent AI.

Pomoc

Napisz na [email protected] albo dodaj wpis w zakładce Pomysły w aplikacji. Problem z bezpieczeństwem zgłoś e-mailem, nie publicznie.