Integracje

Połącz asystentów AI (MCP)

Połącz dowolnego asystenta AI zgodnego z MCP — Claude, Claude Code, ChatGPT, Cursor, VS Code i inne — z danymi rekrutacyjnymi Flowmingo i zarządzaj swoim procesem w prostym języku.

Our team is online
Potrzebujesz pomocy z integracją?

Utknąłeś na którymś z kroków lub potrzebujesz wsparcia technicznego? Nasz zespół chętnie pomoże — napisz do nas o dowolnej porze, a my pomożemy Ci wszystko połączyć.

Przegląd

Połącz dowolnego asystenta AI zgodnego z MCP ze swoimi danymi rekrutacyjnymi Flowmingo — czytaj swoje oferty pracy i kandydatów oraz wykonuj chronione działania (zapraszanie, przenoszenie, odrzucanie, usuwanie z projektu), bezpiecznie i za Twoją zgodą. Dzięki dwóm dodatkowym uprawnieniom, które sam włączysz, asystent może również tworzyć projekty rekrutacyjne i oceny oraz publikować, zamykać lub promować ofertę pracy (zobacz Co możesz zrobić). Nowy w MCP? To otwarty standard, który pozwala asystentom AI komunikować się z narzędziami takimi jak Flowmingo. Dowiedz się, czym jest MCP.

Transport: Streamable HTTP (nowoczesny transport zdalny). Nie ma starszego SSE — zawsze kieruj klienta na /mcp, nigdy na /sse.

Traktuj swój klucz API jak hasło. Preferuj OAuth, monitowane wprowadzenie lub zmienną środowiskową zamiast wklejania surowego klucza fl_... do pliku, który możesz zatwierdzić w git (np. .vscode/mcp.json, ~/.cursor/mcp.json, config Continue).

Uwierzytelnianie — dwie opcje

A — Zaloguj się przez Flowmingo (OAuth, zalecane). Twoja przeglądarka otworzy stronę zgody Flowmingo; wklejasz tam swój klucz API. Asystent nigdy nie otrzymuje Twojego surowego klucza. Otrzymuje token dostępu i token odświeżania, które może użyć do uzyskania nowego tokena dostępu. Logowanie nie trwa wiecznie. Token odświeżania żyje domyślnie około 30 dni, licząc od jego wydania, przy logowaniu lub przy ostatnim odświeżeniu, więc logowanie, które nie jest używane przez ten czas, wygasa, a wydanie Flowmingo, które zmienia sposób przechowywania logowań, może wymagać ponownego zalogowania. Asystent poprosi Cię wtedy o ponowne zalogowanie, a Ty ponownie wklejasz swój klucz. Aby przerwać wcześniej, usuń ten klucz API. Nie ma potrzeby tworzenia identyfikatora klienta ani sekretu (Flowmingo używa Dynamic Client Registration). Na klientach, które pokazują „Zaawansowane” ustawienia OAuth (np. Claude.ai), pozostaw pola Client ID i Secret puste.

B — Statyczny klucz API (nagłówek). Wyślij swój klucz jako jeden z nagłówków:

x-api-key: fl_YOUR_KEY
Authorization: Bearer fl_YOUR_KEY

Uzyskaj swój klucz w Flowmingo → Ustawienia → Integracje → Klucze API. Zaznacz Read hiring data i Read candidates — pierwszy obejmuje oferty pracy, pipeline i wyniki, drugi pozwala asystentowi znaleźć kandydata. Dodaj Manage pipeline / Invite candidates dla chronionych operacji zapisu. Aby umożliwić asystentowi tworzenie projektów i ocen oraz publikowanie lub promowanie oferty pracy, zaznacz również Create hiring projects i Create assessments. Przeczytaj Tworzenie i publikowanie w sekcji Co możesz zrobić najpierw: te dwa uprawnienia są opcjonalne, a twórca klucza musi być Właścicielem lub Administratorem.

