Integrări

Conectați Asistenți AI (MCP)

Conectați orice asistent AI compatibil MCP — Claude, Claude Code, ChatGPT, Cursor, VS Code și altele — la datele dvs. de recrutare Flowmingo și lucrați cu fluxul dvs. în limbaj natural.

Our team is online
Ai nevoie de ajutor cu integrarea?

Te-ai blocat la un pas sau ai nevoie de asistență tehnică? Echipa noastră te ajută cu plăcere — scrie-ne oricând și te punem în legătură.

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_project aș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 /mcp sunt verificate pentru Originea lor: o origine opacă null este î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

URL server MCPhttps://mcp.flowmingo.ai/mcp

Conectați-vă asistentul

Ce asistent folosiți?

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."