Integrációk

AI asszisztensek csatlakoztatása (MCP)

Csatlakoztasson bármilyen MCP-kompatibilis AI asszisztenst – Claude, Claude Code, ChatGPT, Cursor, VS Code és mások – a Flowmingo toborzási adataihoz, és dolgozza fel a folyamatot egyszerű nyelven.

Our team is online
Segítségre van szüksége az integrációhoz?

Elakadt egy lépésnél, vagy technikai segítségre van szüksége? Csapatunk szívesen segít — keressen minket bármikor, és gondoskodunk a kapcsolat felvételéről.

Áttekintés

Csatlakoztass bármely MCP-kompatibilis AI-asszisztenst a Flowmingo toborzási adataidhoz — olvassa az állásaidat és a jelölteket, és védett műveleteket hajthat végre (meghívás, áthelyezés, elutasítás, eltávolítás egy projektről), biztonságosan, a te engedélyeddel. Két további engedéllyel, amelyeket te magad kapcsolsz be, az asszisztens toborzási projekteket és értékeléseket is létrehozhat, valamint közzétehet, lezárhat vagy kiemelhet egy álláshirdetést (lásd Mit tehetsz). Új az MCP-ben? Ez a nyílt szabvány, amely lehetővé teszi, hogy az AI-asszisztensek olyan eszközökkel kommunikáljanak, mint a Flowmingo. Ismerd meg, mi az MCP.

Transport: Streamable HTTP (a modern távoli transport). Nincs örökölt SSE — mindig a /mcp végpontra mutass, soha ne a /sse-re.

Kezeld az API-kulcsodat úgy, mint a jelszavadat. Részesítsd előnyben az OAuth-ot, a promptolt bevitelt vagy a környezeti változót, mintha egy nyers fl_... kulcsot illesztenél egy fájlba, amelyet gitbe commitolhatsz (pl. .vscode/mcp.json, ~/.cursor/mcp.json, a Continue konfigurációd).

Hitelesítés — két lehetőség

A — Bejelentkezés Flowmingo-val (OAuth, ajánlott). A böngésződ megnyit egy Flowmingo hozzájárulási oldalt; ott beilleszted az API-kulcsodat. Az asszisztens soha nem kapja meg a nyers kulcsodat. Hozzáférési tokent és frissítési tokent kap, amelyekkel új hozzáférési tokent kérhet. A bejelentkezés nem tart örökké. A frissítési token alapértelmezés szerint körülbelül 30 napig él, a kiállításától számítva, a bejelentkezéskor vagy a legutóbbi frissítéskor, így a körülbelül ennyi ideig nem használt bejelentkezés lejár, és egy olyan Flowmingo-kiadás, amely megváltoztatja a bejelentkezések tárolását, szintén megkövetelheti az újrabejelentkezést. Az asszisztens ezután újra bejelentkezést kér, és újra beilleszted a kulcsodat. Ha előbb meg akarod szüntetni, töröld az API-kulcsot. Nincs létrehozandó kliensazonosító vagy titkos kód (a Flowmingo Dynamic Client Registrationt használ). Azokon a klienseken, amelyek „Speciális” OAuth-beállításokat mutatnak (pl. Claude.ai), hagyd üresen a Client ID és Secret mezőket.

B — Statikus API-kulcs (fejléc). Küldd el a kulcsodat az alábbi fejlécek egyikeként:

x-api-key: fl_YOUR_KEY
Authorization: Bearer fl_YOUR_KEY

Szerezd meg a kulcsodat a Flowmingo → Beállítások → Integrációk → API-kulcsok menüpontban. Jelöld be a Read hiring data és Read candidates opciót — az első az állásokat, a pipeline-t és az eredményeket fedi le, a második teszi lehetővé, hogy az asszisztens fel tudjon keresni valakit. Add hozzá a Manage pipeline / Invite candidates opciót a védett írási műveletekhez. Ha azt szeretnéd, hogy az asszisztens projekteket és értékeléseket hozzon létre, valamint közzétegyen vagy kiemeljen egy álláshirdetést, jelöld be a Create hiring projects és Create assessments opciót is. Először olvasd el a Létrehozás és közzététel részt a Mit tehetsz alatt: ez a két engedély opcionális, és a kulcs létrehozójának Tulajdonosnak vagy Adminisztrátornak kell lennie.

