Yleiskatsaus
Yhdistä mikä tahansa MCP-yhteensopiva AI-assistentti Flowmingon rekrytointitietoihisi — lue työpaikkailmoituksesi ja kandidaattisi sekä suorita suojattuja toimintoja (kutsu, hylkää, siirrä, poista projektista) turvallisesti, luvallasi. Kahdella lisäoikeudella, jotka otat itse käyttöön, assistentti voi myös luoda rekrytointiprojekteja ja arviointeja sekä julkaista, sulkea tai nostaa työpaikkailmoituksen (katso Mitä voit tehdä). Etkö tunne MCP:tä? Se on avoin standardi, joka antaa AI-assistenteille mahdollisuuden keskustella työkalujen, kuten Flowmingon, kanssa. Opi mikä MCP on.
Kuljetus: Streamable HTTP (moderni etäkuljetus). Legacy-SSE:tä ei ole — osoita aina asiakkaasi osoitteeseen /mcp, ei koskaan /sse.
Käsittele API-avaintasi kuin salasanaa. Suosi OAuthia, kehotettua syöttöä tai ympäristömuuttujaa sen sijaan, että liittäisit raa'an
fl_...-avaimen tiedostoon, jonka saatat sitouttaa gitiin (esim..vscode/mcp.json,~/.cursor/mcp.json, Continue-asetuksiisi).
Todennus — kaksi vaihtoehtoa
A — Kirjaudu Flowmingoon (OAuth, suositeltu). Selain avaa Flowmingon suostumussivun; liität API-avaimesi sinne. Assistentti ei koskaan vastaanota raakaa avaintasi. Se vastaanottaa käyttöoikeustunnuksen ja päivitystunnuksen, joita se voi käyttää uuden käyttöoikeustunnuksen saamiseen. Kirjautuminen ei kestä ikuisesti. Päivitystunnus elää oletuksena noin 30 päivää siitä, kun se on myönnetty, kirjautumisen yhteydessä tai viimeisimmän päivityksen yhteydessä, joten käyttämätön kirjautuminen vanhenee noin näin pitkän ajan kuluttua, ja Flowmingon julkaisu, joka muuttaa kirjautumisten tallennustapaa, saattaa myös vaatia sinua kirjautumaan uudelleen. Assistentti pyytää sinua kirjautumaan uudelleen, ja liität avaimesi uudelleen. Katkaistaksesi yhteyden aiemmin, poista kyseinen API-avain. Ei asiakastunnusta tai salaisuutta luotavaksi (Flowmingo käyttää Dynamic Client Registration -menetelmää). Asiakkaissa, jotka näyttävät "Advanced" OAuth-asetukset (esim. Claude.ai), jätä Client ID ja Secret tyhjiksi.
B — Staattinen API-avain (otsake). Lähetä avaimesi jompanakumpana otsakkeena:
x-api-key: fl_YOUR_KEY
Authorization: Bearer fl_YOUR_KEY
Hanki avaimesi kohdasta Flowmingo → Asetukset → Integraatiot → API-avaimet. Valitse Read hiring data ja Read candidates — ensimmäinen kattaa työpaikat, putkilinjan ja tulokset, toinen antaa assistentin etsiä henkilön. Lisää Manage pipeline / Invite candidates suojattuja kirjoitustoimintoja varten. Jotta assistentti voi luoda projekteja ja arviointeja sekä julkaista tai nostaa työpaikkailmoituksen, valitse myös Create hiring projects ja Create assessments. Lue Luo ja julkaise kohdasta Mitä voit tehdä ensin: nämä kaksi oikeutta ovat valinnaisia, ja avaimen luojan on oltava omistaja tai ylläpitäjä.
Miltä täydellinen avain näyttää. Yksi pitkä arvo: fl_live_, avaimen julkinen nimi, piste ja sitten pitkä salaisuus. Salainen osa näytetään kerran, heti avaimen luomisen jälkeen; myöhemmin API-avainten luettelossa näkyy vain sen alku. Arvo ilman pistettä on vain avaimen nimi, ja se hylätään. Aina kun tässä oppaassa kirjoitetaan fl_YOUR_KEY, korvaa kaikki se täydellisellä avaimellasi ilman lainausmerkkejä ja välilyöntejä.
Jos yhteys ei toimi. Huono tai tyhjä avain palautuu Missing credential tai The Flowmingo API key was rejected; molemmat voivat tarkoittaa, että arvo ei koskaan saavuttanut meitä kokonaisena, joten tarkista arvo ensin. Asetus, kuten ${env:FLOWMINGO_API_KEY}, toimii vain, jos ohjelma näkee kyseisen muuttujan, ja editori, joka on avattu telakasta tai Käynnistä-valikosta, ei usein lue pääteprofiiliasi. Käynnistä se joko terminaalista, jossa muuttuja on asetettu, tai kirjoita täydellinen avaimesi tiedostoon (ja pidä tiedosto poissa gitistä).
Kumman valita? Useimmat asiakkaat tukevat molempia; muutamat (esim. ChatGPT) ovat OAuth-vain — jokainen välilehti huomauttaa, mitä asiakas tukee. Yleensä OAuth sopii vuorovaikutteisille assistenteille (Claude.ai, ChatGPT, VS Code); API-avaimen otsake sopii CLI:ille, päättömille/CI-ympäristöille ja editoreille, joihin haluat mieluummin syöttää avaimen.
Mitä voit tehdä
Lukeminen ei vaadi hyväksyntää. Useimmat kirjoitukset ovat suojattuja. Kutsu, hylkääminen Hylkää-toiminnolla, kandidaattien poistaminen projektista, projektin poistaminen tai, normaalisti, siirto vaiheeseen, joka on asetettu lähettämään sähköpostia kandidaatille, odottaa, että henkilö hyväksyy sen linkissä, kirjautuneena Flowmingoon. Assistentti ei voi hyväksyä sitä, eikä kyllä-sana keskustelussa kelpaa. Vaiheen sähköpostiasetus tarkistetaan, kun siirtoa pyydetään. Muistiinpanon, arvioinnin, shortlistan, tagin tai siirron kohdalla vaiheeseen, jota ei ole asetettu lähettämään sähköpostia kandidaatille, assistenttia kehotetaan näyttämään esikatselu ensin ja jatkamaan vain, kun hyväksyt, mikä on käsky sille, ei lukko. Kehote, jonka AI-asiakas näyttää ennen työkalun suorittamista, on asiakkaan oma, eikä se ole Flowmingon hyväksyntä: kutsu, hylkääminen Hylkää-toiminnolla ja siirto sähköpostivaiheeseen odottavat silti hyväksyntälinkkiä riippumatta siitä, mitä asiakas on kysynyt. Hyväksyntälinkki vanhenee 15 minuutin kuluttua, ja yksi pyyntö useille kandidaateille tai hakemuksille (enintään 50) on yksi hyväksyntä, joka luettelee kaikki. Kun muutos on vaiheistettu, assistentti voi tarkistaa sen tilan, peruuttaa sen, kun se vielä odottaa, ja kumota palautuvan muutoksen (muistiinpano, arviointi, shortlistamerkintä, tagi tai siirto, joka ei lähettänyt sähköpostia kenellekään) 24 tunnin kuluessa. Peruutus ei ole aina mahdollinen: muutoksen on palattava peruutusviitteellä, sellaisen tallentaminen on parhaan yrityksen mukaan, ja siirrolla kandidaatille, jolla ei ole aiempaa vaihetta, ei ole sellaista, joten assistentin tulisi tarkistaa ja sanoa, kun paluuta ei ole. Lähetettyä sähköpostia ei voi kumota. Luo ja julkaise -osiossa luetellut työkalut ovat poikkeus tähän kaikkeen, paitsi delete_project: ne toimivat välittömästi eivätkä ole hyväksyntää varten vaiheistettuja. Poistoa ja projektin poistamista ei voi kumota. Kaikki on rajattu organisaatioosi.
Lue
| Ominaisuus | Mitä se tekee |
|---|---|
| Listaa työpaikkailmoitukset | Selaa organisaatiosi avoimia ja suljettuja rooleja. |
| Listaa haastattelusetit ja projektit | Näe arviointisi (haastattelusetit) kaikissa muodoissa (AI-haastattelut, roolipelit, taitotestit, tekniset testit, CV-arvioinnit, esittelyt ja tallenteet; kyselylomakkeet, kun niitä pyydät) ja rekrytointiprojektisi. |
| Listaa kandidaattiputkesi | Näe hakemukset vaiheittain projektin sisällä. |
| Lue arviointitulokset ja pisteet | Hae tulokset kaikissa muodoissa: AI-haastattelut, roolipelit, taitotestit, tekniset testit, CV-arvioinnit, esittelyt, tallenteet ja kyselylomakkeet. Jokainen tulos on merkitty tyypillään. Vain tietyt tyypit sisältävät AI-pisteet: esittelyä ja kyselylomaketta ei koskaan pisteytetä, ja taitotesti on prosenttiosuus. |
| Etsi kandidaatti | Hae yhden kandidaatin nimi, sähköposti ja CV. |
| Etsi kandidaatteja | Löydä kandidaatteja nimen tai sähköpostin perusteella. |
| Vertaile kandidaatteja | Aseta 2–10 kandidaattia vierekkäin. Vaatii Read candidates-oikeuden sekä Read hiring data-oikeuden. |
| Rekrytoinnin yleiskatsaus | Suppilo kaikkeen, mihin yhteytesi pääsee (koko yritys, ellei avainta ole luonut henkilö, joka on rajoitettu tiettyihin projekteihin), tai kavennettu pyynnöstäsi: hakemukset vaiheittain, aktiiviset vs. hylätyt, ja jokaiselle arviointityypille, jolla on tuloksia, valmiit vs. keskeneräiset tulokset ja keskimääräinen pistemäärä. Projekti kaventaa kaikki laskennat, mutta sen tuloslaskennat kattavat tulokset projektiin linkitetyistä arvioinneista, joten toisen projektin kandidaatti, joka jakaa yhden näistä arvioinneista, voidaan myös laskea. Arviointi kaventaa vain tuloslaskentoja: vaihe- ja hakemusmäärät pysyvät kaikessa, mihin yhteytesi pääsee. Tyypit eivät koskaan summaudu yhteen. |
| Parhaat kandidaatit | Korkeimmin sijoittuneet tulokset järjestettynä kokonaispistemäärän mukaan. Kaikki arviointityypit sijoitetaan yhdessä, ellet pyydä yhtä tyyppiä tai yhtä arviointia (haastattelusettiä). |
| Arviointituloksen yksityiskohdat | Yhden tuloksen osaamiskohtaiset pisteet sekä AI-yhteenveto tyypeille, joilla niitä on. Taitotestissä, teknisessä testissä, esittelyssä ja kyselylomakkeessa on vähän tai ei lainkaan. |
| Työpaikkailmoituksen yksityiskohdat | Yhden työpaikkailmoituksen täydet tiedot. |
Onko työpaikkailmoitus julkinen? (get_job_post_publication) |
Voiko kuka tahansa avata työpaikkailmoituksen julkisen sivun: live, vielä odottamassa AI-sisällöntarkistusta, hylätty sen toimesta, liputettu, pois päältä vai sen projekti ei ole avoin. Myös sen julkinen osoite ja sen nosto (pois, flowmingo tai laajennettu). Vaatii Read hiring data-oikeuden. |
| Tulevat haastattelut | Kutsut mihin tahansa arviointityyppiin, jotka on lähetetty tai on ajoitettu eivätkä ole vielä valmistuneet. Se ei ole lukumäärä kaikista vielä avoimista: kutsu, jonka kandidaatti on muistutettu tai on avannut tai klikannut linkkiä, jätetään pois, kunnes kandidaatti aloittaa, samoin kuin kutsu, jota ei ole voitu toimittaa. |
Kirjoita (suojattu)
| Ominaisuus | Mitä se tekee |
|---|---|
| Kutsu kandidaatteja arviointiin | Valmistelee kutsut AI-haastatteluun, roolipeliin, taitotestiin tai tekniseen testiin ja odottaa, että henkilö hyväksyy ne linkissä. Mitään ei lähetetä ennen sitä. Yksi arviointi ja enintään 50 kandidaattia pyyntöä kohden; taitotesti tai tekninen testi vaatii projektin ja sähköpostin jokaiselle kandidaatille, ja sponsoroitu voi veloittaa organisaatiosi lompakkoa, kun kandidaatti aloittaa sen. |
| Siirrä kandidaatti toiseen vaiheeseen | Siirto vaiheeseen, joka on asetettu lähettämään sähköpostia kandidaatille, odottaa normaalisti, että henkilö hyväksyy sen linkissä (vaiheen sähköpostiasetus luetaan kerran, juuri ennen siirtoa, joten sillä hetkellä päälle kytketty asetus voi silti antaa siirron lähettää sähköpostia ilman hyväksyntää). Muut siirrot: assistenttia kehotetaan esikatsomaan ja odottamaan kyllä-vastaustasi, ja se voidaan yleensä kumota 24 tunnin ajan, kun se palasi peruutusviitteellä. Enintään 50 hakemusta pyyntöä kohden. |
| Hylkää hakemus | Pyytää hyväksyntää linkissä. Jos henkilö hyväksyy, Flowmingo yrittää siirtää hakemuksen projektin Hylätty-vaiheeseen; tarkista tulos sen jälkeen. Enintään 50 hakemusta pyyntöä kohden. |
Poista kandidaatteja projektista (remove_application) |
Vaatii Manage pipeline-oikeuden. Pyytää hyväksyntää linkissä. Jos henkilö hyväksyy, Flowmingo poistaa hakemukset projektista; kandidaatin profiili säilyy osaajapoolissasi ja muissa projekteissa. Se ei ole hylkäys, eikä sitä voi kumota. Enintään 50 hakemusta pyyntöä kohden. |
| Lisää muistiinpano tulokseen | Assistenttia kehotetaan esikatsomaan ehdotettu muistiinpano ja odottamaan kyllä-vastaustasi ennen tallentamista. Muistiinpano kuuluu yhteen arviointitulokseen (minkä tyyppiseen tahansa), ei kandidaattiin kokonaisuutena. |
| Arvioi tulos | Assistenttia kehotetaan esikatsomaan arviointi ja odottamaan kyllä-vastaustasi. Arviointi koskee yhtä arviointitulosta. |
| Lisää shortlistaan | Assistenttia kehotetaan esikatsomaan shortlistamuutos ja odottamaan kyllä-vastaustasi. Se koskee yhtä arviointitulosta. |
| Tagi / lisää osaajakokoelmaan | Assistenttia kehotetaan esikatsomaan tagi- tai osaajakokoelma-muutos ja odottamaan kyllä-vastaustasi. |
| Tarkista, peruuta tai kumoa muutos | Tarkista, missä vaiheessa vaiheistettu muutos on (odottaa, suoritettu, epäonnistunut, vanhentunut tai korvattu uudemmalla pyynnöllä), peruuta sellainen, joka vielä odottaa hyväksyntää, tai kumoa palautuva muutos 24 tunnin kuluessa, kun se palasi peruutusviitteellä. |
Luo ja julkaise (toimii välittömästi, paitsi projektin poistaminen)
Nämä työkalut luovat asioita ja avaavat ne julkisesti. Ne käyttäytyvät eri tavalla kuin yllä olevat suojatut kirjoitukset:
- Ne toimivat välittömästi, paitsi
delete_project. Mitään ei vaiheisteta henkilön hyväksyttäväksi linkissä, eikä yksikään niistä lähetä sähköpostia kandidaatille.delete_projectodottaa, että omistaja tai ylläpitäjä hyväksyy sen linkissä. - Avaimen luojan on oltava omistaja tai ylläpitäjä, jokaiselle työkalulle täällä paitsi peruutukselle, joka vaatii vain Invite candidates-oikeuden. Työkalut toimivat API-avaimen luoneen henkilön oikeuksilla. Jos henkilö on jäsen, kutsu hylätään.
- Kaksi käyttöoikeutta ovat valinnaisia. Create hiring projects ja Create assessments eivät ole oletuksena käytössä. Kirjautumisen yhteydessä (vaihtoehto A) avustaja saa ne vain, jos molemmat ehdot täyttyvät: asiakas luettelee ne nimeltä yhdistäessään, ja API-avain, jonka liität suostumussivulle, sisältää ne. Asiakas, joka ei lähetä käyttöoikeusluetteloa, saa neljä vakio-oikeutta (Read hiring data, Read candidates, Manage pipeline, Invite candidates), jotka avain sisältää, eikä kumpaakaan näistä kahdesta, joten avustaja ei näe työkaluja, jotka vaativat niitä. Staattisen avaimen kanssa (vaihtoehto B) avustajalle näytetään nämä työkalut riippumatta siitä, mitä oikeuksia avain sisältää, ja Flowmingo kieltäytyy kaikista kutsuista, joita avain ei salli.
- Jotkut kutsut kestävät hetken. Julkaiseminen odottaa AI-sisällöntarkistusta, enintään noin 90 sekuntia. Projektin tai arvioinnin luominen käyttää AI-generointia ja voi kestää kauemmin (tekninen testi kestää 3–9 minuuttia). Kun vastaus sanoo, että työ on vielä kesken, assistentti kutsuu uudelleen samalla idempotenssiavaimeella lukeakseen, mihin se on päässyt. Uusintayritys ei koskaan luo toista projektia tai arviointia.
| Ominaisuus | Mitä se tekee |
|---|---|
Luo rekrytointiprojekti (create_project) |
Vaatii Create hiring projects-oikeuden (valinnainen). Luo projektin neljällä oletusvaiheella ja työpaikkailmoituksen, jonka kirjoittaa sama AI kuin kojelaudassa, otsikosta, asemasta ja valinnaisesta kuvauksesta. Oletuksena se luo myös CV-arvioinnin ja AI-haastattelun; assistentti voi nimetä muita arviointeja tai ei yhtään. Työpaikkailmoitus kytketään päälle ja se tulee julkiseksi, kun AI-sisällöntarkistus hyväksyy sen, normaalisti minuutin kuluessa. Rajoitettu 10 projektiin minuutissa ja 300 päivässä yrityksellesi. Idempotenssiaväin on valinnainen: kun se jätetään pois, sellainen luodaan argumenteista, joten uusintayritys ei koskaan luo toista projektia. |
Luo arviointi (create_assessment) |
Vaatii Create assessments-oikeuden (valinnainen). Luo yhden arvioinnin AI:llä: AI-haastattelun, CV-arvioinnin, taitotestin, esittelyn, teknisen testin tai roolipelin, työnimikkeestä ja valinnaisesta työnkuvauksesta, nimestä, projektista ja kielestä (tunniste, kuten en tai vi-VN; taitotesti ja tekninen testi ohittavat kielen). Liitä se projektiin, jotta kandidaatteja voidaan kutsua taitotestiin, tekniseen testiin tai esittelyyn. Idempotenssiaväin on valinnainen, kuten edellä. |
Julkaise työpaikkailmoitus (publish_job_post) |
Vaatii Create hiring projects-oikeuden. Kytkee työpaikkailmoituksen päälle ja varmistaa, että AI-sisällöntarkistus on suoritettu. Vastaus kertoo, onko sivu live nyt, vielä odottaa tarkistusta vai hylätty sen toimesta. Rekrytointiprojektin on oltava aktiivinen. |
Poista työpaikkailmoitus julkaisusta (unpublish_job_post) |
Vaatii Create hiring projects-oikeuden. Kytkee työpaikkailmoituksen pois päältä, joten sen julkinen linkki lakkaa avautumasta. Oletuksena myös nosto kytketään pois päältä (withdraw_boost on tosi). |
Nosta työpaikkailmoitus (boost_job_post) |
Vaatii Create hiring projects-oikeuden. Asettaa noston arvoon off, flowmingo tai extended. Nostaminen on ilmaista. Nostamisen korottaminen vaatii työpaikkailmoituksen olevan päällä, sen projektin aktiivisen, yrityksen logon ja kuvauksen sekä AI-sisällöntarkistuksen; yritys voi tehdä 50 nostoa päivässä. |
Avaa, luonnos tai arkistoi projekti (set_project_state) |
Vaatii Create hiring projects. Siirtää rekrytointiprojektia tilojen active, draft ja archived välillä. Luonnos ja arkisto sulkevat työlinkin. Hakijoiden tiedot säilytetään. |
Peruuta ajoitettu kutsu (cancel_scheduled_invite) |
Vaatii Invite candidates-oikeuden. Peruuttaa kutsun, joka oli ajoitettu myöhemmäksi ja jota ei ole vielä lähetetty, käyttämällä kutsu tuloksen kutsutunnusta. Kenellekään ei lähetetä sähköpostia. Henkilö pysyy tililläsi ja projektin taululla. |
Poista rekrytointiprojekti (delete_project) |
Vaatii Create hiring projects-oikeuden (valinnainen). Se vain kysyy: se ei poista välittömästi, vaan pyytää hyväksyntää linkissä, eikä mitään poisteta, ennen kuin omistaja tai ylläpitäjä hyväksyy. Vain aktiivinen projekti voidaan poistaa. Jos henkilö hyväksyy, Flowmingo poistaa projektin ja sen työpaikkailmoitukset; sen kandidaattihakemuksia ei poisteta yksitellen, ja kandidaattiprofiilit ja -yhteystiedot, arviointisi ja kutsulinkkisi säilytetään. Peruutusta ei ole. |
Turvallisuus ja luottamus
- Tietosi ovat organisaatiorajattuja — assistentti ei voi koskaan nähdä toisen yrityksen tietoja.
- OAuthin kanssa assistentti ei koskaan vastaanota API-avaimesi. Se saa käyttöoikeustunnuksen, joka vanhenee tunnin kuluttua ja päivittyy hiljaa, kun se pysyy yhteydessä. Itse kirjautuminen kestää yhtä kauan kuin sen päivitystunnus, oletuksena noin 30 päivää siitä, kun se on myönnetty tai viimeksi päivitetty, joten se vanhenee noin 30 päivän käyttämättömyyden jälkeen, ja kirjaudut sitten uudelleen. Staattisen otsakkeen (vaihtoehto B) kanssa assistentin asiakas pitää avaintasi ja lähettää sen jokaisen pyynnön yhteydessä, joten pidä se poissa tiedostoista, joita saatat jakaa tai sitouttaa.
- Assistentin katkaiseminen: poista API-avain, jolla valtuutit sen, kohdasta Asetukset → Integraatiot → API-avaimet. Pääsy loppuu välittömästi. Per-assistentti-yhteyden katkaisua ei ole vielä, joten jos haluat peruuttaa ne yksitellen, anna jokaiselle assistentille oma avain.
/mcp-päätepisteen pyynnöt tarkistetaan niiden alkuperän suhteen: läpinäkymätönnull-alkuperä hylätään aina, ja tarkistus voidaan lukita sallittujen listaan, mutta oletuksena jokainen todellinen alkuperä hyväksytään, joten suojaus on tunnistetietosi, ei alkuperä. Jokainen istunto on sidottu tunnistetietoon, joka sen avasi.
Todennusohjeet ovat kohdassa Todennus — kaksi vaihtoehtoa; tarkat lukemiset, suojatut kirjoitukset ja välittömästi tapahtuvat toiminnot ovat kohdassa Mitä voit tehdä. Kun olet valmis, siirry kohtaan Yhdistä assistenttisi ja valitse asiakkaasi.
MCP-palvelimen URL
Yhdistä avustajasi
Claude Code (CLI)
Yhdellä komennolla Flowmingo lisätään natiivin Streamable HTTP:n päälle. Käytä ensisijaisesti OAuthia; staattinen --header on vaihtoehtoinen tapa.
Vaiheet: 1) lisää palvelin, 2) kirjaudu sisään (selain → liitä avain), 3) tarkista claude mcp list -komennolla.
# 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
Huomio: Lippujen on oltava ennen nimeä, ja käytä aina --transport http (ei koskaan sse). Korvaa fl_YOUR_KEY koko avaimellasi (katso Miltä täydellinen avain näyttää -osio Authentication-osiosta yllä).
Tarkista, että se toimii — kysy: "listaa avoimet työpaikkani."
Cursor
Staattinen otsikko on yksinkertaisin tapa. Cursor voi myös käyttää OAuthia (se tukee Dynamic Client Registration -toimintoa) — tällöin poista headers-lohko.
Vaiheet: 1) lisää palvelin kohtaan ~/.cursor/mcp.json (alla), 2) aseta FLOWMINGO_API_KEY-ympäristömuuttuja koko avaimellasi shell-profiiliisi, 3) sulje Cursor ja käynnistä se terminaalista, jossa muuttuja on asetettu, 4) kohdassa Settings → MCP ota palvelin pois päältä ja takaisin päälle ladataksesi sen.
Cursor täytyy nähdä muuttuja. Cursor lukee ${env:FLOWMINGO_API_KEY} omasta ympäristöstään. Kun se käynnistetään dockista tai Start-valikosta, se ei usein näe terminaaliprofiilissa asetettua muuttujaa, ja silloin otsikko saapuu tyhjänä tai laajentamattomana, ja palvelin vastaa Missing credential. Jos Cursor käynnistäminen terminaalista ei ole käytännöllistä, korvaa ${env:FLOWMINGO_API_KEY} tiedostossa koko avaimellasi (ja pidä ~/.cursor/mcp.json poissa gitistä).
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
}
}
}
OAuth sen sijaan — poista headers-lohko; Cursor suorittaa Dynamic Client Registration -toiminnon ja avaa selaimen suostumussivun ensimmäisellä yhteydellä:
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp"
}
}
}
Varmista, että se toimii — kysy: "listaa avoimet työpaikkani."
VS Code (Copilot, agenttitila)
Työkalut ilmestyvät vain Copilot Chat → Agenttitila -kohdassa. Juuriavain on servers (ei mcpServers) ja tyyppi on http. Alla oleva kehotettu avainpolku on luotettava asennus.
Vaiheet: 1) luo .vscode/mcp.json (tai suorita MCP: Lisää palvelin → HTTP), 2) kun käynnistät palvelimen, VS Code pyytää avaintasi (sitä ei kirjoiteta tiedostoon), 3) käytä sitä Agenttitilassa.
{
"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 voi myös yrittää OAuthia, mutta dokumentoitu OAuth-konfiguraatio odottaa asiakas-ID:tä; käytä yllä olevaa kehotetun avaimen polkua luotettavaan asennukseen.
Varmista, että se toimii — kysy: "list my open jobs."
Claude — claude.ai & Claude Desktop
Molemmat käyttävät samaa Liittimet-käyttöliittymää ja samaa liitä-URL-virtaa. Vain OAuth (käyttöliittymässä ei ole otsikkokenttää).
Vaiheet (verkko tai työpöytä):
- Avaa Asetukset → Liittimet ja napsauta Lisää mukautettu liitin.
- Nimeä se
Flowmingoja liitä yllä oleva MCP-palvelimen URL. Jätä Lisäasetukset → OAuth-asiakas-ID / Salasana tyhjäksi. - Napsauta Lisää → Yhdistä. Flowmingon suostumussivulla liitä
fl_-API-avaimesi ja valtuuta. - Varmista — kysy Claudelta: "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)
Tiimi / Yritys: Omistaja lisää sen kerran kohdassa Organisaation asetukset → Liittimet → Mukautetut; jäsenet napsauttavat sitten Yhdistä.
Tarvitsetko staattisen avaimen Claude Desktopissa sen sijaan? Käytä välilehteä Mikä tahansa asiakas (mcp-remote).
Selaimesi avaa Flowmingon suostumussivun ensimmäisellä yhteydellä — liitä API-avaimesi ja valtuuta. Katkaistaksesi yhteyden myöhemmin, poista API-avain kohdasta Asetukset → Integroinnit → API-avaimet.
ChatGPT & OpenAI Codex CLI
Molemmat ovat OpenAI:ta. ChatGPT käyttää Developer Modea mukautetuille liittimille (vain OAuth); Codex yhdistää natiivisti CLI:stä.
ChatGPT (web)
- Siirry chatgpt.com-sivustolla (Plus / Pro / Business / Enterprise / Edu — ei mobiilissa), avaa Settings → Apps → Advanced ja ota Developer mode käyttöön.
- Valitse Apps → Create → nimeä
Flowmingo, liitä alla oleva URL, siirtotapa Streamable HTTP, todennus OAuth. - Avaa luonnos, ota työkalut käyttöön ja päivitä (Refresh).
- Liitä se +-valikosta keskustelussa.
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)
ChatGPT:n Developer Mode yhdistää vain OAuthilla — se ei hyväksy staattista x-api-key- tai mukautettua API-avainotsikkoa. Tavalliset ja deep-research-liittimet käyttävät vain search- ja fetch-toimintoja (sinulla on molemmat). Kirjoitustyökalut (kutsu / siirrä / hylkää) vaativat Developer Moden. Kehote, jonka ChatGPT näyttää ennen työkalun suorittamista, on ChatGPT:n oma eikä Flowmingon hyväksyntä: kutsu, hylkäys ja siirto vaiheeseen, joka lähettää sähköpostia ehdokkaalle, odottavat aina henkilön hyväksyntää Flowmingo-linkissä.
OpenAI Codex CLI
Siltaa ei tarvita — Codex puhuu Streamable HTTP:tä natiivisti.
# ~/.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
Varmista, että se toimii — kysy: "listaa avoimet työpaikkani."
Gemini CLI & Code Assist
Gemini CLI (ja Gemini Code Assist -agenttitila) tavoittavat etä-MCP-palvelimen ~/.gemini/settings.json-tiedoston kautta. Kuluttaja Gemini -sovellus ei voi lisätä mukautettuja MCP-liittimiä — tämä reitti on vain CLI / Code Assist.
Vaiheet: 1) lisää palvelin mcpServers-lohkoon tiedostossa ~/.gemini/settings.json, 2) vie FLOWMINGO_API_KEY=fl_..., 3) suorita gemini ja /mcp vahvistaaksesi, että työkalut on listattu.
{
"mcpServers": {
"flowmingo": {
"httpUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${FLOWMINGO_API_KEY}" },
"timeout": 30000
}
}
}
httpUrl valitsee natiivin Streamable HTTP:n. ${FLOWMINGO_API_KEY}-paikkamerkki laajennetaan ympäristöstäsi, joten tiedostoon ei kirjoiteta raakaa avainta. OAuth mieluummin? Gemini CLI voi tehdä sen natiivisti — jätä headers-lohko pois ja lisää "authProviderType": "dynamic_discovery" palvelinmerkintään. CLI havaitsee 401-haasteen, löytää MCP-metadatamme ja suorittaa dynaamisen asiakasrekisteröinnin itsenäisesti (ei tarvitse asettaa asiakas-ID:tä).
Varmista, että se toimii — kysy
gemini-sovelluksessa: "list my open jobs."
Muut asiakkaat — Windsurf · Zed · Cline · Continue · Antigravity
Jokainen alla oleva asiakas toimii samaa palvelinta vasten — useimmat tukevat sekä OAuthia että staattista otsaketta. Katkelmissa käytetään staattista avainta ympäristömuuttujan kautta; poista headers-osio, jos haluat antaa asiakkaan käyttää OAuthia, jos se sitä tukee. Huomioi alla mainitut asiakaskohtaiset avainten nimeämiseen liittyvät sudenkuopat.
Google Antigravity
Lisää https://mcp.flowmingo.ai/mcp etäiseksi MCP-palvelimeksi ja valitse sen todentaminen: Flowmingo-sivu avautuu ja pyytää täydellistä API-avaintasi (katso Miltä täydellinen avain näyttää -kohta yllä olevasta Todentaminen-osiosta). Jokainen Antigravity-pinta (IDE, CLI) kirjautuu sisään erikseen. Antigravityn mcp_config.json-tiedostossa osoite sijoitetaan serverUrl-kenttään, ja staattinen avain sijoitetaan headers-lohkon Authorization-kenttään muodossa Bearer ja täydellinen avain, kuten Googlen omissa Antigravity MCP -esimerkeissä. Emme ole pystyneet testaamaan jokaista Antigravity-versiota, joten jos valikkosi eroavat tästä, Googlen oppaasta löydät ajantasaiset ohjeet.
Windsurf (Cascade)
~/.codeium/windsurf/mcp_config.json — Windsurf hyväksyy serverUrl- tai url-kentän, ja tukee OAuthia (jätä headers pois käynnistääksesi sen).
{ "mcpServers": { "flowmingo": {
"serverUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Zed
~/.config/zed/settings.json — avain on context_servers; jätä headers pois alkuperäistä OAuthia varten. Aseta FLOWMINGO_API_KEY=fl_... ympäristöösi sen sijaan, että liittäisit raa'an avaimen.
{ "context_servers": { "flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Cline
MCP-palvelimet → Määritä — aseta type: "streamableHttp" (camelCase-muodossa), muuten se oletuksena käyttää toimimatonta SSE:tä.
{ "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 — muodosta yhteys mcp-remote-sillan kautta. Aseta 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 }}"]
Varmista, että se toimii — kysy: "listaa avoimet työpaikkani."
Mikä tahansa asiakas (mcp-remote)
Kaikille stdio-only-asiakkaille (tai tuleville asiakkaille, joilla ei ole natiivia etäyhteystukea), yhdistä Flowmingoon mcp-remote stdio-komennolla. --transport http-only vaaditaan — palvelimella ei ole SSE:tä.
Vaiheet: 1) varmista, että Node ≥ 18, 2) suorita silta stdio-komentona asiakkaassasi, 3) ensimmäisellä OAuth-kerralla selain avautuu — liitä avaimesi.
# 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" }
}
}
}
Pelastus: jos todennus jää jumiin, suorita rm -rf ~/.mcp-auth ja yritä uudelleen. Korvaa fl_YOUR_KEY koko avaimellasi (katso Miltä täydellinen avain näyttää -kohta Authentication-osiosta yllä). JSON args[] -kentässä vältä välilyöntiä otsikon kaksoispisteen jälkeen (npx-escape-ominaisuus).
Varmista, että se toimii — kysy: "listaa avoimet työpaikkani."