Jak wygląda kompletny klucz. Jedna długa wartość: fl_live_, publiczna nazwa klucza, kropka, a następnie długi sekret. Sekretna połowa jest pokazywana raz, zaraz po utworzeniu klucza; później lista Kluczy API pokazuje tylko jego początek. Wartość bez kropki to tylko nazwa klucza i zostanie odrzucona. Gdziekolwiek ten przewodnik pisze fl_YOUR_KEY, zastąp to wszystko swoim kompletnym kluczem, bez cudzysłowów i spacji.

Jeśli nie można się połączyć. Zły lub pusty klucz zwraca Missing credential lub The Flowmingo API key was rejected; oba mogą oznaczać, że wartość nie dotarła do nas w całości, więc najpierw sprawdź wartość. Ustawienie takie jak ${env:FLOWMINGO_API_KEY} działa tylko wtedy, gdy program może zobaczyć tę zmienną, a edytor otwarty z doku lub menu Start często nie czyta profilu terminala. Uruchom go z terminala, gdzie zmienna jest ustawiona, lub umieść kompletny klucz w pliku (i trzymaj ten plik poza git).

Którą opcję wybrać? Większość klientów obsługuje obie; kilka (np. ChatGPT) jest tylko OAuth — każda zakładka informuje, co obsługuje dany klient. Ogólnie OAuth nadaje się do interaktywnych asystentów (Claude.ai, ChatGPT, VS Code); nagłówek klucza API nadaje się do CLI, bezgłowych/CI i edytorów, gdzie wolisz wstawić klucz.

Co możesz zrobić

Odczyty nie wymagają zatwierdzenia. Większość zapisów jest chroniona. Zaproszenie, odrzucenie wykonane akcją Reject, usunięcie kandydatów z projektu, usunięcie projektu lub, normalnie, przeniesienie do etapu, który jest ustawiony na wysyłkę e-maila do kandydata, czeka na zatwierdzenie przez osobę pod linkiem, zalogowaną do Flowmingo. Asystent nie może tego zatwierdzić, a wpisanie „tak” w czacie się nie liczy. Ustawienie e-maila etapu jest sprawdzane, gdy żądane jest przeniesienie. Dla notatki, oceny, shortlisty, tagu lub przeniesienia do etapu, który nie jest ustawiony na e-mail do kandydata, asystent ma polecenie najpierw pokazać podgląd i działać tylko, gdy się zgodzisz, co jest instrukcją dla niego, a nie blokadą. Monit, który Twój klient AI pokazuje przed uruchomieniem narzędzia, jest jego własny i nie jest zatwierdzeniem Flowmingo: zaproszenie, odrzucenie wykonane akcją Reject i przeniesienie do etapu wysyłającego e-maile nadal czekają na link zatwierdzający, cokolwiek klient zapyta. Link zatwierdzający wygasa po 15 minutach, a jedno żądanie dla kilku kandydatów lub aplikacji (maksymalnie 50) to jedno zatwierdzenie, które wymienia wszystkich. Gdy zmiana jest w fazie oczekiwania, asystent może sprawdzić jej status, wycofać ją, gdy nadal czeka, i cofnąć odwracalną zmianę (notatkę, ocenę, oznaczenie shortlisty, tag lub przeniesienie, które nie wysłało e-maila) w ciągu 24 godzin. Cofnięcie nie zawsze jest dostępne: zmiana musi wrócić z odniesieniem do cofnięcia, zapisanie go jest opcjonalne, a przeniesienie kandydata bez wcześniejszego etapu nie ma takiego odniesienia, więc asystent powinien to sprawdzić i powiedzieć, gdy nie ma drogi powrotu. E-mail, który został wysłany, nie może być cofnięty. Narzędzia wymienione w sekcji Tworzenie i publikowanie są wyjątkiem od tego wszystkiego, z wyjątkiem delete_project: działają natychmiast i nie są przeznaczone do zatwierdzenia. Usunięcie i usunięcie projektu nie mogą być cofnięte. Wszystko jest ograniczone do Twojej organizacji.