Hogyan néz ki egy teljes kulcs. Egy hosszú érték: fl_live_, a kulcs nyilvános neve, egy pont, majd egy hosszú titkos rész. A titkos fele egyszer jelenik meg, közvetlenül a kulcs létrehozása után; később az API-kulcsok listája csak a kezdetét mutatja. A pont nélküli érték csak a kulcs neve, és elutasításra kerül. Bárhol is írja ez az útmutató, hogy fl_YOUR_KEY, cseréld le mindet a teljes kulcsodra, idézőjelek és szóközök nélkül.

Ha nem csatlakozik. A hibás vagy üres kulcs Missing credential vagy The Flowmingo API key was rejected üzenetet ad; mindkettő jelentheti, hogy az érték soha nem érte el teljes egészében minket, ezért először ellenőrizd az értéket. Egy olyan beállítás, mint a ${env:FLOWMINGO_API_KEY}, csak akkor működik, ha a program látja azt a változót, és a dokkból vagy a Start menüből megnyitott szerkesztő gyakran nem olvassa be a terminálprofilodat. Indítsd el egy olyan terminálból, ahol a változó be van állítva, vagy írd be a teljes kulcsot a fájlba (és tartsd távol ezt a fájlt a gittől).

Melyiket válasszam? A legtöbb kliens mindkettőt támogatja; néhány (pl. ChatGPT) csak OAuth — minden lap jelzi, hogy az adott kliens mit támogat. Általában az OAuth alkalmas interaktív asszisztensekhez (Claude.ai, ChatGPT, VS Code); az API-kulcs fejléc a CLI-khez, a fej nélküli/CI-khez és a szerkesztőkhöz illik, ahol inkább beírnál egy kulcsot.

Mit tehetsz

Az olvasásokhoz nem kell jóváhagyás. A legtöbb írás védett. Egy meghívás, az Elutasítás művelettel végrehajtott elutasítás, jelöltek eltávolítása egy projektről, egy projekt törlése, vagy általában egy olyan szakaszba történő áthelyezés, amely e-mailt küld a jelöltnek, arra vár, hogy egy személy jóváhagyja egy linken, bejelentkezve a Flowmingo-ba. Az asszisztens nem hagyhatja jóvá, és a chatbe írt „igen” nem számít. A szakasz e-mail-beállítását a kérés időpontjában ellenőrzik. Jegyzet, értékelés, shortlist, címke vagy olyan szakaszba történő áthelyezés esetén, amely nem küld e-mailt a jelöltnek, az asszisztensnek először előnézetet kell mutatnia, és csak a beleegyezéseddel léphet tovább, ami utasítás számára, nem pedig zárolás. Az a prompt, amelyet az AI-kliensed egy eszköz futtatása előtt megjelenít, a kliens sajátja, és nem a Flowmingo jóváhagyása: egy meghívás, az Elutasítás művelettel végrehajtott elutasítás és egy e-mailt küldő szakaszba történő áthelyezés továbbra is a jóváhagyási linkre vár, függetlenül attól, hogy a kliens mit kérdez. A jóváhagyási link 15 perc után lejár, és egy kérés több jelöltre vagy jelentkezésre (legfeljebb 50) egy jóváhagyást jelent, amely mindenkit felsorol. Ha egy módosítás függőben van, az asszisztens ellenőrizheti az állapotát, visszavonhatja, amíg várakozik, és visszavonhat egy visszafordítható módosítást (jegyzet, értékelés, shortlist-jelölés, címke vagy olyan áthelyezés, amely nem küldött e-mailt senkinek) 24 órán belül. A visszavonás nem mindig érhető el: a módosításnak vissza kell térnie egy visszavonási hivatkozással, amelynek rögzítése a legjobbat jelenti, és egy olyan jelölt áthelyezésénél, akinek nincs korábbi szakasza, nincs ilyen, ezért az asszisztensnek ellenőriznie kell, és jeleznie kell, ha nincs visszaút. A már elküldött e-mail nem vonható vissza. A Létrehozás és közzététel alatt felsorolt eszközök kivételt képeznek mindez alól, kivéve a delete_project eszközt: azonnal működnek, és nem várnak jóváhagyásra. Az eltávolítás és a projekt törlése nem vonható vissza. Minden a szervezetedre korlátozódik.

