Orokorra
Konektatu MCP-rekin bateragarria den edozein AI asistente zure Flowmingo kontratazio-datuetara — irakurri zure lanpostuak eta hautagaiak eta egin ekintza babestuak (gonbidatu, mugitu, baztertu, kendu proiektu batetik), segurtasunez, zure baimenarekin. Gehitu behar dituzun bi baimen gehigarrirekin, asistente batek kontratazio-proiektuak eta ebaluazioak ere sor ditzake, eta lanpostu bat argitaratu, itxi edo sustatu (ikus Zer egin dezakezu). MCP berria al zara? AI asistenteek Flowmingo bezalako tresnekin hitz egiteko aukera ematen duen estandar irekia da. Ikasi zer den MCP.
Garraioa: Streamable HTTP (urruneko garraio modernoa). Ez dago SSE zaharrarik — beti zure bezeroa /mcp-ra zuzendu, ez /sse-ra.
Tratatu zure API giltza pasahitz bat bezala. Hobetsi OAuth, abisu bidezko sarrera edo ingurune-aldagai bat,
fl_...giltza gordin bat git-era konprometitu dezakezun fitxategi batean itsatsi beharrean (adibidez,.vscode/mcp.json,~/.cursor/mcp.json, zure Continue konfigurazioa).
Autentifikazioa — bi aukera
A — Hasi saioa Flowmingo-rekin (OAuth, gomendatua). Zure arakatzaileak Flowmingo baimen-orri bat irekitzen du; zure API giltza itsatsi behar duzu bertan. Asistenteak ez du zure giltza gordina jasotzen. Sarbide-token bat eta freskatze-token bat jasotzen ditu, eta horiekin sarbide-token berri bat lor dezake. Saio-hasiera ez da betikoa. Freskatze-tokena 30 egun inguru bizi da lehenespenez, jaulki zenetik zenbatuta, saio-hasieran edo azken freskatzean, beraz, erabili gabe geratzen den saio-hasiera iraungi egiten da, eta Flowmingo-ren bertsio batek saio-hasierak nola gordetzen diren aldatzen badu, baliteke berriro saioa hasi behar izatea. Asistenteak saioa hasteko eskatuko dizu berriro, eta zuk giltza berriro itsatsiko duzu. Lehenago mozteko, ezabatu API giltza hori. Ez dago bezeroaren ID edo sekreturik sortu beharrik (Flowmingo-k Dynamic Client Registration erabiltzen du). OAuth ezarpen "aurreratuak" erakusten dituzten bezeroetan (adibidez, Claude.ai), utzi Client ID eta Secret hutsik.
B — API giltza estatikoa (goiburua). Bidali zure giltza goiburuetako bat bezala:
x-api-key: fl_YOUR_KEY
Authorization: Bearer fl_YOUR_KEY
Lortu zure giltza Flowmingo → Ezarpenak → Integrazioak → API giltzak. Markatu Read hiring data eta Read candidates — lehenengoak lanpostuak, hodia eta emaitzak hartzen ditu; bigarrenak asistente bati norbait bilatzeko aukera ematen dio. Gehitu Manage pipeline / Invite candidates idazketa-ekintza babestuetarako. Asistente batek proiektuak eta ebaluazioak sortzeko eta lanpostu bat argitaratu edo sustatzeko, markatu ere Create hiring projects eta Create assessments. Irakurri Sortu eta argitaratu atala, Zer egin dezakezu atalean: bi baimen hauek aukerazkoak dira, eta giltzaren sortzaileak Jabe edo Kudeatzaile izan behar du.
Giltza oso bat nolakoa den. Balio luze bat: fl_live_, giltzaren izen publikoa, puntu bat, eta sekretu luze bat. Sekretuaren erdia behin erakusten da, giltza sortu eta berehala; gero, API giltzen zerrendak hasiera baino ez du erakusten. Punturik gabeko balio bat giltzaren izena baino ez da, eta baztertu egingo da. Gida honek fl_YOUR_KEY idazten duen lekuan, ordezkatu guztia zure giltza osoarekin, komatxorik eta tarterik gabe.
Konektatzen ez bada. Giltza txar edo hutsik Missing credential edo The Flowmingo API key was rejected errore gisa itzultzen da; biak esan dezakete balioa ez zaigula osoa iritsi, beraz, egiaztatu balioa lehenik. ${env:FLOWMINGO_API_KEY} bezalako ezarpen batek funtzionatzen du programak aldagai hori ikusten badu, eta dock-etik edo Start menutik irekitako editore batek normalean ez du zure terminaleko profila irakurtzen. Hasi terminal batetik aldagaia ezarrita dagoen lekuan, edo jarri zure giltza osoa fitxategian (eta mantendu fitxategi hori git-etik kanpo).
Zein aukeratu? Bezero gehienek biak onartzen dituzte; gutxi batzuk (adibidez, ChatGPT) OAuth bakarrik dira — fitxa bakoitzak adierazten du bezeroak zer onartzen duen. Oro har, OAuth egokia da asistente interaktiboetarako (Claude.ai, ChatGPT, VS Code); API giltzaren goiburua egokia da CLI, burugabe/CI eta giltza txertatu nahiago duten editoreetarako.
Zer egin dezakezu
Irakurketek ez dute onarpenik behar. Idazketa gehienak babestuta daude. Gonbidapen bat, Reject ekintzarekin egindako bazterketa, hautagaiak proiektu batetik kentzea, proiektu bat ezabatzea, edo, normalean, hautagaiari emaila bidaltzeko ezarrita dagoen etapa batera mugitzea, pertsonak esteka batean onartzea itxaroten du, Flowmingo-n saioa hasita. Asistenteak ezin du onartu, eta txatean idatzitako bai bat ez da balio. Etapen email-ezarpena mugimendua eskatzen denean egiaztatzen da. Ohar, balorazio, shortlist, etiketa edo hautagaiari emaila bidaltzeko ezarrita ez dagoen etapa batera mugitzeko, asistenteari esaten zaio aurrebista bat erakusteko eta aurrera egiteko zuk ados jarri ondoren, hau argibide bat da, ez blokeo bat. Zure AI bezeroak tresna bat exekutatu aurretik erakusten duen abisua bezeroarena da eta ez da Flowmingo-ren onespena: gonbidapen bat, Reject ekintzarekin egindako bazketa eta emaila bidaltzen duen etapa batera mugitzea onespen-estekaren zain egongo dira beti, bezeroak eskatu duena edozein dela ere. Onespen-esteka 15 minutu igaro ondoren iraungitzen da, eta hautagai edo aplikazio batzuetarako eskaera batek (gehienez 50) denak zerrendatzen dituen onespen bat da. Aldaketa bat prestatu ondoren, asistentek egiaztatu dezake non dagoen, itxaroten ari den bitartean kendu, eta itzulgarria den aldaketa bat desegin (ohar, balorazio, shortlist marka, etiketa edo inori emailik bidali ez duen mugimendua) 24 orduko epean. Desegitea ez dago beti eskuragarri: aldaketak desegite-erreferentzia batekin itzuli behar du, bat grabatzea ahaleginik onena da, eta aurreko etaparik ez duen hautagai baten mugimenduak ez du desegite-erreferentziarik, beraz, asistentak egiaztatu eta esan behar du ez dagoela itzulerarik. Bidali den email bat ezin da desegin. Sortu eta argitaratu atalean zerrendatutako tresnak salbuespena dira honetaz guztiaz, delete_project izan ezik: berehala jarduten dute eta ez daude onespenetarako prestatuak. Kendu eta proiektua ezabatzea ezin dira desegin. Dena zure erakundeari lotuta dago.
Irakurri
| Gaitasuna | Zer egiten du |
|---|---|
| Lanpostuak zerrendatu | Arakatu zure erakundeko irekitako eta itxitako rolak. |
| Elkarrizketa-sortak eta proiektuak zerrendatu | Ikusi zure ebaluazioak (elkarrizketa-sortak) mota guztietakoak (AI elkarrizketak, rol-jokoak, Gaitasun Probak, Proba Teknikoak, CV ebaluazioak, Showcase-ak eta grabazioak; galdetegiak eskatzen dituzunean) eta zure kontratazio-proiektuak. |
| Zure hautagaien hodia zerrendatu | Ikusi aplikazioak etapaka proiektu zehatz batean. |
| Ebaluazio-emaitzak eta puntuazioak irakurri | Atera mota guztietako emaitzak: AI elkarrizketak, rol-jokoak, Gaitasun Probak, Proba Teknikoak, CV ebaluazioak, Showcase-ak, grabazioak eta galdetegiak. Emaitza bakoitza bere motarekin etiketatuta dago. Batzuek soilik dute AI puntuazioa: Showcase bat eta galdetegi bat ez dira inoiz puntuatzen, eta Gaitasun Proba portzentaje bat da. |
| Hautagai bat bilatu | Eskuratu hautagai baten izena, emaila eta CVa. |
| Hautagaiak bilatu | Bilatu hautagaiak izen edo emailaren arabera. |
| Hautagaiak konparatu | Jarri 2 eta 10 hautagai elkarren ondoan. Read candidates baimena behar du eta Read hiring data. |
| Kontratazioaren ikuspegi orokorra | Zure konexioak irits dezakeen guztiaren inbutua (enpresa osoa, giltza proiektu batzuetara mugatuta dagoen norbaitek sortu ez badu), edo estutua eskatzen duzunean: aplikazioak etapaka, aktiboak vs baztertuak, eta, emaitzak dituen ebaluazio mota bakoitzeko, osatutakoak vs amaitu gabekoak eta batez besteko puntuazioa. Proiektu batek zenbaketa guztiak estutzen ditu, baina bere emaitza-zenbaketek proiektu horri lotutako ebaluazioetako emaitzak hartzen dituzte, beraz, ebaluazio horietako bat partekatzen duen beste proiektu bateko hautagai bat ere zenbatu daiteke. Ebaluazio batek emaitza-zenbaketak baino ez ditu estutzen: etapa eta aplikazio zenbaketak zure konexioak irits dezakeen guztian geratzen dira. Motak ez dira inoiz gehitzen elkarrekin. |
| Hautagai onenak | Puntuazio orokorraren arabera ordenatutako emaitzarik altuenak. Ebaluazio mota guztiak elkarrekin sailkatzen dira mota bat edo ebaluazio bat (elkarrizketa-sorta) eskatzen ez baduzu. |
| Ebaluazio-emaitzaren xehetasuna | Emaitza baten gaitasun bakoitzeko puntuazioak eta AI laburpena, horiek dituzten motetarako. Gaitasun Proba batek, Proba Tekniko batek, Showcase batek eta galdetegi batek gutxi edo bat ere ez dute. |
| Lanpostuaren xehetasuna | Lanpostu bakar baten xehetasun osoa. |
Lanpostu bat publikorako irekita al dago? (get_job_post_publication) |
Norbait lanpostu baten orri publikoa ireki dezakeen: zuzena, AI eduki-egiaztapenaren zain, berak baztertua, markatua, itzalita, edo bere proiektua ez dago irekita. Bere helbide publikoa eta bere sustapena (off, flowmingo edo hedatua) ere bai. Read hiring data behar du. |
| Hurrengo elkarrizketak | Edonolako ebaluaziotara gonbidapenak bidali edo programatu eta oraindik osatu gabe daudenak. Ez da denek amaitu gabe dutenaren zenbaketa: hautagaiari gogorarazi zaion gonbidapen bat, edo esteka ireki edo klikatu duena, kanpoan uzten da hautagaia hasi arte, eta baita bidaltzean huts egin duena ere. |
Idatzi (babestuta)
| Gaitasuna | Zer egiten du |
|---|---|
| Invite candidates ebaluazio batera | AI elkarrizketa, rol-joko, Gaitasun Proba edo Proba Tekniko baterako gonbidapenak prestatzen ditu, eta pertsonak esteka batean onartzea itxaroten du. Ez da ezer bidaltzen hori baino lehen. Ebaluazio bat eta gehienez 50 hautagai eskaera bakoitzeko; Gaitasun Proba edo Proba Tekniko batek proiektu bat eta email bat behar du hautagai bakoitzeko, eta babestutako batek zure erakundearen zorroa zordunkatu dezake hautagai batek hasten duenean. |
| Hautagai bat beste etapa batera mugitu | Hautagaiari emaila bidaltzeko ezarrita dagoen etapa batera mugitzeak normalean pertsonak esteka batean onartzea itxaroten du (etapen email-ezarpena behin irakurtzen da, mugimenduaren aurretik, beraz, une horretan piztutako ezarpen batek baimenik gabe emaila bidaltzen duen mugimendua ahalbidetu dezake). Edozein beste mugimendu: asistenteari esaten zaio aurrebista egiteko eta zure baiaren zain egoteko, eta normalean 24 orduz desegin daiteke, desegite-erreferentziarekin itzuli denean. Gehienez 50 aplikazio eskaera bakoitzeko. |
| Aplikazio bat baztertu | Esteka batean onespena eskatzen du. Pertsona batek onartzen badu, Flowmingo aplikazioa proiektuaren Baztertuta etapara mugitzen saiatzen da; egiaztatu emaitza ondoren. Gehienez 50 aplikazio eskaera bakoitzeko. |
Kendu hautagaiak proiektu batetik (remove_application) |
Manage pipeline behar du. Esteka batean onespena eskatzen du. Pertsona batek onartzen badu, Flowmingo aplikazioak ezabatzen ditu proiektutik; hautagaiaren profila zure talentu putzuan eta beste proiektuetan geratzen da. Ez da bazterketa bat, eta ez dago desegiterik. Gehienez 50 aplikazio eskaera bakoitzeko. |
| Gehitu ohar bat emaitza bati | Asistenteari esaten zaio proposatutako oharra aurrebista dezala eta zure baiaren zain egon dadila gorde aurretik. Ohar bat ebaluazio-emaitza bati dagokio (edozein motatakoa), ez hautagaiari osotasunean. |
| Baloratu emaitza bat | Asistenteari esaten zaio balorazioa aurrebista dezala eta zure baiaren zain egon dadila. Balorazioa ebaluazio-emaitza bati aplikatzen zaio. |
| Shortlist-ean jarri emaitza bat | Asistenteari esaten zaio shortlist aldaketa aurrebista dezala eta zure baiaren zain egon dadila. Ebaluazio-emaitza bati aplikatzen zaio. |
| Etiketa / gehitu talentu-bildumara | Asistenteari esaten zaio etiketa edo talentu-bilduma aldaketa aurrebista dezala eta zure baiaren zain egon dadila. |
| Egiaztatu, kendu edo desegin aldaketa bat | Egiaztatu non dagoen prestaturiko aldaketa (zain, eginda, huts eginda, iraungita edo eskaera berriago batek ordezkatua), kendu onespenaren zain dagoen bat, edo desegin itzulgarria den aldaketa bat 24 orduko epean, desegite-erreferentziarekin itzuli denean. |
Sortu eta argitaratu (berehala jarduten du, proiektua ezabatzea izan ezik)
Tresna hauek gauzak sortu eta publikora irekitzen dituzte. Goiko idazketa babestuetatik desberdin jokatzen dute:
- Berehala jarduten dute,
delete_projectizan ezik. Ez dago ezer prestaturik pertsonak esteka batean onartzeko, eta ez dute hautagai bati emailik bidaltzen.delete_project-k Jabe edo Kudeatzaile batek esteka batean onartzea itxaroten du. - Giltzaren sortzaileak Jabe edo Kudeatzaile izan behar du, hemen dagoen tresna guztietarako, bertan behera uztea izan ezik, horrek Invite candidates baino ez baitu behar. Tresnek API giltza sortu duen pertsonaren baimenekin jarduten dute. Pertsona hori Kidea bada, deia baztertu egiten da.
- Bi baimenek berariazko baimena behar dute. Create hiring projects eta Create assessments ez dira lehenespenez ematen. Saioa hastearekin (A aukera), laguntzaileak bi baldintzak betetzen badira soilik lortzen ditu: bezeroak izenez zerrendatzen ditu konektatzean, eta baimen-orrian itsasten duzun API gakoak baditu. Baimenen zerrendarik bidaltzen ez duen bezeroak gakoak dituen lau baimen estandarrak (Read hiring data, Read candidates, Manage pipeline, Invite candidates) jasotzen ditu, baina ez bi hauek; beraz, laguntzaileak ez ditu baimen horiek behar dituzten tresnak ikusten. Gako estatiko batekin (B aukera), laguntzaileari tresna hauek erakusten zaizkio, gakoak dituen baimenak edozein direla ere, eta Flowmingok ez du onartzen gakoak baimendu ez duen deirik.
- Dei batzuek denbora hartzen dute. Argitaratzeak AI eduki-egiaztapenaren zain egoten da, 90 segundo inguru. Proiektu edo ebaluazio bat sortzeak AI sorkuntza erabiltzen du eta gehiago iraun dezake (Proba Tekniko batek 3 eta 9 minutu arte). Erantzunak lana oraindik zain dagoela esaten duenean, asistentek berriro deitzen du idempotentzia-giltza berarekin irakurtzeko nora iritsi den. Erretry batek ez du inoiz bigarren proiektu edo ebaluaziorik sortzen.
| Gaitasuna | Zer egiten du |
|---|---|
Kontratazio-proiektu bat sortu (create_project) |
Create hiring projects behar du (aukerazkoa). Proiektu bat sortzen du bere lau etapa lehenetsiekin eta panelak duen AI berak idatzitako lanpostu batekin, izenburu batetik, posiziotik eta aukerazko deskribapen batetik. Lehenespenez, CV Ebaluazio bat eta AI Elkarrizketa bat ere egiten ditu; asistentek beste ebaluazio batzuk izenda ditzake, edo bat ere ez. Lanpostua pizten da eta publikoa bihurtzen da AI eduki-egiaztapenak onartzen duenean, normalean minutu batean. 10 proiektu minutuko eta 300 eguneko zure enpresentzat. Idempotentzia-giltza aukerazkoa da: kanpoan uzten denean, argumentuetatik sortzen da bat, beraz, erretry batek ez du inoiz bigarren proiekturik sortzen. |
Ebaluazio bat sortu (create_assessment) |
Create assessments behar du (aukerazkoa). Ebaluazio bat sortzen du AIrekin: AI Elkarrizketa, CV Ebaluazioa, Gaitasun Proba, Showcase, Proba Teknikoa edo Rol-jokoa, lan-izenburu batetik eta aukerazko lan-deskribapen, izen, proiektu eta hizkuntza batetik (etiketaren bat, esate baterako en edo vi-VN; Gaitasun Proba eta Proba Teknikoak hizkuntza ezikusi egiten dute). Atxiki proiektu batera, hautagaiak Gaitasun Proba, Proba Tekniko edo Showcase batera gonbidatu ahal izateko. Idempotentzia-giltza aukerazkoa da, goian bezala. |
Lanpostu bat argitaratu (publish_job_post) |
Create hiring projects behar du. Lanpostua pizten du eta AI eduki-egiaztapena exekutatu dela ziurtatzen du. Erantzunak esaten du orria orain zuzena den, egiaztapenaren zain dagoen, edo berak baztertua. Kontratazio-proiektua aktiboa izan behar du. |
Lanpostu bat argitaratu gabe utzi (unpublish_job_post) |
Create hiring projects behar du. Lanpostua itzaltzen du, bere esteka publikoa irekitzen ez dadin. Lehenespenez, sustapena ere itzaltzen da (withdraw_boost egia da). |
Lanpostu bat sustatu (boost_job_post) |
Create hiring projects behar du. Sustapena off, flowmingo edo extended-ra ezartzen du. Sustatzea doakoa da. Handitzeak lanpostua piztuta, haren proiektua aktiboa, enpresa-logoa eta deskribapena, eta AI eduki-egiaztapena behar ditu; enpresa batek 50 sustapen igo ditzake eguneko. |
Proiektu bat ireki, zirriborratu edo artxibatu (set_project_state) |
Create hiring projects behar du. Kontratazio-proiektu bat active, draft eta archived artean mugitzen du. Proiektua zirriborro edo artxibatuta dagoenean, bere lan esteka itxita dago. Hautagaien datuak gordetzen dira. |
Programatutako gonbidapen bat bertan behera utzi (cancel_scheduled_invite) |
Invite candidates behar du. Geroagorako programatu eta oraindik bidali ez den gonbidapen bat bertan behera uzten du, gonbidapen-emaitzako gonbidapen-idazkia erabiliz. Inori ez zaio emailik bidaltzen. Pertsona zure kontuan eta proiektuaren taulan geratzen da. |
Kontratazio-proiektu bat ezabatu (delete_project) |
Create hiring projects behar du (aukerazkoa). Soilik eskatzen du: ez du berehala ezabatzen, esteka batean onespena eskatzen du, eta ez da ezer ezabatzen Jabe edo Kudeatzaile batek onartu arte. Proiektu aktibo bat baino ezin da ezabatu. Pertsona batek onartzen badu, Flowmingo-k proiektua eta bere lanpostuak ezabatzen ditu; bere hautagaien aplikazioak ez dira banan-banan ezabatzen, eta hautagaien profilak eta kontaktuak, zure ebaluazioak eta gonbidapen-estekak gordetzen dira. Ez dago desegiterik. |
Segurtasuna eta konfiantza
- Zure datuak erakunde-esparrukoak dira — asistentek ezin du inoiz beste enpresa baten daturik ikusi.
- OAuth-ekin, asistentek ez du inoiz zure API giltza jasotzen. Ordu bat iraungitzen duen sarbide-token bat jasotzen du, isilean freskatzen dena konektatuta jarraitzen duen bitartean. Saio-hasiera bera bere freskatze-tokenak irauten duen bitartean irauten du, 30 egun inguru lehenespenez jaulki edo azken freskatze zenetik, beraz, erabili gabe 30 egun inguru igaro ondoren iraungitzen da, eta orduan berriro hasi behar duzu saioa. Goiburu estatikoarekin (B aukera), zure asistenteko bezeroak zure giltza gordetzen du eta eskaera bakoitzarekin bidaltzen du, beraz, parteka edo konprometi ditzakezun fitxategietatik kanpo mantendu.
- Asistente bat moztea: ezabatu berarekin baimendu duzun API giltza, Ezarpenak → Integrazioak → API giltzak atalean. Sarbidea berehala gelditzen da. Oraindik ez dago asistenteko deskonexiorik, beraz, banan-banan kendu nahi badituzu, eman asistenteko bakoitzari bere giltza.
/mcpendpointeko eskaerak jatorriaren arabera egiaztatzen dira:nulljatorri opakoa beti ukatzen da, eta egiaztapena onartutako zerrendara blokeatu daiteke, baina lehenespenez jatorri erreal guztiak onartzen dira, beraz, babesa zure kredentziala da, ez jatorria. Sesio bakoitza ireki zuen kredentzialari lotuta dago.
Nola autentifikatu, ikus Autentifikazioa — bi aukera; irakurketa zehatzak, idazketa babestuak eta berehala gertatzen diren ekintzak, ikus Zer egin dezakezu. Prest zaudenean, joan Konektatu zure asistentea atalera eta aukeratu zure bezeroa.
MCP zerbitzariaren URLa
Konektatu zure laguntzailea
Claude Code (CLI)
Komando bakar batek Flowmingo gehitzen du Streamable HTTP natiboaren gainean. OAuth da lehenengo aukera; --header estatikoak alternatiba gisa balio du.
Urratsak: 1) zerbitzaria gehitu, 2) saioa hasi (nabigatzailea → gakoa itsatsi), 3) claude mcp list egiaztatzeko.
# 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
Kontuz: banderak izenaren aurretik jarri behar dira, eta beti erabili --transport http (inoiz ez sse). Ordeztu fl_YOUR_KEY zure gako osoarekin (ikus Zer itxura du gako oso batek goiko Autentifikazio atalean).
Egiaztatu funtzionatzen duela — galdetu: "zerrendatu nire lan irekiak."
Cursor
Goiburuko estatiko sinpleena bide errazena da. Cursor OAuth ere erabil dezake (Dynamic Client Registration onartzen du) — horretarako, kendu headers blokea.
Urratsak: 1) gehitu zerbitzaria ~/.cursor/mcp.json fitxategian (behean), 2) ezarri FLOWMINGO_API_KEY zure gako osoarekin zure shell profilean, 3) itxi Cursor eta abiarazi terminal batetik aldagaia ezarrita dagoenean, 4) Ezarpenak → MCP atalean, aldatu zerbitzaria itzali eta piztu berriz kargatzeko.
Cursor aldagaia ikusi ahal izan behar du. Cursor ${env:FLOWMINGO_API_KEY} irakurtzen du bere ingurunetik. Docketik edo Hasi menutik abiarazita, normalean ez du ikusten terminal profilean ezarritako aldagaia, eta orduan goiburua hutsik edo hedatu gabe iristen da eta zerbitzariak Missing credential erantzuten du. Cursor terminal batetik abiaraztea praktikoa ez bada, ordezkatu ${env:FLOWMINGO_API_KEY} fitxategian zure gako osoarekin (eta mantendu ~/.cursor/mcp.json git-etik kanpo).
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
}
}
}
OAuth alternatiba — kendu headers blokea; Cursor Dynamic Client Registration exekutatzen du eta nabigatzaileko baimen-orri bat irekitzen du lehen konexioan:
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp"
}
}
}
Egiaztatu funtzionatzen duela — galdetu: "zerrendatu nire lan irekiak."
VS Code (Copilot, agent modua)
Tresnak Copilot Chat → Agent moduan soilik agertzen dira. Gako nagusia servers da (ez mcpServers) eta mota http da. Behean dagoen gako-gonbidapen bidea da konfigurazio fidagarria.
Urratsak: 1) sortu .vscode/mcp.json (edo exekutatu MCP: Gehitu Zerbitzaria → HTTP), 2) zerbitzaria hasten duzunean, VS Code-k zure gakoa eskatuko dizu (ez da fitxategian idazten), 3) erabili Agent moduan.
{
"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-k OAuth ere saia dezake, baina dokumentatutako OAuth konfigurazioak bezero-ID bat behar du; erabili goiko gako-gonbidapen bidea konfigurazio fidagarri baterako.
Egiaztatu funtzionatzen duela — galdetu: "list my open jobs." (nire lanpostu irekiak zerrendatu.)
Claude — claude.ai eta Claude Desktop
Biak Konektoreen UI bera erabiltzen dute eta URLa itsasteko prozesu bera. OAuth soilik (ez dago goibururik UIan).
Urratsak (web edo mahaigainekoa):
- Ireki Ezarpenak → Konektoreak eta egin klik Gehitu konektore pertsonalizatua.
- Izendatu
Flowmingoeta itsatsi goiko MCP zerbitzariaren URLa. Utzi Aurreratuak → OAuth Bezero-ID / Sekretua hutsik. - Egin klik Gehitu → Konektatu. Flowmingo baimen-orrian, itsatsi zure
fl_API gakoa eta baimendu. - Egiaztatu — galdetu Claude-ri: "list my open jobs." (nire lanpostu irekiak zerrendatu.)
Remote MCP server URL: https://mcp.flowmingo.ai/mcp
Advanced → OAuth Client ID / Secret: (leave blank — Flowmingo uses Dynamic Client Registration)
Taldea / Enpresa: Jabe batek behin gehitzen du Erakundearen Ezarpenak → Konektoreak → Pertsonalizatuak atalean; gero kideek Konektatu klikatzen dute.
Gako estatikoa behar duzu Claude mahaigainean ordez? Erabili Bezero oro (mcp-remote) fitxa.
Zure nabigatzaileak Flowmingo baimen-orri bat irekiko du lehen konexioan — itsatsi zure API gakoa eta baimendu. Geroxeago deskonektatzeko, ezabatu API gako hori Ezarpenak → Integrazioak → API Gakoak atalean.
ChatGPT eta OpenAI Codex CLI
Biak OpenAI dira. ChatGPT-ek Developer Mode erabiltzen du connector pertsonalizatuetarako (OAuth soilik); Codex-ek CLI-tik konektatzen du modu naturalean.
ChatGPT (web)
- chatgpt.com-en (Plus / Pro / Business / Enterprise / Edu — ez mugikorrean), ireki Settings → Apps → Advanced eta aktibatu Developer mode.
- Apps → Create → izena
Flowmingo, itsatsi beheko URLa, garraioa Streamable HTTP, autentifikazioa OAuth. - Ireki zirriborroa, aktibatu tresnak eta sakatu Refresh.
- Erantsi txat batean + menuaren bidez.
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-ren Developer Mode OAuth soilik erabiltzen du — ez du onartzen x-api-key / API-gako estatiko pertsonalizaturik. Connector sinpleek eta sakoneko ikerketakoek search eta fetch soilik erabiltzen dituzte (biak dituzu). Idazteko tresnak (gonbidatu / mugitu / baztertu) Developer Mode eskatzen dute. ChatGPT-k tresna bat exekutatu aurretik erakusten duen mezua ChatGPT-rena da, ez Flowmingo-ren onarpena: gonbidapenak, bazterketak eta hautagaia posta elektronikoz jakinarazten duen etapa baterako mugimenduak beti itxaroten dute pertsona batek onartzea Flowmingo esteka batean.
OpenAI Codex CLI
Ez da zubirik behar — Codex-ek Streamable HTTP modu naturalean hitz egiten du.
# ~/.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
Egiaztatu funtzionatzen duela — galdetu: "zerrendatu nire lan irekiak."
Gemini CLI eta Code Assist
Gemini CLI (eta Gemini Code Assist agent modua) urruneko MCP zerbitzari batera iristen dira ~/.gemini/settings.json bidez. Gemini aplikazio kontsumitzaileak ezin ditu konektore MCP pertsonalizatuak gehitu — bide hau CLI / Code Assist-erako soilik da.
Urratsak: 1) gehitu zerbitzaria mcpServers atalean ~/.gemini/settings.json fitxategian, 2) esportatu FLOWMINGO_API_KEY=fl_..., 3) exekutatu gemini eta /mcp tresnak zerrendatuta daudela ziurtatzeko.
{
"mcpServers": {
"flowmingo": {
"httpUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${FLOWMINGO_API_KEY}" },
"timeout": 30000
}
}
}
httpUrl-ek Streamable HTTP natiboa hautatzen du. ${FLOWMINGO_API_KEY}-ren ordezkoak zure ingurunetik hartzen dira, beraz, ez da gako lehorrik fitxategian idazten. OAuth nahiago duzu? Gemini CLI-ak modu natiboan egin dezake — kendu headers blokea eta gehitu "authProviderType": "dynamic_discovery" zerbitzariaren sarrerari. CLI-ak 401 erronka detektatzen du, gure OAuth metadatuak aurkitzen ditu eta bezeroen erregistro dinamikoa egiten du bere kabuz (ez da bezero-IDrik ezarri behar).
Egiaztatu funtzionatzen duela —
gemini-n, galdetu: "list my open jobs." (nire lanpostu irekiak zerrendatu.)
Beste bezeroak — Windsurf · Zed · Cline · Continue · Antigravity
Beheko bezero bakoitza zerbitzari beraren aurrean funtzionatzen du — gehienek OAuth eta header estatiko bat onartzen dute. Zatikiak gako estatiko bat erabiltzen dute ingurune-aldagai baten bidez; kendu headersak bezero batek OAuth exekutatzeko, onartzen badu. Arreta jarri behean aipatutako bezero bakoitzeko gako-izen tranpetan.
Google Antigravity
Gehitu https://mcp.flowmingo.ai/mcp urruneko MCP zerbitzari gisa eta hautatu berariaz autentifikatzea: Flowmingo orri bat irekiko da eta zure API gako osoa eskatuko du (ikus Gako oso baten itxura goiko Autentifikazio atalean). Antigravity-ren gainazal bakoitzak (IDEa, CLIa) bereizita saioa hasten du. Antigravity-ren mcp_config.json fitxategian helbidea serverUrl azpian jartzen da, eta gako estatiko bat headers bloke batean, Authorization gisa Bearer eta zure gako osoarekin, Google-ren bere Antigravity MCP adibideak bezala. Ezin izan dugu Antigravity bertsio guztiak probatu, beraz zure menuak desberdinak badira, Google-ren gidak urrats eguneratuak ditu.
Windsurf (Cascade)
~/.codeium/windsurf/mcp_config.json — Windsurf serverUrl edo url onartzen ditu, eta OAuth babesten du (kendu headersak hori abiarazteko).
{ "mcpServers": { "flowmingo": {
"serverUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Zed
~/.config/zed/settings.json — gakoa context_servers da; kendu headersak jatorrizko OAuth-erako. Ezarri FLOWMINGO_API_KEY=fl_... zure ingurunean gako gordin bat itsatsi beharrean.
{ "context_servers": { "flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Cline
MCP Zerbitzariak → Konfiguratu — ezarri type: "streamableHttp" (camelCase), bestela hilik dagoen SSEra itzuliko da.
{ "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 — konektatu mcp-remote zubiaren bidez. Ezarri 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 }}"]
Egiaztatu funtzionatzen duela — galdetu: "zerrendatu nire lanpostu irekiak."
Edozein bezero (mcp-remote)
stdio soila duten bezeroentzat (edo etorkizuneko bezero batentzat, jatorrizko urruneko garraiorik gabe), konektatu Flowmingo-ra mcp-remote stdio komandoarekin. --transport http-only derrigorrezkoa da — zerbitzariak ez du SSErik.
Urratsak: 1) ziurtatu Node ≥ 18 duzula, 2) exekutatu zubia stdio komando gisa zure bezeroan, 3) lehen OAuth exekuzioan nabigatzailea irekiko da — itsatsi zure gakoa.
# 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" }
}
}
}
Larrialdia: autentifikazioa trabatuta geratzen bada, exekutatu rm -rf ~/.mcp-auth eta saiatu berriro. Ordeztu fl_YOUR_KEY zure gako osoarekin (ikusi Zer itxura duen gako oso batek goiko Autentifikazio atalean). JSON args[] batean, saihestu espazio bat goiburuaren bi puntuen ondoren (npx ihes-kodeen bitxikeria).
Egiaztatu funtzionatzen duela — galdetu: "zerrendatu nire lan irekiak."