Odczyt

Możliwość Co robi
Lista ofert pracy Przeglądaj otwarte i zamknięte role w swojej organizacji.
Lista zestawów rozmów i projektów Zobacz swoje oceny (zestawy rozmów) każdego rodzaju (rozmowy AI, role-play, testy umiejętności, testy techniczne, oceny CV, pokazy i nagrania; kwestionariusze, gdy o nie poprosisz) oraz swoje projekty rekrutacyjne.
Lista pipeline'u kandydatów Przeglądaj aplikacje według etapów w projekcie.
Odczyt wyników ocen i punktacji Pobierz wyniki każdego rodzaju: rozmowy AI, role-play, testy umiejętności, testy techniczne, oceny CV, pokazy, nagrania i kwestionariusze. Każdy wynik jest oznaczony swoim rodzajem. Tylko niektóre rodzaje mają wynik AI: pokaz i kwestionariusz nigdy nie są punktowane, a test umiejętności to procent.
Wyszukaj kandydata Pobierz imię, e-mail i CV jednego kandydata.
Szukaj kandydatów Znajdź kandydatów po imieniu lub e-mailu.
Porównaj kandydatów Ustaw obok siebie od 2 do 10 kandydatów. Wymaga uprawnień Read candidates oraz Read hiring data.
Przegląd rekrutacji Lejek dla wszystkiego, do czego Twoje połączenie ma dostęp (cała firma, chyba że klucz został utworzony przez osobę ograniczoną do niektórych projektów) lub zawężony, gdy poprosisz: aplikacje według etapów, aktywne vs odrzucone, a dla każdego rodzaju oceny, który ma wyniki, ukończone vs w toku wyniki i średnia punktacja. Projekt zawęża wszystkie liczby, ale jego liczby wyników obejmują wyniki ocen powiązanych z tym projektem, więc kandydat z innego projektu, który ma jedną z tych ocen, może być również liczony. Ocena zawęża tylko liczby wyników: liczby etapów i aplikacji pozostają na poziomie wszystkiego, do czego Twoje połączenie ma dostęp. Rodzaje nigdy nie są sumowane.
Najlepsi kandydaci Najwyżej oceniane wyniki, uporządkowane według ogólnej punktacji. Wszystkie rodzaje ocen są rankingowane razem, chyba że poprosisz o jeden rodzaj lub jedną ocenę (zestaw rozmów).
Szczegóły wyniku oceny Wynik jednego wyniku według kompetencji plus podsumowanie AI, dla rodzajów, które je mają. Test umiejętności, test techniczny, pokaz i kwestionariusz mają ich niewiele lub wcale.
Szczegóły oferty pracy Pełne szczegóły pojedynczej oferty pracy.
Czy oferta pracy jest publiczna? (get_job_post_publication) Czy każdy może otworzyć publiczną stronę oferty: aktywna, nadal czekająca na kontrolę treści AI, odrzucona przez nią, oznaczona, wyłączona, lub jej projekt nie jest otwarty. Także jej publiczny adres i jej promocja (wyłączona, flowmingo lub rozszerzona). Wymaga Read hiring data.
Nadchodzące rozmowy Zaproszenia do dowolnego rodzaju oceny, które zostały wysłane lub zaplanowane i nie zostały jeszcze ukończone. To nie jest liczba wszystkich oczekujących: zaproszenie, gdy kandydat został przypomniany, otworzył lub kliknął link, jest pomijane, dopóki kandydat nie zacznie, podobnie jak to, które nie zostało dostarczone.

Zapis (chroniony)