Olvasás

Képesség Mit csinál
Álláshirdetések listázása Böngészd a szervezeted nyitott és lezárt szerepköreit.
Interjúkészletek és projektek listázása Lásd az értékeléseidet (interjúkészletek) minden típusban (AI-interjúk, szerepjátékok, készségtesztek, technikai tesztek, CV-értékelések, bemutatók és felvételek; kérdőívek, ha kéred), valamint a toborzási projektjeidet.
Jelölt pipeline listázása Tekintsd meg a jelentkezéseket szakaszok szerint egy projekten belül.
Értékelési eredmények és pontszámok olvasása Húzd le az összes típusú eredményt: AI-interjúk, szerepjátékok, készségtesztek, technikai tesztek, CV-értékelések, bemutatók, felvételek és kérdőívek. Minden eredmény fel van címkézve a típusával. Csak bizonyos típusok tartalmaznak AI-pontszámot: a bemutató és a kérdőív soha nem kap pontszámot, a készségteszt pedig százalékos.
Jelölt keresése Kérj le egy jelölt nevét, e-mail-címét és CV-jét.
Jelöltek keresése Keress jelölteket név vagy e-mail alapján.
Jelöltek összehasonlítása Állíts egymás mellé 2–10 jelöltet. Szükséges a Read candidates engedély, valamint a Read hiring data.
Toborzási áttekintés A tölcsér mindenhez, amit a kapcsolatod elér (az egész vállalat, hacsak a kulcsot nem egyes projektekre korlátozott személy hozta létre), vagy szűkítve, ha kéred: jelentkezések szakaszonként, aktív vs. elutasított, és minden olyan értékelési típusnál, amelynek van eredménye, befejezett vs. folyamatban lévő eredmények és az átlagos pontszám. Egy projekt minden számot szűkít, de az eredményszámlálói az adott projekthez kapcsolódó értékelések eredményeit fedik le, így egy másik projekt jelöltje, amely osztozik egy ilyen értékelésen, szintén beleszámíthat. Egy értékelés csak az eredményszámlálókat szűkíti: a szakasz- és jelentkezésszámok a kapcsolatod által elérhető mindenen maradnak. A típusok soha nem adódnak össze.
Legjobb jelöltek A legmagasabb rangsorú eredmények, összpontszám szerint rendezve. Minden értékelési típus együtt van rangsorolva, hacsak nem kérsz egy típust vagy egy értékelést (interjúkészletet).
Értékelési eredmény részletei Egy eredmény kompetenciánkénti pontszámai és az AI-összefoglaló azoknál a típusoknál, amelyeknél van ilyen. A készségteszt, a technikai teszt, a bemutató és a kérdőív keveset vagy semmit sem tartalmaz.
Álláshirdetés részletei Egyetlen álláshirdetés teljes részlete.
Nyilvános-e az álláshirdetés? (get_job_post_publication) Bárki megnyithatja-e az álláshirdetés nyilvános oldalát: élő, még az AI-tartalomellenőrzésre vár, az elutasította, megjelölte, kikapcsolta, vagy a projektje nem nyitott. Továbbá a nyilvános címe és a kiemelése (ki, flowmingo vagy bővített). Szükséges: Read hiring data.
Közelgő interjúk Meghívások bármilyen értékelésre, amelyek elküldésre kerültek vagy ütemezettek, és még nem fejeződtek be. Ez nem a még függőben lévők száma: egy olyan meghívás, amelynek jelöltje emlékeztetőt kapott, vagy megnyitotta/megkattintotta a linket, kimarad, amíg a jelölt el nem kezdi, és az is, amelyik nem érkezett meg.

Írás (védett)

