Á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_projecteszkö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. Adelete_projectarra 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
/mcpvégpontra irányuló kéréseket az Origin alapján ellenőrzik: az átlátszatlannullorigó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
Csatlakoztassa az asszisztensét
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."
Cursor
A statikus fejléc a legegyszerűbb megoldás. Cursor használhat OAuth-t is (támogatja a Dynamic Client Registration funkciót) – ehhez távolítsa el a headers blokkot.
Lépések: 1) adja hozzá a szervert a ~/.cursor/mcp.json fájlhoz (lentebb), 2) állítsa be a FLOWMINGO_API_KEY környezeti változót a teljes kulcsával a shell profiljában, 3) lépjen ki a Cursor-ből, és indítsa újra egy terminálból, ahol a változó be van állítva, 4) a Beállítások → MCP menüben kapcsolja ki, majd be a szervert az újratöltéshez.
A Cursor számára láthatónak kell lennie a változónak. A Cursor a ${env:FLOWMINGO_API_KEY} értéket a saját környezetéből olvassa. Ha a dokkból vagy a Start menüből indítja, gyakran nem látja a terminál profiljában beállított változót, és a fejléc üresen vagy kibontatlanul érkezik, a szerver pedig Missing credential válasszal felel. Ha a Cursor terminálból történő indítása nem praktikus, cserélje ki a ${env:FLOWMINGO_API_KEY} értéket a fájlban a teljes kulcsára (és tartsa távol a ~/.cursor/mcp.json fájlt a git-től).
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
}
}
}
OAuth alternatíva – távolítsa el a headers blokkot; a Cursor Dynamic Client Registration-t futtat, és első csatlakozáskor böngészős hozzájárulási oldalt nyit meg:
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp"
}
}
}
Ellenőrizze, hogy működik – kérdezze meg: "listázd a nyitott állásaimat."
VS Code (Copilot, agent mód)
Az eszközök csak a Copilot Chat → Agent mód részben jelennek meg. A gyökér kulcs a servers (nem mcpServers), és a típus http. Az alábbi, kulcsot kérdező út a megbízható beállítás.
Lépések: 1) hozzon létre egy .vscode/mcp.json fájlt (vagy futtassa a MCP: Szerver hozzáadása → HTTP parancsot), 2) amikor elindítja a szervert, a VS Code megkérdezi a kulcsot (ez nem kerül bele a fájlba), 3) használja az Agent mód részben.
{
"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 }
]
}
A VS Code megpróbálhat OAuth-ot is használni, de a dokumentált OAuth konfiguráció ügyfélazonosítót vár; használja a fenti, kulcsot kérdező utat a megbízható beállítás érdekében.
Ellenőrizze, hogy működik-e – kérdezze meg: "list my open jobs." (listázza a nyitott állásaimat.)
Claude – claude.ai és Claude Desktop
Mindkettő ugyanazt a Csatlakozók UI-t és ugyanazt a másolás-URL folyamatot használja. Csak OAuth (nincs fejléc mező a UI-ban).
Lépések (web vagy asztali):
- Nyissa meg a Beállítások → Csatlakozók menüt, és kattintson az Egyéni csatlakozó hozzáadása gombra.
- Nevezze el
Flowmingo-nak, és másolja be a fenti MCP szerver URL-t. Hagyja üresen a Speciális → OAuth ügyfélazonosító / Titkos kulcs mezőket. - Kattintson a Hozzáadás → Csatlakozás gombra. A Flowmingo hozzájárulási oldalán másolja be a
fl_API kulcsát, és engedélyezze. - Ellenőrizze – kérdezze meg Claude-ot: "list my open jobs." (listázza a nyitott állásaimat.)
Remote MCP server URL: https://mcp.flowmingo.ai/mcp
Advanced → OAuth Client ID / Secret: (leave blank — Flowmingo uses Dynamic Client Registration)
Csapat / Vállalati: egy Tulajdonos egyszer hozzáadja a Szervezeti beállítások → Csatlakozók → Egyéni részben; a tagok ezután rákattintanak a Csatlakozás gombra.
Szüksége van statikus kulcsra a Claude Desktopon helyette? Használja az Bármely ügyfél (mcp-remote) lapot.
Böngészője megnyit egy Flowmingo hozzájárulási oldalt az első csatlakozáskor – illessze be API-kulcsát és engedélyezze. A későbbi leválasztáshoz törölje az API-kulcsot a Beállítások → Integrációk → API-kulcsok oldalon.
ChatGPT & OpenAI Codex CLI
Mindkettő OpenAI termék. A ChatGPT Developer Mode-ot használ egyedi csatlakozókhoz (csak OAuth); a Codex natívan csatlakozik a CLI-ből.
ChatGPT (web)
- A chatgpt.com oldalon (Plus / Pro / Business / Enterprise / Edu — nem mobil), nyissa meg a Settings → Apps → Advanced menüt, és kapcsolja be a Developer mode-ot.
- Apps → Create → nevezze el
Flowmingo-nak, illessze be az alábbi URL-t, transport Streamable HTTP, auth OAuth. - Nyissa meg a piszkozatot, kapcsolja be az eszközöket, majd Refresh.
- Csatolja a + menüvel egy csevegésben.
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)
A ChatGPT Developer Mode-ja csak OAuth-tal csatlakozik — nem fogad el statikus x-api-key / egyedi API-kulcs fejlécet. A sima és a mélykutatás csatlakozók csak search + fetch funkciót használnak (mindkettő rendelkezésére áll). Az írási eszközök (meghívás / áthelyezés / elutasítás) Developer Mode-ot igényelnek. Az a prompt, amelyet a ChatGPT egy eszköz futtatása előtt megmutat, a ChatGPT sajátja, és nem a Flowmingo jóváhagyása: a meghívás, az elutasítás és a fázisba helyezés, amely e-mailt küld a jelöltnek, mindig arra vár, hogy egy személy jóváhagyja azokat egy Flowmingo linken.
OpenAI Codex CLI
Nincs szükség hídra — a Codex natívan beszéli a Streamable HTTP-t.
# ~/.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
Ellenőrizze, hogy működik — kérdezze: "list my open jobs."
Gemini CLI és Code Assist
A Gemini CLI (és a Gemini Code Assist ügynök mód) a ~/.gemini/settings.json fájlon keresztül ér el egy távoli MCP szervert. A fogyasztói Gemini alkalmazás nem tud egyéni MCP csatlakozókat hozzáadni – ez az út csak CLI / Code Assist.
Lépések: 1) adja hozzá a szervert az mcpServers alá a ~/.gemini/settings.json fájlban, 2) exportálja a FLOWMINGO_API_KEY=fl_... értéket, 3) futtassa a gemini parancsot, és használja a /mcp parancsot az eszközök listázásának megerősítéséhez.
{
"mcpServers": {
"flowmingo": {
"httpUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${FLOWMINGO_API_KEY}" },
"timeout": 30000
}
}
}
A httpUrl a natív Streamelhető HTTP-t választja. A ${FLOWMINGO_API_KEY} helyőrző a környezetéből kerül kibontásra, így nem kerül nyers kulcs a fájlba. Előnyben részesíti az OAuth-ot? A Gemini CLI natívan is tudja – hagyja el a headers blokkot, és adjon hozzá "authProviderType": "dynamic_discovery" bejegyzést a szerverhez. A CLI érzékeli a 401-es kihívást, felfedezi az OAuth metaadatainkat, és önállóan végrehajtja a dinamikus ügyfélregisztrációt (nincs beállítandó ügyfélazonosító).
Ellenőrizze, hogy működik-e – a
gemini-ben kérdezze meg: "list my open jobs." (listázza a nyitott állásaimat.)
Egyéb kliensek — Windsurf · Zed · Cline · Continue · Antigravity
Az alábbi kliensek mindegyike ugyanazzal a szerverrel működik — a legtöbb támogatja az OAuth-ot és a statikus fejlécet is. A kódrészletek statikus kulcsot használnak környezeti változón keresztül; távolítsd el a headers mezőt, ha azt szeretnéd, hogy a kliens OAuth-ot használjon, amennyiben támogatja. Figyelj az alább említett kliensenkénti kulcsnév-csapdákra.
Google Antigravity
Add hozzá a https://mcp.flowmingo.ai/mcp címet távoli MCP-szerverként, és válaszd a hitelesítést: megnyílik egy Flowmingo-oldal, amely a teljes API-kulcsodat kéri (lásd a Mit jelent a teljes kulcs részt a fenti Hitelesítés szakaszban). Az Antigravity minden felülete (IDE, CLI) külön jelentkezik be. Az Antigravity mcp_config.json fájljában a cím a serverUrl alá kerül, a statikus kulcs pedig a headers blokkba Authorization mezőként, Bearer előtaggal és a teljes kulccsal, ahogyan a Google saját Antigravity MCP-példáiban szerepel. Nem tudtuk minden Antigravity-verziót tesztelni, ezért ha a menüid eltérnek ettől, a Google útmutatója tartalmazza az aktuális lépéseket.
Windsurf (Cascade)
~/.codeium/windsurf/mcp_config.json — a Windsurf elfogadja a serverUrl vagy url mezőt, és támogatja az OAuth-ot (a headers elhagyásával aktiválható).
{ "mcpServers": { "flowmingo": {
"serverUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Zed
~/.config/zed/settings.json — a kulcs a context_servers; a natív OAuth-hoz hagyd el a headers mezőt. Állítsd be a FLOWMINGO_API_KEY=fl_... környezeti változót, ne a nyers kulcsot illeszd be.
{ "context_servers": { "flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Cline
MCP Szerverek → Beállítás — állítsd be a type: "streamableHttp" értéket (camelCase), különben az elavult SSE-re esik vissza.
{ "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 — csatlakozz az mcp-remote hídon keresztül. Állítsd be a FLOWMINGO_AUTH_HEADER = Bearer fl_YOUR_KEY értéket.
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 }}"]
Ellenőrizd, hogy működik-e — kérdezd meg: "list my open jobs."
Bármely kliens (mcp-remote)
Bármely stdio-only kliens (vagy egy jövőbeli, natív távoli átvitellel nem rendelkező kliens) esetén az mcp-remote stdio parancs biztosít átjárót a Flowmingo-hoz. A --transport http-only kötelező — a szerver nem támogat SSE-t.
Lépések: 1) Ellenőrizze, hogy a Node ≥ 18, 2) futtassa az átjárót stdio parancsként a kliensben, 3) az első OAuth futtatáskor megnyílik a böngésző — illessze be a kulcsát.
# 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" }
}
}
}
Segítség: ha az azonosítás elakad, futtassa a rm -rf ~/.mcp-auth parancsot, és próbálja újra. Cserélje ki a fl_YOUR_KEY értéket a teljes kulcsára (lásd Hogyan néz ki egy teljes kulcs szakaszt a fenti Hitelesítés részben). JSON args[] esetén kerülje a szóközt a fejléc kettőspontja után (npx escape sajátosság).
Ellenőrizze, hogy működik — kérdezze meg: "listázza a nyitott pozícióimat."