Możliwość Co robi
Zaproś kandydatów do oceny Przygotowuje zaproszenia na rozmowę AI, role-play, test umiejętności lub test techniczny i czeka na zatwierdzenie przez osobę pod linkiem. Nic nie jest wysyłane przed tym. Jedna ocena i maksymalnie 50 kandydatów na żądanie; test umiejętności lub test techniczny wymaga projektu i e-maila dla każdego kandydata, a sponsorowany może obciążyć portfel Twojej organizacji, gdy kandydat go zacznie.
Przenieś kandydata do innego etapu Przeniesienie do etapu, który jest ustawiony na e-mail do kandydata, normalnie czeka na zatwierdzenie przez osobę pod linkiem (ustawienie e-maila etapu jest czytane raz, tuż przed przeniesieniem, więc ustawienie włączone w tym momencie może pozwolić na przeniesienie z e-mailem bez zatwierdzenia). Każde inne przeniesienie: asystent ma polecenie pokazać podgląd i czekać na Twoje „tak”, i zwykle można je cofnąć przez 24 godziny, gdy wróciło z odniesieniem do cofnięcia. Maksymalnie 50 aplikacji na żądanie.
Odrzuć aplikację Żąda zatwierdzenia pod linkiem. Jeśli osoba zatwierdzi, Flowmingo próbuje przenieść aplikację do etapu Odrzucone w projekcie; sprawdź wynik później. Maksymalnie 50 aplikacji na żądanie.
Usuń kandydatów z projektu (remove_application) Wymaga Manage pipeline. Żąda zatwierdzenia pod linkiem. Jeśli osoba zatwierdzi, Flowmingo usuwa aplikacje z projektu; profil kandydata pozostaje w Twojej puli talentów i w innych projektach. To nie jest odrzucenie i nie ma cofnięcia. Maksymalnie 50 aplikacji na żądanie.
Dodaj notatkę do wyniku Asystent ma polecenie pokazać podgląd proponowanej notatki i czekać na Twoje „tak” przed zapisaniem. Notatka należy do jednego wyniku oceny (dowolnego rodzaju), nie do kandydata jako całości.
Oceń wynik Asystent ma polecenie pokazać podgląd oceny i czekać na Twoje „tak”. Ocena dotyczy jednego wyniku oceny.
Dodaj do shortlisty wynik Asystent ma polecenie pokazać podgląd zmiany shortlisty i czekać na Twoje „tak”. Dotyczy jednego wyniku oceny.
Tag / dodaj do kolekcji talentów Asystent ma polecenie pokazać podgląd zmiany tagu lub kolekcji talentów i czekać na Twoje „tak”.
Sprawdź, wycofaj lub cofnij zmianę Sprawdź status oczekującej zmiany (oczekuje, wykonana, nieudana, wygasła lub zastąpiona nowszym żądaniem), wycofaj tę, która nadal czeka na zatwierdzenie, lub cofnij odwracalną zmianę w ciągu 24 godzin, gdy wróciła z odniesieniem do cofnięcia.

Tworzenie i publikowanie (działa natychmiast, z wyjątkiem usuwania projektu)

Te narzędzia tworzą rzeczy i udostępniają je publicznie. Zachowują się inaczej niż chronione zapisy powyżej:

  • Działają natychmiast, z wyjątkiem delete_project. Nic nie jest przeznaczone do zatwierdzenia przez osobę pod linkiem i żadne z nich nie wysyła e-maila do kandydata. delete_project czeka na zatwierdzenie przez Właściciela lub Administratora pod linkiem.
  • Twórca klucza musi być Właścicielem lub Administratorem, dla każdego narzędzia tutaj z wyjątkiem anulowania, które wymaga tylko Invite candidates. Narzędzia działają z uprawnieniami osoby, która utworzyła klucz API. Jeśli ta osoba jest Członkiem, wywołanie zostanie odrzucone.
  • Dwa uprawnienia są opcjonalne. Create hiring projects i Create assessments nie są nadawane domyślnie. Przy logowaniu (opcja A) asystent otrzymuje je tylko wtedy, gdy spełnione są oba warunki: klient wymienia je po nazwie podczas połączenia, a klucz API wklejony na stronie zgody je zawiera. Klient, który nie wysyła listy uprawnień, otrzymuje cztery standardowe uprawnienia (Read hiring data, Read candidates, Manage pipeline, Invite candidates), które posiada klucz, i żadne z tych dwóch, więc asystent nie widzi narzędzi, które ich wymagają. Przy użyciu klucza statycznego (opcja B) asystentowi są pokazywane te narzędzia, niezależnie od uprawnień, które posiada klucz. Flowmingo odrzuca każde wywołanie, na które klucz nie zezwala.
  • Niektóre wywołania trwają. Publikowanie czeka na kontrolę treści AI, do około 90 sekund. Tworzenie projektu lub oceny używa generowania AI i może trwać dłużej (test techniczny zajmuje od 3 do 9 minut). Gdy odpowiedź mówi, że praca nadal oczekuje, asystent wywołuje ponownie z tym samym kluczem idempotencji, aby odczytać, gdzie doszło. Ponowienie nigdy nie tworzy drugiego projektu lub oceny.