Képesség Mit csinál
Jelöltek meghívása egy értékelésre Előkészíti a meghívókat egy AI-interjúhoz, szerepjátékhoz, készségteszthez vagy technikai teszthez, és arra vár, hogy egy személy jóváhagyja őket egy linken. Addig semmi nem kerül elküldésre. Egy értékelés és legfeljebb 50 jelölt kérésenként; a készségteszt vagy a technikai teszt projektet és e-mail-címet igényel minden jelölthöz, és egy szponzorált teszt terhelheti a szervezeted pénztárcáját, amikor egy jelölt elindítja.
Jelölt áthelyezése másik szakaszba Az olyan szakaszba történő áthelyezés, amely e-mailt küld a jelöltnek, általában arra vár, hogy egy személy jóváhagyja egy linken (a szakasz e-mail-beállítása egyszer, közvetlenül az áthelyezés előtt kerül beolvasásra, így egy abban a pillanatban bekapcsolt beállítás még engedélyezheti az áthelyezést jóváhagyás nélkül). Minden más áthelyezés: az asszisztensnek előnézetet kell mutatnia, és meg kell várnia az igen válaszodat, és általában 24 órán belül visszavonható, ha visszavonási hivatkozással tért vissza. Legfeljebb 50 jelentkezés kérésenként.
Jelentkezés elutasítása Jóváhagyást kér egy linken. Ha egy személy jóváhagyja, a Flowmingo megkísérli áthelyezni a jelentkezést a projekt Elutasított szakaszába; ezt követően ellenőrizd az eredményt. Legfeljebb 50 jelentkezés kérésenként.
Jelöltek eltávolítása egy projektről (remove_application) Szükséges: Manage pipeline. Jóváhagyást kér egy linken. Ha egy személy jóváhagyja, a Flowmingo törli a jelentkezéseket a projektből; a jelölt profilja a tehetségállományodban és más projektekben marad. Ez nem elutasítás, és nincs visszavonás. Legfeljebb 50 jelentkezés kérésenként.
Jegyzet hozzáadása egy eredményhez Az asszisztensnek előnézetet kell mutatnia a javasolt jegyzetről, és meg kell várnia az igen válaszodat a mentés előtt. A jegyzet egy értékelési eredményhez (bármilyen típusú) tartozik, nem a jelölthöz általában.
Értékelés egy eredményre Az asszisztensnek előnézetet kell mutatnia az értékelésről, és meg kell várnia az igen válaszodat. Az értékelés egy értékelési eredményre vonatkozik.
Shortlist egy eredmény Az asszisztensnek előnézetet kell mutatnia a shortlist-módosításról, és meg kell várnia az igen válaszodat. Egy értékelési eredményre vonatkozik.
Címke / hozzáadás tehetség gyűjteményhez Az asszisztensnek előnézetet kell mutatnia a címke- vagy tehetséggyűjtemény-módosításról, és meg kell várnia az igen válaszodat.
Módosítás ellenőrzése, visszavonása vagy visszavonása Ellenőrizd, hol áll egy függőben lévő módosítás (várakozó, végrehajtott, sikertelen, lejárt vagy újabb kérés váltotta fel), vonj vissza egyet, amely még jóváhagyásra vár, vagy vonj vissza egy visszafordítható módosítást 24 órán belül, ha visszavonási hivatkozással tért vissza.

Létrehozás és közzététel (azonnal működik, kivéve a projekt törlését)

