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_projectczeka 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
/mcpsą sprawdzane pod kątem Origin: nieprzezroczyste pochodzenienulljest 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
Połącz swojego asystenta
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”
Cursor
Statyczny nagłówek to najprostsza ścieżka. Cursor może również korzystać z OAuth (obsługuje Dynamic Client Registration) — w tym celu usuń blok headers.
Kroki: 1) dodaj serwer do ~/.cursor/mcp.json (poniżej), 2) ustaw FLOWMINGO_API_KEY jako pełny klucz w profilu powłoki, 3) zamknij Cursor i uruchom go z terminala, gdzie zmienna jest ustawiona, 4) w Ustawienia → MCP przełącz serwer, aby go przeładować.
Cursor musi widzieć zmienną. Cursor odczytuje ${env:FLOWMINGO_API_KEY} z własnego środowiska. Uruchomiony z doku lub menu Start często nie widzi zmiennej ustawionej w profilu terminala, co powoduje, że nagłówek jest pusty lub nierozwinięty, a serwer odpowiada Missing credential. Jeśli uruchamianie Cursor z terminala nie jest praktyczne, zastąp ${env:FLOWMINGO_API_KEY} w pliku pełnym kluczem (i trzymaj ~/.cursor/mcp.json poza git).
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
}
}
}
OAuth zamiast tego — usuń blok headers; Cursor uruchamia Dynamic Client Registration i otwiera stronę zgody w przeglądarce przy pierwszym połączeniu:
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp"
}
}
}
Sprawdź, czy działa — zapytaj: "wypisz moje otwarte oferty pracy."
VS Code (Copilot, tryb agenta)
Narzędzia pojawiają się tylko w Copilot Chat → Tryb agenta. Główny klucz to servers (nie mcpServers), a typ to http. Ścieżka z monitami o klucz poniżej jest niezawodną konfiguracją.
Kroki: 1) utwórz plik .vscode/mcp.json (lub uruchom MCP: Dodaj serwer → HTTP), 2) po uruchomieniu serwera VS Code poprosi o Twój klucz (nie zostanie on zapisany w pliku), 3) użyj go w Trybie agenta.
{
"servers": {
"flowmingo": {
"type": "http",
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${input:flowmingo_key}" }
}
},
"inputs": [
{ "id": "flowmingo_key", "type": "promptString", "description": "Flowmingo API key (fl_...)", "password": true }
]
}
VS Code może również próbować użyć OAuth, ale udokumentowana konfiguracja OAuth oczekuje identyfikatora klienta; użyj powyższej ścieżki z monitami o klucz dla niezawodnej konfiguracji.
Sprawdź, czy działa — zapytaj: „list my open jobs.” (wymień moje otwarte oferty pracy).
Claude — claude.ai i Claude Desktop
Oba używają tego samego interfejsu użytkownika łączników i tego samego przepływu wklejania adresu URL. Tylko OAuth (w interfejsie użytkownika nie ma pola nagłówka).
Kroki (web lub desktop):
- Otwórz Ustawienia → Łączniki i kliknij Dodaj niestandardowy łącznik.
- Nazwij go
Flowmingoi wklej powyższy adres URL serwera MCP. Pozostaw Zaawansowane → Identyfikator klienta OAuth / Sekret puste. - Kliknij Dodaj → Połącz. Na stronie zgody Flowmingo wklej swój klucz API
fl_i autoryzuj. - Zweryfikuj — zapytaj Claude: „list my open jobs.” (wymień moje otwarte oferty pracy).
Remote MCP server URL: https://mcp.flowmingo.ai/mcp
Advanced → OAuth Client ID / Secret: (leave blank — Flowmingo uses Dynamic Client Registration)
Zespół / Przedsiębiorstwo: Właściciel dodaje go raz w Ustawienia organizacji → Łączniki → Niestandardowe; członkowie następnie klikają Połącz.
Potrzebujesz statycznego klucza w Claude Desktop zamiast tego? Użyj zakładki Dowolny klient (mcp-remote).
Twoja przeglądarka otworzy stronę zgody Flowmingo przy pierwszym połączeniu — wklej swój klucz API i autoryzuj. Aby później odłączyć, usuń ten klucz API w Ustawienia → Integracje → Klucze API.
ChatGPT i OpenAI Codex CLI
Oba są od OpenAI. ChatGPT korzysta z trybu deweloperskiego dla niestandardowych łączników (tylko OAuth); Codex łączy się natywnie z poziomu CLI.
ChatGPT (web)
- Na chatgpt.com (Plus / Pro / Business / Enterprise / Edu — nie wersja mobilna), otwórz Ustawienia → Aplikacje → Zaawansowane i włącz Tryb deweloperski.
- Aplikacje → Utwórz → nazwij
Flowmingo, wklej poniższy adres URL, transport Streamable HTTP, autoryzacja OAuth. - Otwórz szkic, włącz narzędzia i kliknij Odśwież.
- Dołącz go przez menu + w czacie.
Connector URL: https://mcp.flowmingo.ai/mcp
Transport: Streamable HTTP
Auth: OAuth (leave any static OAuth client ID / secret blank — Flowmingo uses Dynamic Client Registration)
Tryb deweloperski ChatGPT łączy się tylko przez OAuth — nie akceptuje statycznego nagłówka x-api-key / niestandardowego klucza API. Zwykłe i szczegółowe łączniki badawcze używają tylko search + fetch (masz oba). Narzędzia do zapisu (zaproszenie / przeniesienie / odrzucenie) wymagają trybu deweloperskiego. Komunikat, który ChatGPT pokazuje przed uruchomieniem narzędzia, należy do ChatGPT i nie jest zgodą Flowmingo: zaproszenie, odrzucenie i przeniesienie do etapu, który wysyła e-mail do kandydata, zawsze czeka na zatwierdzenie przez osobę pod linkiem Flowmingo.
OpenAI Codex CLI
Nie potrzebujesz mostu — Codex natywnie obsługuje Streamable HTTP.
# ~/.codex/config.toml — static fl_ key as a bearer (simplest)
[mcp_servers.flowmingo]
url = "https://mcp.flowmingo.ai/mcp"
bearer_token_env_var = "FLOWMINGO_API_KEY" # export FLOWMINGO_API_KEY=fl_...
startup_timeout_sec = 20
tool_timeout_sec = 120
# Static API key (bearer from env) — simplest:
codex mcp add flowmingo --url https://mcp.flowmingo.ai/mcp --bearer-token-env-var FLOWMINGO_API_KEY
# export FLOWMINGO_API_KEY=fl_... (or set it in ~/.codex/config.toml [mcp_servers.flowmingo])
# OAuth instead (no key stored):
codex mcp add flowmingo --url https://mcp.flowmingo.ai/mcp
codex mcp login flowmingo
codex mcp list
Sprawdź, czy działa — zapytaj: "wypisz moje otwarte oferty pracy."
Gemini CLI i Code Assist
Gemini CLI (i tryb agenta Gemini Code Assist) docierają do zdalnego serwera MCP przez ~/.gemini/settings.json. Aplikacja konsumencka Gemini nie może dodawać niestandardowych łączników MCP — ta ścieżka jest tylko dla CLI / Code Assist.
Kroki: 1) dodaj serwer w sekcji mcpServers w ~/.gemini/settings.json, 2) wyeksportuj FLOWMINGO_API_KEY=fl_..., 3) uruchom gemini i /mcp, aby potwierdzić, że narzędzia są wymienione.
{
"mcpServers": {
"flowmingo": {
"httpUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${FLOWMINGO_API_KEY}" },
"timeout": 30000
}
}
}
httpUrl wybiera natywny Streamable HTTP. Symbol zastępczy ${FLOWMINGO_API_KEY} jest rozwijany ze środowiska, więc żaden surowy klucz nie jest zapisywany w pliku. Wolisz OAuth? Gemini CLI może to zrobić natywnie — pomiń blok headers i dodaj "authProviderType": "dynamic_discovery" do wpisu serwera. CLI wykrywa wyzwanie 401, odkrywa nasze metadane OAuth i samodzielnie wykonuje dynamiczną rejestrację klienta (nie ma potrzeby ustawiania identyfikatora klienta).
Sprawdź, czy działa — w
geminizapytaj: „list my open jobs.” (wymień moje otwarte oferty pracy).
Inni klienci — Windsurf · Zed · Cline · Continue · Antigravity
Każdy z klientów poniżej działa na tym samym serwerze — większość obsługuje zarówno OAuth, jak i statyczny nagłówek. Fragmenty używają statycznego klucza przez zmienną środowiskową; usuń headers, aby klient mógł uruchomić OAuth, jeśli go obsługuje. Zwróć uwagę na pułapki z nazwami kluczy właściwe dla każdego klienta.
Google Antigravity
Dodaj https://mcp.flowmingo.ai/mcp jako zdalny serwer MCP i wybierz jego uwierzytelnienie: otworzy się strona Flowmingo i poprosi o pełny klucz API (patrz Jak wygląda pełny klucz w sekcji Uwierzytelnianie powyżej). Każda powierzchnia Antigravity (IDE, CLI) loguje się osobno. W mcp_config.json Antigravity adres wpisuje się w serverUrl, a statyczny klucz umieszcza się w bloku headers jako Authorization z Bearer i pełnym kluczem, jak w oficjalnych przykładach MCP Antigravity. Nie udało nam się przetestować każdej wersji Antigravity, więc jeśli Twoje menu różnią się od opisanych, przewodnik Google zawiera aktualne kroki.
Windsurf (Cascade)
~/.codeium/windsurf/mcp_config.json — Windsurf akceptuje serverUrl lub url i obsługuje OAuth (pomiń headers, aby go wywołać).
{ "mcpServers": { "flowmingo": {
"serverUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Zed
~/.config/zed/settings.json — klucz to context_servers; pomiń headers, aby użyć natywnego OAuth. Ustaw FLOWMINGO_API_KEY=fl_... w środowisku, zamiast wklejać surowy klucz.
{ "context_servers": { "flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Cline
MCP Servers → Configure — ustaw type: "streamableHttp" (camelCase), w przeciwnym razie domyślnie będzie użyte martwe SSE.
{ "mcpServers": { "flowmingo": {
"type": "streamableHttp",
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" },
"disabled": false, "autoApprove": []
} } }
Continue.dev
~/.continue/config.yaml — połącz się przez most mcp-remote. Ustaw FLOWMINGO_AUTH_HEADER = Bearer fl_YOUR_KEY.
name: Flowmingo MCP
version: 0.0.1
schema: v1
mcpServers:
- name: Flowmingo
command: npx
args: ["-y", "mcp-remote", "https://mcp.flowmingo.ai/mcp", "--transport", "http-only", "--header", "Authorization:${{ secrets.FLOWMINGO_AUTH_HEADER }}"]
Sprawdź, czy działa — zapytaj: „wypisz moje otwarte oferty pracy”.
Dowolny klient (mcp-remote)
Dla dowolnego klienta tylko stdio (lub przyszłego klienta bez natywnego transportu zdalnego), połącz się z Flowmingo za pomocą polecenia stdio mcp-remote. --transport http-only jest wymagane — serwer nie obsługuje SSE.
Kroki: 1) upewnij się, że Node ≥ 18, 2) uruchom most jako polecenie stdio w swoim kliencie, 3) przy pierwszym uruchomieniu OAuth otworzy się przeglądarka — wklej swój klucz.
# Bare terminal — OAuth, caches the token in ~/.mcp-auth:
npx -y mcp-remote https://mcp.flowmingo.ai/mcp --transport http-only
# Static key (no browser): --header on its own arg is fine
npx -y mcp-remote https://mcp.flowmingo.ai/mcp --transport http-only \
--header "x-api-key: fl_YOUR_KEY"
{
"mcpServers": {
"flowmingo": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.flowmingo.ai/mcp",
"--transport", "http-only", "--header", "x-api-key:${FLOWMINGO_KEY}"],
"env": { "FLOWMINGO_KEY": "fl_YOUR_KEY" }
}
}
}
Pomoc: jeśli uwierzytelnianie się zablokuje, uruchom rm -rf ~/.mcp-auth i spróbuj ponownie. Zastąp fl_YOUR_KEY swoim pełnym kluczem (patrz Jak wygląda pełny klucz w sekcji Autoryzacja powyżej). W args[] JSON-a unikaj spacji po dwukropku w nagłówku (dziwactwo escapowania npx).
Sprawdź, czy działa — zapytaj: "wypisz moje otwarte oferty pracy."