Integrácie

Pripojiť AI Asistentov (MCP)

Pripojte akéhokoľvek asistenta AI kompatibilného s MCP — Claude, Claude Code, ChatGPT, Cursor, VS Code a ďalšie — k vašim náborovým údajom Flowmingo a pracujte so svojím pipeline v bežnom jazyku.

Our team is online
Potrebujete pomoc s integráciou?

Zasekli ste sa pri niektorom kroku alebo potrebujete technickú podporu? Náš tím vám rád pomôže — ozvite sa nám kedykoľvek a my vás prepojíme.

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 /mcp sa kontrolujú na ich Origin: nepriehľadný null origin 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

URL servera MCPhttps://mcp.flowmingo.ai/mcp

Pripojte svojho asistenta

Ktorého asistenta používate?

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í."