Ezek az eszközök dolgokat hoznak létre, és nyilvánossá teszik őket. Másként viselkednek, mint a fenti védett írások:

  • Azonnal működnek, kivéve a delete_project eszközt. Semmi nem vár arra, hogy egy személy jóváhagyja egy linken, és egyik sem küld e-mailt egy jelöltnek. A delete_project arra vár, hogy egy Tulajdonos vagy Adminisztrátor jóváhagyja egy linken.
  • A kulcs létrehozójának Tulajdonosnak vagy Adminisztrátornak kell lennie az itt található összes eszközhöz, kivéve a lemondást, amelyhez csak Invite candidates szükséges. Az eszközök az API-kulcsot létrehozó személy engedélyeivel működnek. Ha az illető Tag, a hívás elutasításra kerül.
  • Két engedély opcionális. A Create hiring projects és a Create assessments alapértelmezés szerint nincs megadva. Bejelentkezéssel (A opció) az asszisztens csak akkor kapja meg őket, ha mindkét feltétel teljesül: a kliens név szerint kéri őket a csatlakozáskor, és a hozzájárulási oldalon beillesztett API-kulcs tartalmazza őket. Az a kliens, amelyik nem küld jogosultságlistát, a kulcs által birtokolt négy alapjogosultságot kapja (Read hiring data, Read candidates, Manage pipeline, Invite candidates). A két jogosultság egyikét sem kapja meg, ezért az asszisztens nem látja azokat az eszközöket, amelyekhez ezek szükségesek. Statikus kulcs esetén (B opció) az asszisztens ezeket az eszközöket látja, függetlenül attól, hogy a kulcs milyen jogosultságokkal rendelkezik. A Flowmingo megtagad minden olyan hívást, amelyet a kulcs nem engedélyez.
  • Egyes hívások sokáig tarthatnak. A közzététel az AI-tartalomellenőrzésre vár, legfeljebb körülbelül 90 másodpercig. Egy projekt vagy értékelés létrehozása AI-generálást használ, és tovább tarthat (a technikai teszt 3–9 percet vesz igénybe). Amikor a válasz azt mondja, hogy a munka még folyamatban van, az asszisztens ugyanazzal az idempotencia-kulccsal újra hív, hogy megnézze, hol tart. Az újrapróbálkozás soha nem hoz létre második projektet vagy értékelést.
Képesség Mit csinál
Toborzási projekt létrehozása (create_project) Szükséges: Create hiring projects (opcionális). Létrehoz egy projektet a négy alapértelmezett szakaszával és egy álláshirdetéssel, amelyet ugyanaz az AI ír, mint az irányítópulton, cím, pozíció és opcionális leírás alapján. Alapértelmezés szerint CV-értékelést és AI-interjút is készít; az asszisztens más értékeléseket is megnevezhet, vagy egyet sem. Az álláshirdetés be van kapcsolva, és nyilvánossá válik, amint az AI-tartalomellenőrzés jóváhagyja, általában egy percen belül. Korlát: 10 projekt percenként és 300 naponta a vállalatod számára. Az idempotencia-kulcs opcionális: ha kimarad, az argumentumokból készül egy, így az újrapróbálkozás soha nem hoz létre második projektet.
Értékelés létrehozása (create_assessment) Szükséges: Create assessments (opcionális). Létrehoz egy értékelést az AI-jal: AI-interjút, CV-értékelést, készségtesztet, bemutatót, technikai tesztet vagy szerepjátékot, munkakör és opcionális munkaköri leírás, név, projekt és nyelv alapján (olyan címke, mint en vagy vi-VN; a készségteszt és a technikai teszt figyelmen kívül hagyja a nyelvet). Csatold egy projekthez, hogy jelölteket lehessen meghívni egy készségtesztre, technikai tesztre vagy bemutatóra. Az idempotencia-kulcs opcionális, mint fent.
Álláshirdetés közzététele (publish_job_post) Szükséges: Create hiring projects. Bekapcsolja az álláshirdetést, és biztosítja, hogy az AI-tartalomellenőrzés lefusson. A válasz megmondja, hogy az oldal most él-e, még a vizsgálatra vár, vagy az elutasította. A toborzási projektnek aktívnak kell lennie.
Álláshirdetés közzétételének visszavonása (unpublish_job_post) Szükséges: Create hiring projects. Kikapcsolja az álláshirdetést, így a nyilvános linkje nem nyílik meg. Alapértelmezés szerint a kiemelés is kikapcsol (withdraw_boost igaz).
Álláshirdetés kiemelése (boost_job_post) Szükséges: Create hiring projects. A kiemelést a következőre állítja: off, flowmingo vagy extended. A kiemelés ingyenes. A növeléshez az álláshirdetésnek bekapcsolva kell lennie, a projektjének aktívnak, vállalati logóval és leírással, valamint az AI-tartalomellenőrzésnek lefutottnak; egy vállalat naponta 50 kiemelést emelhet.
Projekt megnyitása, piszkozat vagy archiválás (set_project_state) Szükséges: Create hiring projects. Áthelyezi a toborzási projektet active, draft és archived állapot között. Amikor egy projekt piszkozat vagy archivált állapotban van, az álláshirdetésre mutató linkje le van zárva. A jelölt adatai megmaradnak.
Ütemezett meghívó lemondása (cancel_scheduled_invite) Szükséges: Invite candidates. Lemond egy későbbre ütemezett, még el nem küldött meghívót a meghívó eredményéből származó meghívóazonosítóval. Senki nem kap e-mailt. A személy a fiókodban és a projektfalon marad.
Toborzási projekt törlése (delete_project) Szükséges: Create hiring projects (opcionális). Csak kérdez: nem töröl azonnal, jóváhagyást kér egy linken, és semmi nem törlődik, amíg egy Tulajdonos vagy Adminisztrátor jóvá nem hagyja. Csak aktív projekt törölhető. Ha egy személy jóváhagyja, a Flowmingo törli a projektet és annak álláshirdetéseit; a jelöltjeinek jelentkezéseit nem törli egyenként, és a jelöltprofilok és -kapcsolatok, az értékeléseid és a meghívási linkjeid megmaradnak. Nincs visszavonás.

