Prehľad
Pripojte ľubovoľného asistenta AI kompatibilného s MCP k vašim náborovým údajom Flowmingo – čítajte svoje pracovné ponuky a kandidátov a vykonávajte chránené akcie (pozvať, presunúť, odmietnuť, odstrániť z projektu) bezpečne, s vaším súhlasom. S dvoma extra povoleniami, ktoré si zapnete sami, môže asistent tiež vytvárať náborové projekty a hodnotenia a publikovať, zatvárať alebo zviditeľňovať pracovnú ponuku (pozri Čo môžete robiť). Ste nováčik v MCP? Je to otvorený štandard, ktorý umožňuje asistentom AI hovoriť s nástrojmi, ako je Flowmingo. Zistite, čo je MCP.
Transport: Streamable HTTP (moderný vzdialený transport). Neexistuje žiadny starší SSE – vždy nasmerujte svojho klienta na /mcp, nikdy na /sse.
So svojím API kľúčom zaobchádzajte ako s heslom. Uprednostnite OAuth, výzvu na zadanie alebo premennú prostredia pred vložením surového kľúča
fl_...do súboru, ktorý by ste mohli odovzdať do gitu (napr..vscode/mcp.json,~/.cursor/mcp.json, vaša konfigurácia Continue).
Autentifikácia – dve možnosti
A – Prihlásenie cez Flowmingo (OAuth, odporúčané). Váš prehliadač otvorí stránku so súhlasom Flowmingo; tam vložíte svoj API kľúč. Asistent nikdy nedostane váš surový kľúč. Dostane prístupový token a obnovovací token, ktoré môže použiť na získanie nového prístupového tokenu. Prihlásenie netrvá večne. Obnovovací token žije štandardne asi 30 dní, počítané od jeho vydania, pri prihlásení alebo pri poslednom obnovení, takže prihlásenie, ktoré sa tak dlho nepoužíva, prepadne, a vydanie Flowmingo, ktoré zmení spôsob ukladania prihlásení, môže tiež vyžadovať, aby ste sa znova prihlásili. Asistent vás potom požiada, aby ste sa znova prihlásili, a vy znova vložíte svoj kľúč. Ak ho chcete prerušiť skôr, vymažte tento API kľúč. Neexistuje žiadne ID klienta ani tajomstvo na vytvorenie (Flowmingo používa dynamickú registráciu klienta). Na klientoch, ktoré zobrazujú „Rozšírené“ nastavenia OAuth (napr. Claude.ai), nechajte Client ID a Secret prázdne.
B – Statický API kľúč (hlavička). Pošlite svoj kľúč ako jednu z hlavičiek:
x-api-key: fl_YOUR_KEY
Authorization: Bearer fl_YOUR_KEY
Získajte svoj kľúč v Flowmingo → Nastavenia → Integrácie → API kľúče. Začiarknite Read hiring data a Read candidates – prvé pokrýva pracovné ponuky, pipeline a výsledky, druhé umožňuje asistentovi vyhľadať osobu. Pridajte Manage pipeline / Invite candidates pre chránené zápisové akcie. Ak chcete asistentovi umožniť vytvárať projekty a hodnotenia a publikovať alebo zviditeľňovať pracovnú ponuku, začiarknite tiež Create hiring projects a Create assessments. Prečítajte si Vytváranie a publikovanie v časti Čo môžete robiť ako prvé: tieto dve povolenia sú voliteľné a tvorca kľúča musí byť vlastník alebo správca.
Ako vyzerá úplný kľúč. Jedna dlhá hodnota: fl_live_, verejný názov kľúča, bodka a potom dlhé tajomstvo. Tajná polovica sa zobrazí raz, hneď po vytvorení kľúča; neskôr zoznam API kľúčov zobrazí iba začiatok. Hodnota bez bodky je iba názov kľúča a bude odmietnutá. Kdekoľvek táto príručka píše fl_YOUR_KEY, nahraďte to celé svojím úplným kľúčom, bez úvodzoviek a bez medzier.
Ak sa nepodarí pripojiť. Nesprávny alebo prázdny kľúč sa vráti ako Missing credential alebo The Flowmingo API key was rejected; oboje môže znamenať, že hodnota sa k nám nedostala celá, takže najprv skontrolujte hodnotu. Nastavenie ako ${env:FLOWMINGO_API_KEY} funguje iba vtedy, ak program vidí túto premennú, a editor otvorený z Docku alebo ponuky Štart často nečíta váš terminálový profil. Spustite ho buď z terminálu, kde je premenná nastavená, alebo vložte svoj úplný kľúč do súboru (a tento súbor držte mimo git).
Ktorú možnosť si vybrať? Väčšina klientov podporuje obe; niektoré (napr. ChatGPT) sú iba OAuth – každá karta uvádza, čo daný klient podporuje. Vo všeobecnosti OAuth vyhovuje interaktívnym asistentom (Claude.ai, ChatGPT, VS Code); hlavička API kľúča vyhovuje CLI, headless/CI a editorom, kde radšej vložíte kľúč.
Čo môžete robiť
Čítanie nevyžaduje schválenie. Väčšina zápisov je chránená. Pozvanie, odmietnutie vykonané akciou Reject, odstránenie kandidátov z projektu, vymazanie projektu alebo zvyčajne presun do fázy, ktorá je nastavená na odoslanie e-mailu kandidátovi, čaká na schválenie osobou na odkaze, prihlásenou do Flowmingo. Asistent to nemôže schváliť a „áno“ napísané v chate sa nepočíta. Nastavenie e-mailu fázy sa kontroluje pri požiadavke na presun. Pri poznámke, hodnotení, shortliste, štítku alebo presune do fázy, ktorá nie je nastavená na odoslanie e-mailu kandidátovi, asistentovi sa prikáže, aby vám najprv zobrazil náhľad a pokračoval len s vaším súhlasom, čo je preňho inštrukcia, nie zámok. Výzva, ktorú váš AI klient zobrazí pred spustením nástroja, je vlastná klientovi a nie je schválením Flowmingo: pozvanie, odmietnutie vykonané akciou Reject a presun do e-mailovej fázy stále čakajú na schvaľovací odkaz, bez ohľadu na to, čo sa klient pýtal. Schvaľovací odkaz prepadne po 15 minútach a jedna požiadavka na viacerých kandidátov alebo žiadostí (najviac 50) je jedno schválenie, ktoré zobrazuje všetkých. Keď je zmena naplánovaná, asistent môže skontrolovať jej stav, stiahnuť ju, kým čaká, a vrátiť späť reverzibilnú zmenu (poznámku, hodnotenie, shortlist, štítok alebo presun, ktorý nikomu neposlal e-mail) do 24 hodín. Vrátenie späť nie je vždy dostupné: zmena sa musí vrátiť s referenciou na vrátenie, zaznamenanie je najlepšia snaha, a presun pre kandidáta bez predchádzajúcej fázy nemá žiadnu, takže asistent by mal skontrolovať a povedať to, keď niet cesty späť. E-mail, ktorý bol odoslaný, sa nedá vrátiť späť. Nástroje uvedené v časti Vytváranie a publikovanie sú výnimkou z tohto všetkého, okrem delete_project: vykonajú sa okamžite a nie sú naplánované na schválenie. Odstránenie a vymazanie projektu sa nedá vrátiť späť. Všetko je obmedzené na vašu organizáciu.
Čítanie
| Možnosť | Čo robí |
|---|---|
| Zoznam pracovných ponúk | Prehliadajte otvorené a zatvorené pozície vašej organizácie. |
| Zoznam hodnotení a projektov | Pozrite si svoje hodnotenia (interview sety) všetkých druhov (AI interview, role-play, Skill Testy, Technické testy, CV hodnotenia, Showcase a nahrávky; dotazníky, keď o ne požiadate) a svoje náborové projekty. |
| Zoznam vášho pipeline kandidátov | Zobrazenie žiadostí podľa fáz v projekte. |
| Čítanie výsledkov a skóre hodnotení | Získajte výsledky všetkých druhov: AI interview, role-play, Skill Testy, Technické testy, CV hodnotenia, Showcase, nahrávky a dotazníky. Každý výsledok je označený svojím druhom. Iba niektoré druhy nesú AI skóre: Showcase a dotazník nie sú nikdy hodnotené a Skill Test je percento. |
| Vyhľadanie kandidáta | Získajte meno, e-mail a CV jedného kandidáta. |
| Vyhľadávanie kandidátov | Nájdite kandidátov podľa mena alebo e-mailu. |
| Porovnanie kandidátov | Zoraďte 2 až 10 kandidátov vedľa seba. Vyžaduje povolenie Read candidates aj Read hiring data. |
| Náborový prehľad | Funnel pre všetko, čo vaše pripojenie dosiahne (celá spoločnosť, pokiaľ kľúč nevytvoril niekto obmedzený na niektoré projekty), alebo zúžený, keď sa opýtate: žiadosti podľa fázy, aktívni vs. odmietnutí, a pre každý druh hodnotenia, ktorý má výsledky, dokončené vs. prebiehajúce výsledky a priemerné skóre. Projekt zužuje každý počet, ale jeho počty výsledkov pokrývajú výsledky hodnotení pripojených k projektu, takže kandidát iného projektu, ktorý zdieľa jedno z týchto hodnotení, môže byť tiež započítaný. Hodnotenie zužuje iba počty výsledkov: počty fáz a žiadostí zostávajú na všetkom, čo vaše pripojenie dosiahne. Druhy sa nikdy nesčítavajú. |
| Top kandidáti | Najlepšie hodnotené výsledky, zoradené podľa celkového skóre. Všetky druhy hodnotení sú zoradené spolu, pokiaľ nepožiadate o jeden druh alebo jedno hodnotenie (interview set). |
| Detail výsledku hodnotenia | Skóre jedného výsledku podľa kompetencií plus AI súhrn, pre druhy, ktoré ich majú. Skill Test, Technický test, Showcase a dotazník majú málo alebo nič. |
| Detail pracovnej ponuky | Úplný detail jednej pracovnej ponuky. |
Je pracovná ponuka verejná? (get_job_post_publication) |
Či môže ktokoľvek otvoriť verejnú stránku pracovnej ponuky: živá, stále čaká na AI kontrolu obsahu, odmietnutá ňou, označená, vypnutá alebo jej projekt nie je otvorený. Tiež jej verejná adresa a jej zviditeľnenie (vypnuté, flowmingo alebo rozšírené). Vyžaduje Read hiring data. |
| Nadchádzajúce interview | Pozvánky na akýkoľvek druh hodnotenia, ktoré boli odoslané alebo naplánované a ešte nie sú dokončené. Nie je to počet všetkých nevybavených: pozvanie, ktorého kandidát bol pripomenutý, alebo otvoril či klikol na odkaz, je vynechané, kým kandidát nezačne, rovnako ako to, ktoré sa nepodarilo doručiť. |
Zápis (chránený)
| Možnosť | Čo robí |
|---|---|
| Pozvať kandidátov na hodnotenie | Pripraví pozvánky na AI interview, role-play, Skill Test alebo Technický test a čaká, kým ich osoba neschváli na odkaze. Nič sa neodošle predtým. Jedno hodnotenie a najviac 50 kandidátov na požiadavku; Skill Test alebo Technický test vyžaduje projekt a e-mail pre každého kandidáta a sponzorovaný môže zaťažiť peňaženku vašej organizácie, keď kandidát začne. |
| Presunúť kandidáta do inej fázy | Presun do fázy, ktorá je nastavená na odoslanie e-mailu kandidátovi, zvyčajne čaká na schválenie osobou na odkaze (nastavenie e-mailu fázy sa číta raz, tesne pred presunom, takže nastavenie zapnuté v tom momente môže stále umožniť presun s e-mailom bez schválenia). Akýkoľvek iný presun: asistentovi sa prikáže zobraziť náhľad a počkať na vaše áno, a zvyčajne sa dá vrátiť späť do 24 hodín, keď sa vrátil s referenciou na vrátenie. Najviac 50 žiadostí na požiadavku. |
| Odmietnuť žiadosť | Vyžaduje schválenie na odkaze. Ak osoba schváli, Flowmingo sa pokúsi presunúť žiadosť do fázy Odmietnutí v projekte; skontrolujte výsledok potom. Najviac 50 žiadostí na požiadavku. |
Odstrániť kandidátov z projektu (remove_application) |
Vyžaduje Manage pipeline. Vyžaduje schválenie na odkaze. Ak osoba schváli, Flowmingo vymaže žiadosti z projektu; profil kandidáta zostáva vo vašom talent pool-e a v iných projektoch. Nie je to odmietnutie a neexistuje vrátenie späť. Najviac 50 žiadostí na požiadavku. |
| Pridať poznámku k výsledku | Asistentovi sa prikáže zobraziť náhľad navrhovanej poznámky a počkať na vaše áno pred uložením. Poznámka patrí jednému výsledku hodnotenia (akéhokoľvek druhu), nie kandidátovi ako celku. |
| Ohodnotiť výsledok | Asistentovi sa prikáže zobraziť náhľad hodnotenia a počkať na vaše áno. Hodnotenie sa vzťahuje na jeden výsledok hodnotenia. |
| Zaradiť výsledok do shortlistu | Asistentovi sa prikáže zobraziť náhľad zmeny shortlistu a počkať na vaše áno. Vzťahuje sa na jeden výsledok hodnotenia. |
| Označiť / pridať do talent kolekcie | Asistentovi sa prikáže zobraziť náhľad zmeny štítku alebo talent kolekcie a počkať na vaše áno. |
| Skontrolovať, stiahnuť alebo vrátiť zmenu | Skontrolujte, kde stojí naplánovaná zmena (čaká, vykonaná, zlyhaná, expirovaná alebo nahradená novšou požiadavkou), stiahnite tú, ktorá stále čaká na schválenie, alebo vráťte späť reverzibilnú zmenu do 24 hodín, keď sa vrátila s referenciou na vrátenie. |
Vytváranie a publikovanie (vykoná sa okamžite, okrem vymazania projektu)
Tieto nástroje vytvárajú veci a otvárajú ich verejnosti. Správajú sa inak ako chránené zápisy vyššie:
- Vykonajú sa okamžite, okrem
delete_project. Nič nie je naplánované na schválenie osobou na odkaze a žiadny z nich neposiela e-mail kandidátovi.delete_projectčaká na schválenie vlastníkom alebo správcom na odkaze. - Tvorca kľúča musí byť vlastník alebo správca, pre každý nástroj tu okrem zrušenia, ktoré vyžaduje iba Invite candidates. Nástroje konajú s povoleniami osoby, ktorá vytvorila API kľúč. Ak je táto osoba členom, volanie sa odmietne.
- Dve povolenia sú voliteľné. Create hiring projects a Create assessments nie sú štandardne udelené. Pri prihlásení (možnosť A) ich asistent získa len vtedy, ak platia obe podmienky: klient ich vymenuje pri pripájaní a API kľúč, ktorý vložíte na stránke so súhlasom, ich obsahuje. Klient, ktorý neodošle zoznam povolení, získa štyri štandardné povolenia (Read hiring data, Read candidates, Manage pipeline, Invite candidates), ktoré kľúč obsahuje, a žiadne z týchto dvoch, takže asistent nevidí nástroje, ktoré ich potrebujú. Pri statickom kľúči (možnosť B) sa asistentovi zobrazia tieto nástroje, bez ohľadu na to, aké povolenia kľúč má. Flowmingo odmietne každé volanie, ktoré kľúč nepovoľuje.
- Niektoré volania trvajú dlhšie. Publikovanie čaká na AI kontrolu obsahu, až asi 90 sekúnd. Vytvorenie projektu alebo hodnotenia používa AI generovanie a môže trvať dlhšie (Technický test trvá 3 až 9 minút). Keď odpoveď hovorí, že práca stále prebieha, asistent zavolá znova s rovnakým idempotentným kľúčom, aby prečítal, kde sa dostal. Opakovanie nikdy nevytvorí druhý projekt alebo hodnotenie.
| Možnosť | Čo robí |
|---|---|
Vytvoriť náborový projekt (create_project) |
Vyžaduje Create hiring projects (voliteľné). Vytvorí projekt so štyrmi predvolenými fázami a pracovnou ponukou napísanou rovnakou AI ako dashboard, z názvu, pozície a voliteľného popisu. Štandardne tiež vytvorí CV hodnotenie a AI interview; asistent môže uviesť iné hodnotenia alebo žiadne. Pracovná ponuka je zapnutá a stane sa verejnou, keď ju AI kontrola obsahu schváli, zvyčajne do minúty. Obmedzené na 10 projektov za minútu a 300 za deň pre vašu spoločnosť. Idempotentný kľúč je voliteľný: keď sa vynechá, vytvorí sa z argumentov, takže opakovanie nikdy nevytvorí druhý projekt. |
Vytvoriť hodnotenie (create_assessment) |
Vyžaduje Create assessments (voliteľné). Vytvorí jedno hodnotenie s AI: AI interview, CV hodnotenie, Skill Test, Showcase, Technický test alebo Role-play, z názvu pracovnej pozície a voliteľného popisu pracovnej pozície, názvu, projektu a jazyka (značka ako en alebo vi-VN; Skill Test a Technický test ignorujú jazyk). Pripojte ho k projektu, aby mohli byť kandidáti pozvaní na Skill Test, Technický test alebo Showcase. Idempotentný kľúč je voliteľný, ako vyššie. |
Publikovať pracovnú ponuku (publish_job_post) |
Vyžaduje Create hiring projects. Zapne pracovnú ponuku a zabezpečí, aby AI kontrola obsahu prebehla. Odpoveď hovorí, či je stránka živá teraz, stále čaká na kontrolu alebo bola odmietnutá. Náborový projekt musí byť aktívny. |
Zrušiť publikovanie pracovnej ponuky (unpublish_job_post) |
Vyžaduje Create hiring projects. Vypne pracovnú ponuku, takže jej verejný odkaz prestane fungovať. Štandardne sa tiež vypne zviditeľnenie (withdraw_boost je true). |
Zviditeľniť pracovnú ponuku (boost_job_post) |
Vyžaduje Create hiring projects. Nastaví zviditeľnenie na off, flowmingo alebo extended. Zviditeľňovanie je zadarmo. Zvýšenie vyžaduje zapnutú pracovnú ponuku, aktívny projekt, logo spoločnosti a popis a AI kontrolu obsahu; spoločnosť môže zvýšiť 50 zviditeľnení za deň. |
Otvoriť, rozpísaný alebo archivovať projekt (set_project_state) |
Vyžaduje Create hiring projects. Presúva projekt náboru medzi active, draft a archived. Koncept a archivované zatvárajú odkaz na pracovnú ponuku. Údaje kandidáta sa uchovávajú. |
Zrušiť naplánované pozvanie (cancel_scheduled_invite) |
Vyžaduje Invite candidates. Zruší pozvanie, ktoré bolo naplánované na neskôr a ešte nebolo odoslané, pomocou ID pozvania z výsledku pozvania. Nikomu sa neposiela e-mail. Osoba zostáva vo vašom účte a na projektovej nástenke. |
Vymazať náborový projekt (delete_project) |
Vyžaduje Create hiring projects (voliteľné). Iba požiada: neodstráni okamžite, vyžiada schválenie na odkaze a nič sa nevymaže, kým to vlastník alebo správca neschváli. Iba aktívny projekt môže byť vymazaný. Ak osoba schváli, Flowmingo vymaže projekt a jeho pracovné ponuky; jeho žiadosti kandidátov sa nemažú jednu po druhej a profily a kontakty kandidátov, vaše hodnotenia a odkazy na pozvania sa uchovávajú. Neexistuje vrátenie späť. |
Bezpečnosť a dôvera
- Vaše údaje sú obmedzené na organizáciu – asistent nikdy nemôže vidieť údaje inej spoločnosti.
- Pri OAuth asistent nikdy nedostane váš API kľúč. Dostane prístupový token, ktorý vyprší po hodine, ticho obnovovaný, kým zostane pripojený. Samotné prihlásenie trvá tak dlho ako jeho obnovovací token, štandardne asi 30 dní od vydania alebo posledného obnovenia, takže po asi 30 dňoch bez použitia prepadne, a potom sa znova prihlásite. Pri statickej hlavičke (možnosť B) klient vášho asistenta drží váš kľúč a posiela ho s každou požiadavkou, takže ho držte mimo súborov, ktoré by ste mohli zdieľať alebo odovzdať.
- Prerušenie asistenta: vymažte API kľúč, ktorým ste ho autorizovali, v Nastavenia → Integrácie → API kľúče. Prístup sa okamžite zastaví. Zatiaľ neexistuje odpojenie podľa asistenta, takže ak ich chcete odvolať jednotlivo, dajte každému asistentovi vlastný kľúč.
- Požiadavky na koncový bod
/mcpsa kontrolujú na ich Origin: nepriehľadnýnullorigin je vždy odmietnutý a kontrola môže byť uzamknutá na zoznam povolených, ale štandardne je akceptovaný každý skutočný origin, takže ochranou je váš poverovací údaj, nie origin. Každá relácia je viazaná na poverovací údaj, ktorý ju otvoril.
Ako sa autentifikovať, pozri Autentifikácia – dve možnosti; pre presné čítania, chránené zápisy a akcie, ktoré sa vykonajú okamžite, pozri Čo môžete robiť. Keď ste pripravení, prejdite na Pripojte svojho asistenta a vyberte si svojho klienta.
URL servera MCP
Pripojte svojho asistenta
Claude Code (CLI)
Jeden príkaz pridá Flowmingo cez natívny Streamable HTTP. Vždy používajte OAuth; statický --header je alternatívou.
Kroky: 1) pridajte server, 2) prihláste sa (prehliadač → vložte kľúč), 3) claude mcp list na overenie.
# 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
Upozornenie: príznaky musia byť pred názvom a vždy použite --transport http (nikdy nie sse). Nahraďte fl_YOUR_KEY svojim úplným kľúčom (pozri Ako vyzerá úplný kľúč v časti Autentifikácia vyššie).
Overte, že to funguje — opýtajte sa: "zoznam mojich otvorených pozícií."
Cursor
Statická hlavička je najjednoduchšia cesta. Cursor môže tiež použiť OAuth (podporuje Dynamic Client Registration) – v tom prípade odstráňte blok headers.
Postup: 1) pridajte server do ~/.cursor/mcp.json (nižšie), 2) nastavte FLOWMINGO_API_KEY na váš kompletný kľúč v profile shellu, 3) ukončite Cursor a spustite ho z terminálu, kde je premenná nastavená, 4) v Nastavenia → MCP vypnite a zapnite server, aby sa znova načítal.
Cursor musí vidieť premennú. Cursor číta ${env:FLOWMINGO_API_KEY} zo svojho vlastného prostredia. Ak je spustený z doku alebo ponuky Štart, často nevidí premennú nastavenú vo vašom profile terminálu, a potom hlavička príde prázdna alebo nerozbalená a server odpovie Missing credential. Ak spustenie Cursor z terminálu nie je praktické, nahraďte ${env:FLOWMINGO_API_KEY} v súbore svojim kompletným kľúčom (a ~/.cursor/mcp.json držte mimo git).
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
}
}
}
OAuth namiesto toho – odstráňte blok headers; Cursor spustí Dynamic Client Registration a pri prvom pripojení otvorí v prehliadači stránku so súhlasom:
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp"
}
}
}
Overte, či to funguje – opýtajte sa: "zoznam mojich otvorených pracovných pozícií."
VS Code (Copilot, agent mode)
Nástroje sa zobrazia iba v Copilot Chat → Režim agenta. Koreňový kľúč je servers (nie mcpServers) a typ je http. Nižšie uvedený postup s výzvou na zadanie kľúča je spoľahlivé nastavenie.
Kroky: 1) vytvorte .vscode/mcp.json (alebo spustite MCP: Add Server → HTTP), 2) keď spustíte server, VS Code vás vyzve na zadanie kľúča (ten sa nenapíše do súboru), 3) použite ho v Režime 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 sa tiež môže pokúsiť o OAuth, ale zdokumentovaná konfigurácia OAuth očakáva Client ID; pre spoľahlivé nastavenie použite vyššie uvedený postup s výzvou na zadanie kľúča.
Overte, či to funguje — opýtajte sa: "list my open jobs."
Claude — claude.ai & Claude Desktop
Obe používajú rovnaké používateľské rozhranie konektorov a rovnaký postup vkladania URL. Iba OAuth (v používateľskom rozhraní nie je pole pre hlavičku).
Kroky (web alebo desktop):
- Otvorte Nastavenia → Konektory a kliknite na Pridať vlastný konektor.
- Pomenujte ho
Flowmingoa vložte vyššie uvedenú URL servera MCP. V časti Pokročilé → OAuth Client ID / Secret ponechajte prázdne. - Kliknite na Pridať → Pripojiť. Na stránke súhlasu Flowmingo vložte svoj API kľúč
fl_a autorizujte. - Overte — opýtajte sa Claude: "list my open jobs."
Remote MCP server URL: https://mcp.flowmingo.ai/mcp
Advanced → OAuth Client ID / Secret: (leave blank — Flowmingo uses Dynamic Client Registration)
Tím / Podnik: Vlastník ho pridá raz pod Nastavenia organizácie → Konektory → Vlastné; členovia potom kliknú na Pripojiť.
Potrebujete namiesto toho statický kľúč na Claude Desktop? Použite kartu Akýkoľvek klient (mcp-remote).
Váš prehliadač otvorí stránku súhlasu Flowmingo pri prvom pripojení — vložte svoj API kľúč a autorizujte. Ak chcete neskôr odpojiť, odstráňte daný API kľúč v Nastavenia → Integrácie → API kľúče.
ChatGPT a OpenAI Codex CLI
Obaja sú od OpenAI. ChatGPT používa Developer Mode pre vlastné konektory (iba OAuth); Codex sa pripája natívne z CLI.
ChatGPT (web)
- Na chatgpt.com (Plus / Pro / Business / Enterprise / Edu — nie mobil) otvorte Settings → Apps → Advanced a zapnite Developer mode.
- Apps → Create → pomenujte
Flowmingo, vložte URL nižšie, transport Streamable HTTP, auth OAuth. - Otvorte draft, zapnite nástroje a Refresh.
- Pripojte ho cez menu + v chate.
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)
Developer Mode ChatGPT sa pripája iba cez OAuth — neprijíma statický x-api-key / vlastnú hlavičku API kľúča. Bežné a hĺbkové výskumné konektory používajú iba search + fetch (obaja ich máte). Zapisovacie nástroje (invite / move / reject) vyžadujú Developer Mode. Prompt, ktorý ChatGPT zobrazí pred spustením nástroja, je vlastný ChatGPT a nie je to schválenie Flowmingo: pozvánka, odmietnutie a presun do fázy, ktorá e-mailom kontaktuje kandidáta, vždy čakajú na schválenie osoby na odkaze Flowmingo.
OpenAI Codex CLI
Nie je potrebný most — Codex natívne hovorí 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
Overte, že to funguje — opýtajte sa: "zoznam mojich otvorených pracovných pozícií."
Gemini CLI & Code Assist
Gemini CLI (a agent mode Gemini Code Assist) pristupujú k vzdialenému serveru MCP cez ~/.gemini/settings.json. Aplikácia Gemini pre spotrebiteľov nemôže pridávať vlastné konektory MCP — táto cesta je iba pre CLI / Code Assist.
Kroky: 1) pridajte server pod mcpServers v ~/.gemini/settings.json, 2) exportujte FLOWMINGO_API_KEY=fl_..., 3) spustite gemini a /mcp na potvrdenie, že nástroje sú uvedené.
{
"mcpServers": {
"flowmingo": {
"httpUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${FLOWMINGO_API_KEY}" },
"timeout": 30000
}
}
}
httpUrl vyberá natívny Streamable HTTP. Zástupný symbol ${FLOWMINGO_API_KEY} sa rozbalí z vášho prostredia, takže do súboru sa nezapíše žiadny surový kľúč. Preferujete OAuth? Gemini CLI to dokáže natívne — vynechajte blok headers a pridajte "authProviderType": "dynamic_discovery" do záznamu servera. CLI detekuje výzvu 401, objaví naše OAuth metadata a vykoná dynamickú registráciu klienta samo (nie je potrebné nastaviť žiadne Client ID).
Overte, či to funguje — v
geminisa opýtajte: "list my open jobs."
Ostatní klienti — Windsurf · Zed · Cline · Continue · Antigravity
Každý z nižšie uvedených klientov pracuje s rovnakým serverom – väčšina podporuje OAuth aj statický hlavičkový kľúč. Útržky kódu používajú statický kľúč cez premennú prostredia; odstráňte headers, aby klient mohol spustiť OAuth tam, kde ho podporuje. Pozor na špecifické názvy kľúčov pre jednotlivých klientov uvedené nižšie.
Google Antigravity
Pridajte https://mcp.flowmingo.ai/mcp ako vzdialený MCP server a vyberte možnosť jeho overenia: otvorí sa stránka Flowmingo, ktorá si vyžiada váš úplný API kľúč (pozri Ako vyzerá úplný kľúč v časti Overenie vyššie). Každé prostredie Antigravity (IDE, CLI) sa prihlasuje samostatne. V mcp_config.json aplikácie Antigravity sa adresa uvádza pod serverUrl a statický kľúč sa vkladá do bloku headers ako Authorization s Bearer a vaším úplným kľúčom, ako v oficiálnych príkladoch MCP pre Antigravity od Googlu. Nepodarilo sa nám otestovať každú verziu Antigravity, takže ak sa vaše ponuky líšia, aktuálne kroky nájdete v príručke Googlu.
Windsurf (Cascade)
~/.codeium/windsurf/mcp_config.json – Windsurf akceptuje serverUrl alebo url a podporuje OAuth (vynechajte headers, aby sa spustil).
{ "mcpServers": { "flowmingo": {
"serverUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Zed
~/.config/zed/settings.json – kľúč je context_servers; vynechajte headers pre natívne OAuth. Nastavte FLOWMINGO_API_KEY=fl_... vo svojom prostredí namiesto vkladania surového kľúča.
{ "context_servers": { "flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Cline
MCP Servery → Konfigurovať – nastavte type: "streamableHttp" (camelCase), inak sa použije nefunkčný 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 – pripojte sa cez most mcp-remote. Nastavte 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 }}"]
Overte, či to funguje – opýtajte sa: "zoznam mojich otvorených pracovných ponúk."
Akýkoľvek klient (mcp-remote)
Pre akéhokoľvek klienta, ktorý podporuje iba stdio (alebo budúceho klienta bez natívneho vzdialeného transportu), prepojte sa s Flowmingo pomocou príkazu mcp-remote stdio. --transport http-only je povinný — server nemá SSE.
Postup: 1) zabezpečte Node ≥ 18, 2) spustite most ako stdio príkaz vo svojom klientovi, 3) pri prvom OAuth sa otvorí prehliadač — vložte svoj kľúč.
# 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" }
}
}
}
Záchrana: ak sa autentifikácia zasekne, spustite rm -rf ~/.mcp-auth a skúste to znova. Nahraďte fl_YOUR_KEY svojím úplným kľúčom (pozri Ako vyzerá úplný kľúč v časti Autentifikácia vyššie). V poli JSON args[] sa vyhnite medzere za dvojbodkou v hlavičke (kvôli escapovaniu v npx).
Overte, že to funguje — spýtajte sa: "zoznam mojich otvorených pozícií."