Możliwość Co robi
Utwórz projekt rekrutacyjny (create_project) Wymaga Create hiring projects (opcjonalne). Tworzy projekt z czterema domyślnymi etapami i ofertą pracy napisaną przez to samo AI co dashboard, z tytułu, stanowiska i opcjonalnego opisu. Domyślnie tworzy również ocenę CV i rozmowę AI; asystent może nazwać inne oceny lub żadne. Oferta pracy jest włączona i staje się publiczna, gdy kontrola treści AI ją zatwierdzi, zwykle w ciągu minuty. Ograniczone do 10 projektów na minutę i 300 dziennie dla Twojej firmy. Klucz idempotencji jest opcjonalny: gdy go pominiesz, jeden jest tworzony z argumentów, więc ponowienie nigdy nie tworzy drugiego projektu.
Utwórz ocenę (create_assessment) Wymaga Create assessments (opcjonalne). Tworzy jedną ocenę za pomocą AI: rozmowę AI, ocenę CV, test umiejętności, pokaz, test techniczny lub role-play, z tytułu stanowiska i opcjonalnego opisu stanowiska, nazwy, projektu i języka (tag taki jak en lub vi-VN; test umiejętności i test techniczny ignorują język). Dołącz ją do projektu, aby można było zapraszać kandydatów na test umiejętności, test techniczny lub pokaz. Klucz idempotencji jest opcjonalny, jak wyżej.
Opublikuj ofertę pracy (publish_job_post) Wymaga Create hiring projects. Włącza ofertę pracy i upewnia się, że kontrola treści AI została uruchomiona. Odpowiedź mówi, czy strona jest teraz aktywna, nadal czeka na kontrolę, czy została odrzucona. Projekt rekrutacyjny musi być aktywny.
Cofnij publikację oferty pracy (unpublish_job_post) Wymaga Create hiring projects. Wyłącza ofertę pracy, więc jej publiczny link przestaje działać. Domyślnie promocja jest również wyłączona (withdraw_boost jest true).
Promuj ofertę pracy (boost_job_post) Wymaga Create hiring projects. Ustawia promocję na off, flowmingo lub extended. Promocja jest bezpłatna. Podniesienie wymaga włączonej oferty pracy, aktywnego projektu, logo firmy i opisu oraz kontroli treści AI; firma może podnieść 50 promocji dziennie.
Otwórz, szkicuj lub archiwizuj projekt (set_project_state) Wymaga Create hiring projects. Przenosi projekt rekrutacyjny między active, draft i archived. Wersje robocze i zarchiwizowane zamykają link do oferty. Dane kandydata są zachowywane.
Anuluj zaplanowane zaproszenie (cancel_scheduled_invite) Wymaga Invite candidates. Anuluje zaproszenie zaplanowane na później, które nie zostało jeszcze wysłane, używając identyfikatora zaproszenia z wyniku zaproszenia. Nikt nie otrzymuje e-maila. Osoba pozostaje na Twoim koncie i na tablicy projektu.
Usuń projekt rekrutacyjny (delete_project) Wymaga Create hiring projects (opcjonalne). Tylko prosi: nie usuwa natychmiast, żąda zatwierdzenia pod linkiem i nic nie jest usuwane, dopóki Właściciel lub Administrator nie zatwierdzi. Tylko aktywny projekt może być usunięty. Jeśli osoba zatwierdzi, Flowmingo usuwa projekt i jego oferty pracy; jego aplikacje kandydatów nie są usuwane pojedynczo, a profile i kontakty kandydatów, Twoje oceny i linki zaproszeń są zachowane. Nie ma cofnięcia.