Biztonság és bizalom

  • Az adataid szervezeti szintűek — az asszisztens soha nem láthatja egy másik vállalat adatait.
  • OAuth esetén az asszisztens soha nem kapja meg az API-kulcsodat. Hozzáférési tokent kap, amely egy óra után lejár, és csendben frissül, amíg kapcsolatban marad. Maga a bejelentkezés addig tart, amíg a frissítési tokenje, alapértelmezés szerint körülbelül 30 nap a kiállításától vagy utolsó frissítésétől számítva, így körülbelül 30 nap használat nélkül lejár, és ezután újra bejelentkezel. Statikus fejléc esetén (B lehetőség) az asszisztens kliensének birtokában van a kulcsod, és minden kéréssel elküldi, ezért tartsd távol azoktól a fájloktól, amelyeket megoszthatsz vagy commitolhatsz.
  • Az asszisztens leválasztása: töröld az API-kulcsot, amellyel felhatalmaztad, a Beállítások → Integrációk → API-kulcsok menüpontban. A hozzáférés azonnal megszűnik. Még nincs asszisztensenkénti leválasztás, ezért ha egyenként szeretnéd visszavonni, adj minden asszisztensnek saját kulcsot.
  • A /mcp végpontra irányuló kéréseket az Origin alapján ellenőrzik: az átlátszatlan null origót mindig elutasítják, és az ellenőrzés egy engedélyezési listára zárható, de alapértelmezés szerint minden valódi origót elfogadnak, így a védelem a hitelesítő adataid, nem az origó. Minden munkamenet a megnyitó hitelesítő adathoz van kötve.

A hitelesítés módjáról lásd: Hitelesítés — két lehetőség; a pontos olvasási, védett írási és azonnali műveletekért lásd: Mit tehetsz. Ha kész vagy, ugorj a Csatlakoztasd az asszisztensedet részhez, és válaszd ki a kliensedet.

MCP szerver URL

MCP szerver URLhttps://mcp.flowmingo.ai/mcp

Csatlakoztassa az asszisztensét

Melyik asszisztenst használja?

Claude Code (CLI)

Egyetlen parancs hozzáadja a Flowmingo-t a natív Streamable HTTP fölé. Elsődlegesen OAuth-t használj; a statikus --header csak alternatíva.

Lépések: 1) add hozzá a szervert, 2) jelentkezz be (böngésző → kulcs beillesztése), 3) claude mcp list az ellenőrzéshez.

# 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

Figyelem: a kapcsolóknak a név előtt kell állniuk, és mindig --transport http-t használj (soha ne sse-t). Cseréld le a fl_YOUR_KEY értéket a teljes kulcsodra (lásd Mit jelent a teljes kulcs című részt a fenti Hitelesítés szakaszban).

Ellenőrizd, hogy működik — kérdezd meg: "listázd a nyitott állásaimat."