Prezentare generală
Conectează orice asistent AI compatibil MCP la datele tale de angajare Flowmingo — citește joburile și candidații tăi și efectuează acțiuni protejate (invită, mută, respinge, elimină dintr-un proiect), în siguranță, cu permisiunea ta. Cu două permisiuni suplimentare pe care le activezi singur, un asistent poate crea, de asemenea, proiecte de angajare și evaluări și poate publica, închide sau promova o postare de job (vezi Ce poți face). Nou în MCP? Este standardul deschis care permite asistenților AI să comunice cu instrumente precum Flowmingo. Află ce este MCP.
Transport: Streamable HTTP (transportul modern remote). Nu există SSE moștenit — indică întotdeauna clientul tău către /mcp, niciodată /sse.
Tratează cheia API ca pe o parolă. Preferă OAuth, o introducere promptată sau o variabilă de mediu în loc să lipești o cheie brută
fl_...într-un fișier pe care l-ai putea comite în git (de ex..vscode/mcp.json,~/.cursor/mcp.json, configurația ta Continue).
Autentificare — două opțiuni
A — Conectare cu Flowmingo (OAuth, recomandat). Browserul tău deschide o pagină de consimțământ Flowmingo; lipești cheia API acolo. Asistentul nu primește niciodată cheia brută. Primește un token de acces și un token de reîmprospătare, pe care le poate folosi pentru a obține un nou token de acces. Autentificarea nu durează pentru totdeauna. Tokenul de reîmprospătare trăiește aproximativ 30 de zile în mod implicit, numărate de la emiterea sa, la autentificare sau la cea mai recentă reîmprospătare, deci o autentificare neutilizată pentru aproximativ acea perioadă expiră, iar o lansare Flowmingo care schimbă modul în care sunt stocate autentificările poate necesita, de asemenea, să te autentifici din nou. Asistentul îți cere apoi să te autentifici din nou, iar tu lipești din nou cheia. Pentru a o întrerupe mai devreme, șterge acea cheie API. Nu există ID de client sau secret de creat (Flowmingo folosește Dynamic Client Registration). Pe clienții care afișează setări OAuth „Avansate” (de ex. Claude.ai), lasă Client ID și Secret goale.
B — Cheie API statică (header). Trimite cheia ta ca unul dintre headerele:
x-api-key: fl_YOUR_KEY
Authorization: Bearer fl_YOUR_KEY
Obține cheia în Flowmingo → Setări → Integrări → Chei API. Bifează Read hiring data și Read candidates — prima acoperă joburi, pipeline și rezultate, a doua este cea care permite unui asistent să caute pe cineva. Adaugă Manage pipeline / Invite candidates pentru acțiunile de scriere protejate. Pentru a permite unui asistent să creeze proiecte și evaluări și să publice sau să promoveze o postare de job, bifează și Create hiring projects și Create assessments. Citește Creează și publică în secțiunea Ce poți face mai întâi: aceste două permisiuni sunt opționale, iar creatorul cheii trebuie să fie Proprietar sau Administrator.
Cum arată o cheie completă. O singură valoare lungă: fl_live_, numele public al cheii, un punct, apoi un secret lung. Jumătatea secretă este afișată o singură dată, imediat după ce creezi cheia; ulterior lista Chei API afișează doar începutul ei. O valoare fără punct este doar numele cheii și va fi refuzată. Oriunde acest ghid scrie fl_YOUR_KEY, înlocuiește totul cu cheia ta completă, fără ghilimele și fără spații.
Dacă nu se conectează. O cheie greșită sau goală revine ca Missing credential sau The Flowmingo API key was rejected; ambele pot însemna că valoarea nu a ajuns la noi complet, deci verifică mai întâi valoarea. O setare precum ${env:FLOWMINGO_API_KEY} funcționează doar dacă programul poate vedea acea variabilă, iar un editor deschis din dock sau din meniul Start adesea nu citește profilul terminalului tău. Pornește-l dintr-un terminal în care variabila este setată sau pune cheia completă în fișier (și ține acel fișier departe de git).
Pe care să o alegi? Majoritatea clienților acceptă ambele; câțiva (de ex. ChatGPT) sunt doar OAuth — fiecare filă notează ce suportă acel client. În general, OAuth se potrivește asistenților interactivi (Claude.ai, ChatGPT, VS Code); header-ul cu cheie API se potrivește CLI-urilor, headless/CI și editorilor în care preferi să introduci o cheie.
Ce poți face
Citirile nu necesită aprobare. Majoritatea scrierilor sunt protejate. O invitație, o respingere făcută cu acțiunea Reject, o eliminare a candidaților dintr-un proiect, o ștergere a unui proiect sau, în mod normal, o mutare într-o etapă care este setată să trimită un email candidatului așteaptă ca o persoană să o aprobe la un link, autentificată în Flowmingo. Asistentul nu poate aproba, iar un „da” scris în chat nu contează. Setarea de email a etapei este verificată când se solicită mutarea. Pentru o notă, o evaluare, o listă scurtă, o etichetă sau o mutare într-o etapă care nu este setată să trimită email candidatului, asistentului i se spune să afișeze o previzualizare mai întâi și să procedeze doar când ești de acord, ceea ce este o instrucțiune pentru el, nu o blocare. O solicitare pe care clientul tău AI o afișează înainte de a rula un instrument este a clientului și nu este aprobarea Flowmingo: o invitație, o respingere făcută cu acțiunea Reject și o mutare într-o etapă cu email așteaptă în continuare linkul de aprobare, indiferent ce a cerut clientul. Un link de aprobare expiră după 15 minute, iar o singură solicitare pentru mai mulți candidați sau aplicații (maximum 50) este o singură aprobare care îi listează pe toți. Odată ce o modificare este programată, asistentul poate verifica unde se află, o poate retrage în timp ce încă așteaptă și poate anula o modificare reversibilă (o notă, o evaluare, un marcaj de listă scurtă, o etichetă sau o mutare care nu a trimis email nimănui) în termen de 24 de ore. O anulare nu este întotdeauna disponibilă: modificarea trebuie să revină cu o referință de anulare, înregistrarea uneia este best effort, iar o mutare pentru un candidat fără etapă anterioară nu are una, deci asistentul ar trebui să verifice și să spună acest lucru când nu există cale de întoarcere. Un email care a fost trimis nu poate fi anulat. Instrumentele listate sub Creează și publică sunt excepția la toate acestea, cu excepția delete_project: acționează imediat și nu sunt programate pentru aprobare. O eliminare și o ștergere de proiect nu pot fi anulate. Totul este limitat la organizația ta.
Citește
| Capacitate | Ce face |
|---|---|
| Listează postările de job | Navighează prin rolurile deschise și închise ale organizației tale. |
| Listează seturile de interviuri și proiectele | Vezi evaluările tale (seturi de interviuri) de orice fel (interviuri AI, role-play-uri, Teste de Abilități, Teste Tehnice, evaluări CV, Showcase-uri și înregistrări; chestionare când le ceri) și proiectele tale de angajare. |
| Listează pipeline-ul tău de candidați | Vezi aplicațiile pe etape într-un proiect. |
| Citește rezultatele evaluărilor și scorurile | Trage rezultate de orice fel: interviuri AI, role-play-uri, Teste de Abilități, Teste Tehnice, evaluări CV, Showcase-uri, înregistrări și chestionare. Fiecare rezultat este etichetat cu tipul său. Doar unele tipuri au scor AI: un Showcase și un chestionar nu sunt niciodată scorate, iar un Test de Abilități este un procent. |
| Caută un candidat | Obține numele, emailul și CV-ul unui candidat. |
| Caută candidați | Găsește candidați după nume sau email. |
| Compară candidați | Aliniază 2 până la 10 candidați unul lângă altul. Necesită permisiunea Read candidates și Read hiring data. |
| Privire de ansamblu asupra angajărilor | Pâlnia pentru tot ce poate accesa conexiunea ta (întreaga companie, dacă cheia nu a fost făcută de cineva limitat la anumite proiecte), sau restrânsă când ceri: aplicații pe etapă, active vs respinse și, pentru fiecare tip de evaluare care are rezultate, rezultate finalizate vs în curs și scorul mediu. Un proiect restrânge fiecare număr, dar numărătorile sale de rezultate acoperă rezultatele evaluărilor legate de acel proiect, deci un candidat al altui proiect care împarte una dintre acele evaluări poate fi numărat și el. O evaluare restrânge doar numărătorile de rezultate: numărătorile de etape și aplicații rămân la tot ce poate accesa conexiunea ta. Tipurile nu sunt niciodată adunate împreună. |
| Top candidați | Rezultatele cu cel mai mare rang, ordonate după scorul general. Fiecare tip de evaluare este clasat împreună, dacă nu ceri un singur tip sau o singură evaluare (set de interviuri). |
| Detaliu rezultat evaluare | Scorurile per competență ale unui rezultat plus rezumatul AI, pentru tipurile care le au. Un Test de Abilități, un Test Tehnic, un Showcase și un chestionar au puțin sau deloc. |
| Detaliu postare de job | Detaliul complet al unei singure postări de job. |
Este o postare de job deschisă publicului? (get_job_post_publication) |
Dacă oricine poate deschide pagina publică a unei postări de job: live, încă așteaptă verificarea conținutului AI, refuzată de ea, marcată, dezactivată sau proiectul său nu este deschis. De asemenea, adresa sa publică și boost-ul său (off, flowmingo sau extins). Necesită Read hiring data. |
| Interviuri viitoare | Invitații la orice tip de evaluare care au fost trimise sau sunt programate și nu sunt încă finalizate. Nu este un număr al tuturor celor încă restanți: o invitație al cărei candidat a fost reamintit, sau a deschis sau a dat click pe link, este omisă până când candidatul începe, la fel și una care nu a putut fi livrată. |
Scrie (protejat)
| Capacitate | Ce face |
|---|---|
| Invită candidați la o evaluare | Pregătește invitațiile pentru un interviu AI, un role-play, un Test de Abilități sau un Test Tehnic și așteaptă ca o persoană să le aprobe la un link. Nimic nu este trimis înainte de asta. O singură evaluare și maximum 50 de candidați pe cerere; un Test de Abilități sau un Test Tehnic necesită un proiect și un email pentru fiecare candidat, iar unul sponsorizat poate debita wallet-ul organizației tale când un candidat îl începe. |
| Mută un candidat în altă etapă | O mutare într-o etapă care este setată să trimită email candidatului așteaptă în mod normal ca o persoană să o aprobe la un link (setarea de email a etapei este citită o singură dată, chiar înainte de mutare, deci o setare activată în acel moment poate totuși lăsa o mutare să trimită email fără aprobare). Orice altă mutare: asistentul este instruit să o previzualizeze și să aștepte „da”-ul tău, și poate fi de obicei anulată timp de 24 de ore, când a revenit cu o referință de anulare. Maximum 50 de aplicații pe cerere. |
| Respinge o aplicație | Solicită aprobare la un link. Dacă o persoană o aprobă, Flowmingo încearcă să mute aplicația în etapa Respinse a proiectului; verifică rezultatul după aceea. Maximum 50 de aplicații pe cerere. |
Elimină candidați dintr-un proiect (remove_application) |
Necesită Manage pipeline. Solicită aprobare la un link. Dacă o persoană o aprobă, Flowmingo șterge aplicațiile din proiect; profilul candidatului rămâne în bazinul tău de talente și în alte proiecte. Nu este o respingere și nu există anulare. Maximum 50 de aplicații pe cerere. |
| Adaugă o notă la un rezultat | Asistentul este instruit să previzualizeze nota propusă și să aștepte „da”-ul tău înainte de a o salva. O notă aparține unui singur rezultat de evaluare (de orice fel), nu candidatului în ansamblu. |
| Evaluează un rezultat | Asistentul este instruit să previzualizeze evaluarea și să aștepte „da”-ul tău. Evaluarea se aplică unui singur rezultat de evaluare. |
| Listează un rezultat | Asistentul este instruit să previzualizeze modificarea listei scurte și să aștepte „da”-ul tău. Se aplică unui singur rezultat de evaluare. |
| Etichetează / adaugă la colecția de talente | Asistentul este instruit să previzualizeze modificarea etichetei sau a colecției de talente și să aștepte „da”-ul tău. |
| Verifică, retrage sau anulează o modificare | Verifică unde se află o modificare programată (în așteptare, efectuată, eșuată, expirată sau înlocuită de o cerere mai nouă), retrage una care încă așteaptă aprobare sau anulează o modificare reversibilă în termen de 24 de ore, când a revenit cu o referință de anulare. |
Creează și publică (acționează imediat, cu excepția ștergerii unui proiect)
Aceste instrumente creează lucruri și le deschid publicului. Se comportă diferit față de scrierile protejate de mai sus:
- Acționează imediat, cu excepția
delete_project. Nimic nu este programat pentru ca o persoană să aprobe la un link și niciunul nu trimite email unui candidat.delete_projectașteaptă ca un Proprietar sau un Administrator să o aprobe la un link. - Creatorul cheii trebuie să fie un Proprietar sau un Administrator, pentru fiecare instrument de aici, cu excepția anulării, care necesită doar Invite candidates. Instrumentele acționează cu permisiunile persoanei care a creat cheia API. Dacă acea persoană este un Membru, cererea este refuzată.
- Două permisiuni sunt opționale. Create hiring projects și Create assessments nu sunt acordate implicit. Cu autentificare (opțiunea A), asistentul le primește doar dacă ambele condiții sunt îndeplinite: clientul le listează pe nume atunci când se conectează, iar cheia API pe care o introduceți pe pagina de consimțământ le conține. Un client care nu trimite o listă de permisiuni primește cele patru permisiuni standard (Read hiring data, Read candidates, Manage pipeline, Invite candidates) pe care le deține cheia, și niciuna dintre aceste două, astfel încât asistentul nu vede instrumentele care necesită aceste permisiuni. Cu o cheie statică (opțiunea B), asistentul vede aceste instrumente indiferent de permisiunile cheii, iar Flowmingo refuză orice apel pe care cheia nu îl permite.
- Unele apeluri durează. Publicarea așteaptă verificarea conținutului AI, până la aproximativ 90 de secunde. Crearea unui proiect sau a unei evaluări folosește generarea AI și poate dura mai mult (un Test Tehnic durează 3 până la 9 minute). Când răspunsul spune că lucrarea este încă în așteptare, asistentul apelează din nou cu aceeași cheie de idempotență pentru a citi unde a ajuns. O reîncercare nu face niciodată un al doilea proiect sau evaluare.
| Capacitate | Ce face |
|---|---|
Creează un proiect de angajare (create_project) |
Necesită Create hiring projects (opțional). Face un proiect cu cele patru etape implicite și o postare de job scrisă de același AI ca dashboard-ul, dintr-un titlu, poziție și o descriere opțională. În mod implicit, face și o Evaluare CV și un Interviu AI; asistentul poate numi alte evaluări sau niciuna. Postarea de job este activată și devine publică odată ce verificarea conținutului AI o aprobă, în mod normal într-un minut. Limitat la 10 proiecte pe minut și 300 pe zi pentru compania ta. Cheia de idempotență este opțională: când este omisă, una este făcută din argumente, deci o reîncercare nu face niciodată un al doilea proiect. |
Creează o evaluare (create_assessment) |
Necesită Create assessments (opțional). Face o evaluare cu AI: un Interviu AI, o Evaluare CV, un Test de Abilități, un Showcase, un Test Tehnic sau un Role-play, dintr-un titlu de job și o descriere opțională, nume, proiect și limbă (o etichetă precum en sau vi-VN; un Test de Abilități și un Test Tehnic ignoră limba). Atașează-l la un proiect astfel încât candidații să poată fi invitați la un Test de Abilități, un Test Tehnic sau un Showcase. Cheia de idempotență este opțională, ca mai sus. |
Publică o postare de job (publish_job_post) |
Necesită Create hiring projects. Activează postarea de job și se asigură că verificarea conținutului AI a rulat. Răspunsul spune dacă pagina este live acum, încă așteaptă verificarea sau a fost refuzată de ea. Proiectul de angajare trebuie să fie activ. |
Anulează publicarea unei postări de job (unpublish_job_post) |
Necesită Create hiring projects. Dezactivează postarea de job, deci linkul său public nu se mai deschide. În mod implicit, boost-ul este și el dezactivat (withdraw_boost este adevărat). |
Promovează o postare de job (boost_job_post) |
Necesită Create hiring projects. Setează boost-ul la off, flowmingo sau extended. Boost-ul este gratuit. Creșterea necesită postarea de job activată, proiectul activ, un logo și o descriere a companiei și verificarea conținutului AI; o companie poate ridica 50 de boost-uri pe zi. |
Deschide, schiță sau arhivează un proiect (set_project_state) |
Necesită Create hiring projects. Mută un proiect de angajare între active, draft și archived. Schițele și arhivatele închid linkul jobului. Datele candidaților sunt păstrate. |
Anulează o invitație programată (cancel_scheduled_invite) |
Necesită Invite candidates. Anulează o invitație care a fost programată pentru mai târziu și nu a fost încă trimisă, folosind ID-ul invitației din rezultatul invitației. Nimănui nu i se trimite email. Persoana rămâne în contul tău și pe panoul proiectului. |
Șterge un proiect de angajare (delete_project) |
Necesită Create hiring projects (opțional). Doar cere: nu șterge imediat, solicită aprobare la un link și nimic nu este șters până când un Proprietar sau un Administrator o aprobă. Doar un proiect activ poate fi șters. Dacă o persoană o aprobă, Flowmingo șterge proiectul și postările sale de job; aplicațiile sale de candidați nu sunt șterse una câte una, iar profilurile și contactele candidaților, evaluările tale și linkurile de invitație sunt păstrate. Nu există anulare. |
Securitate și încredere
- Datele tale sunt limitate la organizație — asistentul nu poate vedea niciodată datele altei companii.
- Cu OAuth, asistentul nu primește niciodată cheia ta API. Primește un token de acces care expiră după o oră, reîmprospătat în liniște în timp ce rămâne conectat. Autentificarea în sine durează cât tokenul său de reîmprospătare, aproximativ 30 de zile în mod implicit de la emitere sau ultima reîmprospătare, deci expiră după aproximativ 30 de zile fără utilizare, iar apoi te autentifici din nou. Cu un header static (opțiunea B), clientul asistentului tău deține cheia și o trimite cu fiecare cerere, deci ține-o departe de fișierele pe care le-ai putea partaja sau comite.
- Întrerupe un asistent: șterge cheia API cu care l-ai autorizat, în Setări → Integrări → Chei API. Accesul se oprește imediat. Nu există încă o deconectare per asistent, deci dacă vrei să-i revoci unul câte unul, dă fiecărui asistent propria cheie.
- Cererile către endpoint-ul
/mcpsunt verificate pentru Originea lor: o origine opacănulleste întotdeauna refuzată, iar verificarea poate fi blocată pe o listă de permise, dar în mod implicit fiecare origine reală este acceptată, deci protecția este credențialul tău, nu originea. Fiecare sesiune este legată de credențialul care a deschis-o.
Pentru cum să te autentifici, vezi Autentificare — două opțiuni; pentru citirile exacte, scrierile protejate și acțiunile care au loc imediat, vezi Ce poți face. Când ești gata, sări la Conectează-ți asistentul și alege-ți clientul.
URL server MCP
Conectați-vă asistentul
Claude Code (CLI)
O singură comandă adaugă Flowmingo peste Streamable HTTP nativ. Conectează-te cu OAuth; --header static este alternativa.
Pași: 1) adaugă serverul, 2) autentifică-te (browser → lipește cheia), 3) claude mcp list pentru verificare.
# 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
Atenție: flag-urile trebuie să vină înaintea numelui și folosește întotdeauna --transport http (niciodată sse). Înlocuiește fl_YOUR_KEY cu cheia ta completă (vezi Cum arată o cheie completă în secțiunea Autentificare de mai sus).
Verifică funcționarea — întreabă: "listează joburile mele deschise."
Cursor
Antetul static este cea mai simplă cale. Cursor poate folosi și OAuth (suportă Dynamic Client Registration) — pentru aceasta, eliminați blocul headers.
Pași: 1) adăugați serverul în ~/.cursor/mcp.json (mai jos), 2) setați FLOWMINGO_API_KEY cu cheia completă în profilul shell-ului, 3) închideți Cursor și reporniți-l dintr-un terminal unde variabila este setată, 4) în Settings → MCP, dezactivați și activați serverul pentru a-l reîncărca.
Cursor trebuie să vadă variabila. Cursor citește ${env:FLOWMINGO_API_KEY} din propriul mediu. Dacă este pornit din dock sau din meniul Start, adesea nu vede o variabilă setată în profilul terminalului, iar antetul ajunge gol sau neexpandat, iar serverul răspunde cu Missing credential. Dacă pornirea Cursor dintr-un terminal nu este practică, înlocuiți ${env:FLOWMINGO_API_KEY} din fișier cu cheia completă (și păstrați ~/.cursor/mcp.json în afara git).
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
}
}
}
OAuth alternativ — eliminați blocul headers; Cursor rulează Dynamic Client Registration și deschide o pagină de consimțământ în browser la prima conectare:
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp"
}
}
}
Verificați că funcționează — întrebați: "listă cu joburile mele deschise."
VS Code (Copilot, mod agent)
Instrumentele apar doar în Copilot Chat → Mod agent. Cheia rădăcină este servers (nu mcpServers) și tipul este http. Calea cheii solicitate mai jos este configurarea fiabilă.
Pași: 1) creați .vscode/mcp.json (sau rulați MCP: Adăugați Server → HTTP), 2) când porniți serverul, VS Code vă solicită cheia (aceasta nu este scrisă în fișier), 3) folosiți-o în Mod agent.
{
"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 poate încerca și OAuth, dar configurația documentată OAuth așteaptă un ID de client; folosiți calea cheii solicitate mai sus pentru o configurare fiabilă.
Verificați dacă funcționează — întrebați: "list my open jobs."
Claude — claude.ai & Claude Desktop
Ambele folosesc aceeași interfață de utilizator pentru Conectori și același flux de lipire a URL-ului. Doar OAuth (nu există câmp pentru header în UI).
Pași (web sau desktop):
- Deschideți Setări → Conectori și faceți clic pe Adăugați un conector personalizat.
- Denumiți-l
Flowmingoși lipiți URL-ul serverului MCP de mai sus. Lăsați Avansat → ID Client OAuth / Secret necompletate. - Faceți clic pe Adăugați → Conectați. Pe pagina de consimțământ Flowmingo, lipiți cheia API
fl_și autorizați. - Verificați — întrebați Claude: "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)
Echipă / Enterprise: Un Proprietar îl adaugă o dată sub Setări Organizație → Conectori → Personalizat; membrii fac apoi clic pe Conectați.
Aveți nevoie de o cheie statică pe Claude Desktop în schimb? Folosiți fila Orice client (mcp-remote).
Browserul dvs. deschide o pagină de consimțământ Flowmingo la prima conectare — introduceți cheia API și autorizați. Pentru a deconecta ulterior, ștergeți acea cheie API în Setări → Integrări → Chei API.
ChatGPT și OpenAI Codex CLI
Ambele sunt OpenAI. ChatGPT folosește Developer Mode pentru conectori personalizați (doar OAuth); Codex se conectează nativ din CLI.
ChatGPT (web)
- Pe chatgpt.com (Plus / Pro / Business / Enterprise / Edu — nu pe mobil), deschide Settings → Apps → Advanced și activează Developer mode.
- Apps → Create → numește-l
Flowmingo, lipește URL-ul de mai jos, transport Streamable HTTP, autentificare OAuth. - Deschide proiectul, activează instrumentele și apasă Refresh.
- Atașează-l prin meniul + dintr-un chat.
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)
Developer Mode din ChatGPT se conectează doar cu OAuth — nu acceptă un header static x-api-key / cheie API personalizată. Conectorii simpli și deep-research folosesc doar search + fetch (le ai pe ambele). Instrumentele de scriere (invite / move / reject) necesită Developer Mode. Un prompt pe care ChatGPT îl afișează înainte de a rula un instrument este propriul prompt al ChatGPT și nu este aprobarea Flowmingo: o invitație, o respingere și o mutare într-o etapă care trimite email candidatului așteaptă întotdeauna aprobarea unei persoane printr-un link Flowmingo.
OpenAI Codex CLI
Nu este nevoie de punte — Codex vorbește nativ Streamable HTTP.
# ~/.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
Verifică dacă funcționează — întreabă: "listează joburile mele deschise."
Gemini CLI & Code Assist
Gemini CLI (și modul agent Gemini Code Assist) accesează un server MCP la distanță prin ~/.gemini/settings.json. Aplicația Gemini consumator nu poate adăuga conectori MCP personalizați — această cale este doar pentru CLI / Code Assist.
Pași: 1) adăugați serverul sub mcpServers în ~/.gemini/settings.json, 2) exportați FLOWMINGO_API_KEY=fl_..., 3) rulați gemini și /mcp pentru a confirma că instrumentele sunt listate.
{
"mcpServers": {
"flowmingo": {
"httpUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${FLOWMINGO_API_KEY}" },
"timeout": 30000
}
}
}
httpUrl selectează HTTP Streamable nativ. Placeholder-ul ${FLOWMINGO_API_KEY} este extins din mediul dvs., deci nicio cheie brută nu este scrisă în fișier. Preferă OAuth? Gemini CLI poate face acest lucru nativ — eliminați blocul headers și adăugați "authProviderType": "dynamic_discovery" la intrarea serverului. CLI-ul detectează provocarea 401, descoperă metadatele noastre OAuth și efectuează înregistrarea dinamică a clienților pe cont propriu (fără ID de client de setat).
Verificați dacă funcționează — în
gemini, întrebați: "list my open jobs."
Alți clienți — Windsurf · Zed · Cline · Continue · Antigravity
Fiecare client de mai jos funcționează cu același server — majoritatea acceptă atât OAuth, cât și un header static. Exemplele folosesc o cheie statică printr-o variabilă de mediu; eliminați headers pentru a lăsa clientul să ruleze OAuth acolo unde îl acceptă. Fiți atenți la capcanele legate de numele cheilor specifice fiecărui client, menționate mai jos.
Google Antigravity
Adăugați https://mcp.flowmingo.ai/mcp ca server MCP remote și alegeți să vă autentificați: se deschide o pagină Flowmingo care vă cere cheia API completă (vezi Cum arată o cheie completă în secțiunea Autentificare de mai sus). Fiecare suprafață Antigravity (IDE, CLI) se conectează separat. În mcp_config.json din Antigravity, adresa merge sub serverUrl, iar o cheie statică merge într-un bloc headers ca Authorization cu Bearer și cheia completă, ca în exemplele Antigravity MCP ale Google. Nu am putut testa fiecare versiune Antigravity, deci dacă meniurile dumneavoastră diferă, ghidul Google are pașii actuali.
Windsurf (Cascade)
~/.codeium/windsurf/mcp_config.json — Windsurf acceptă serverUrl sau url și suportă OAuth (omiteți headers pentru a-l declanșa).
{ "mcpServers": { "flowmingo": {
"serverUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Zed
~/.config/zed/settings.json — cheia este context_servers; omiteți headers pentru OAuth nativ. Setați FLOWMINGO_API_KEY=fl_... în mediul dumneavoastră, nu lipiți o cheie brută.
{ "context_servers": { "flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Cline
MCP Servers → Configure — setați type: "streamableHttp" (camelCase), altfel implicit este SSE mort.
{ "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 — conectați-vă prin puntea mcp-remote. Setați 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 }}"]
Verificați că funcționează — întrebați: "listați posturile mele deschise."
Orice client (mcp-remote)
Pentru orice client doar stdio (sau un client viitor fără transport remote nativ), conectați-vă la Flowmingo cu comanda stdio mcp-remote. --transport http-only este obligatoriu — serverul nu are SSE.
Pași: 1) asigurați-vă că Node ≥ 18, 2) rulați puntea ca o comandă stdio în clientul dvs., 3) la prima rulare OAuth, browserul se deschide — lipiți cheia dvs.
# 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" }
}
}
}
Salvare: dacă autentificarea rămâne blocată, rulați rm -rf ~/.mcp-auth și reîncercați. Înlocuiți fl_YOUR_KEY cu cheia completă (vedeți Cum arată o cheie completă în secțiunea Autentificare de mai sus). Într-un args[] JSON, evitați un spațiu după două punctele din header (particularitate de escaping npx).
Verificați dacă funcționează — întrebați: „listați joburile mele deschise.”