Bezpieczeństwo i zaufanie

  • Twoje dane są ograniczone do organizacji — asystent nigdy nie może zobaczyć danych innej firmy.
  • Przy OAuth asystent nigdy nie otrzymuje Twojego klucza API. Otrzymuje token dostępu, który wygasa po godzinie, odświeżany cicho, gdy pozostaje połączony. Samo logowanie trwa tak długo, jak jego token odświeżania, domyślnie około 30 dni od wydania lub ostatniego odświeżenia, więc wygasa po około 30 dniach bez użycia, a wtedy logujesz się ponownie. Przy statycznym nagłówku (opcja B) klient Twojego asystenta przechowuje Twój klucz i wysyła go z każdym żądaniem, więc trzymaj go z dala od plików, które możesz udostępnić lub zatwierdzić.
  • Odcięcie asystenta: usuń klucz API, którym go autoryzowałeś, w Ustawienia → Integracje → Klucze API. Dostęp zatrzymuje się natychmiast. Nie ma jeszcze rozłączania per asystent, więc jeśli chcesz cofnąć je pojedynczo, daj każdemu asystentowi własny klucz.
  • Żądania do punktu końcowego /mcp są sprawdzane pod kątem Origin: nieprzezroczyste pochodzenie null jest zawsze odrzucane, a sprawdzenie może być zablokowane na liście dozwolonych, ale domyślnie każde prawdziwe pochodzenie jest akceptowane, więc ochroną jest Twój poświadczenie, a nie pochodzenie. Każda sesja jest związana z poświadczeniem, które ją otworzyło.

Aby uzyskać informacje o uwierzytelnianiu, zobacz Uwierzytelnianie — dwie opcje; dla dokładnych odczytów, chronionych zapisów i działań, które dzieją się natychmiast, zobacz Co możesz zrobić. Gdy będziesz gotowy, przejdź do Połącz swojego asystenta i wybierz swojego klienta.

Adres URL serwera MCP

Adres URL serwera MCPhttps://mcp.flowmingo.ai/mcp

Połącz swojego asystenta

Z jakiego asystenta korzystasz?

Claude Code (CLI)

Jedno polecenie dodaje Flowmingo do natywnego Streamable HTTP. Zaczynaj od OAuth; statyczny --header to alternatywa.

Kroki: 1) dodaj serwer, 2) zaloguj się (przeglądarka → wklej klucz), 3) claude mcp list, aby zweryfikować.

# OAuth (recommended) — flags BEFORE the name:
claude mcp add --transport http flowmingo https://mcp.flowmingo.ai/mcp
claude mcp login flowmingo          # browser opens; paste your fl_ key on the consent page

# Static API key instead (pick ONE header):
claude mcp add --transport http flowmingo https://mcp.flowmingo.ai/mcp \
  --header "x-api-key: fl_YOUR_KEY"
# or: --header "Authorization: Bearer fl_YOUR_KEY"

# Share with a repo team (writes a git-committable .mcp.json):
claude mcp add --transport http --scope project flowmingo https://mcp.flowmingo.ai/mcp

claude mcp list && claude mcp get flowmingo

Uwaga: flagi muszą znajdować się przed nazwą i zawsze używaj --transport http (nigdy sse). Zastąp fl_YOUR_KEY swoim pełnym kluczem (patrz Jak wygląda pełny klucz w sekcji Uwierzytelnianie powyżej).

Sprawdź, czy działa — zapytaj: „wyświetl moje otwarte oferty pracy”