Επισκόπηση
Συνδέστε οποιονδήποτε συμβατό με MCP βοηθό AI στα δεδομένα προσλήψεων του Flowmingo — διαβάστε τις θέσεις εργασίας και τους υποψηφίους σας και εκτελέστε προστατευμένες ενέργειες (πρόσκληση, μετακίνηση, απόρριψη, αφαίρεση από έργο), με ασφάλεια και με την άδειά σας. Με δύο επιπλέον άδειες που ενεργοποιείτε μόνοι σας, ένας βοηθός μπορεί επίσης να δημιουργήσει έργα πρόσληψης και αξιολογήσεις και να δημοσιεύσει, κλείσει ή προωθήσει μια θέση εργασίας (δείτε Τι μπορείτε να κάνετε). Νέοι στο MCP; Είναι το ανοιχτό πρότυπο που επιτρέπει στους βοηθούς AI να επικοινωνούν με εργαλεία όπως το Flowmingo. Μάθετε τι είναι το MCP.
Μεταφορά: Streamable HTTP (η σύγχρονη απομακρυσμένη μεταφορά). Δεν υπάρχει παλαιού τύπου SSE — κατευθύνετε πάντα τον πελάτη σας στο /mcp, ποτέ στο /sse.
Αντιμετωπίστε το κλειδί API σας σαν κωδικό πρόσβασης. Προτιμήστε το OAuth, μια προτροπή εισαγωγής ή μια μεταβλητή περιβάλλοντος αντί να επικολλήσετε ένα ακατέργαστο κλειδί
fl_...σε ένα αρχείο που μπορεί να δεσμεύσετε στο git (π.χ..vscode/mcp.json,~/.cursor/mcp.json, τη διαμόρφωση Continue).
Έλεγχος ταυτότητας — δύο επιλογές
Α — Σύνδεση με το Flowmingo (OAuth, συνιστάται). Το πρόγραμμα περιήγησής σας ανοίγει μια σελίδα συγκατάθεσης του Flowmingo· επικολλάτε εκεί το κλειδί API σας. Ο βοηθός δεν λαμβάνει ποτέ το ακατέργαστο κλειδί σας. Λαμβάνει ένα διακριτικό πρόσβασης και ένα διακριτικό ανανέωσης, το οποίο μπορεί να χρησιμοποιήσει για να αποκτήσει νέο διακριτικό πρόσβασης. Η σύνδεση δεν διαρκεί για πάντα. Το διακριτικό ανανέωσης ζει περίπου 30 ημέρες από προεπιλογή, μετρημένο από την έκδοσή του, κατά τη σύνδεση ή την τελευταία ανανέωση, έτσι μια σύνδεση που δεν χρησιμοποιείται για τόσο διάστημα λήγει, και μια έκδοση του Flowmingo που αλλάζει τον τρόπο αποθήκευσης των συνδέσεων μπορεί επίσης να απαιτήσει να συνδεθείτε ξανά. Στη συνέχεια, ο βοηθός σας ζητά να συνδεθείτε ξανά και επικολλάτε ξανά το κλειδί σας. Για να το διακόψετε νωρίτερα, διαγράψτε αυτό το κλειδί API. Δεν χρειάζεται να δημιουργήσετε αναγνωριστικό πελάτη ή μυστικό (το Flowmingo χρησιμοποιεί Δυναμική Εγγραφή Πελάτη). Σε πελάτες που εμφανίζουν "Για προχωρημένους" ρυθμίσεις OAuth (π.χ. Claude.ai), αφήστε το Αναγνωριστικό Πελάτη και το Μυστικό κενά.
Β — Στατικό κλειδί API (κεφαλίδα). Στείλτε το κλειδί σας ως μία από τις παρακάτω κεφαλίδες:
x-api-key: fl_YOUR_KEY
Authorization: Bearer fl_YOUR_KEY
Αποκτήστε το κλειδί σας στο Flowmingo → Ρυθμίσεις → Ενσωματώσεις → Κλειδιά API. Τσεκάρετε Read hiring data και Read candidates — το πρώτο καλύπτει θέσεις εργασίας, pipeline και αποτελέσματα, το δεύτερο επιτρέπει στον βοηθό να αναζητήσει κάποιον. Προσθέστε Manage pipeline / Invite candidates για τις προστατευμένες ενέργειες εγγραφής. Για να επιτρέψετε σε έναν βοηθό να δημιουργεί έργα και αξιολογήσεις και να δημοσιεύει ή να προωθεί μια θέση εργασίας, τσεκάρετε επίσης Create hiring projects και Create assessments. Διαβάστε Δημιουργία και δημοσίευση στο Τι μπορείτε να κάνετε πρώτα: αυτές οι δύο άδειες είναι προαιρετικές και ο δημιουργός του κλειδιού πρέπει να είναι Ιδιοκτήτης ή Διαχειριστής.
Πώς μοιάζει ένα πλήρες κλειδί. Μία μεγάλη τιμή: fl_live_, το δημόσιο όνομα του κλειδιού, μια τελεία και μετά ένα μακρύ μυστικό. Το μισό μυστικό εμφανίζεται μία φορά, αμέσως μετά τη δημιουργία του κλειδιού· αργότερα η λίστα Κλειδιών API δείχνει μόνο την αρχή του. Μια τιμή χωρίς τελεία είναι μόνο το όνομα του κλειδιού και θα απορριφθεί. Όπου αυτός ο οδηγός γράφει fl_YOUR_KEY, αντικαταστήστε όλο αυτό με το πλήρες κλειδί σας, χωρίς εισαγωγικά και χωρίς κενά.
Αν δεν συνδέεται. Ένα κακό ή κενό κλειδί επιστρέφει ως Missing credential ή The Flowmingo API key was rejected· και τα δύο μπορεί να σημαίνουν ότι η τιμή δεν έφτασε ποτέ πλήρως σε εμάς, οπότε ελέγξτε πρώτα την τιμή. Μια ρύθμιση όπως ${env:FLOWMINGO_API_KEY} λειτουργεί μόνο αν το πρόγραμμα μπορεί να δει αυτή τη μεταβλητή, και ένας επεξεργαστής που ανοίγει από το dock ή το μενού Έναρξη συχνά δεν διαβάζει το προφίλ τερματικού σας. Ξεκινήστε το από ένα τερματικό όπου έχει οριστεί η μεταβλητή ή βάλτε το πλήρες κλειδί στο αρχείο (και κρατήστε το αρχείο εκτός git).
Ποια να επιλέξετε; Οι περισσότεροι πελάτες υποστηρίζουν και τα δύο· μερικοί (π.χ. ChatGPT) είναι μόνο OAuth — κάθε καρτέλα σημειώνει τι υποστηρίζει αυτός ο πελάτης. Γενικά, το OAuth ταιριάζει σε διαδραστικούς βοηθούς (Claude.ai, ChatGPT, VS Code)· η κεφαλίδα κλειδιού API ταιριάζει σε CLI, headless/CI και επεξεργαστές όπου προτιμάτε να εισάγετε ένα κλειδί.
Τι μπορείτε να κάνετε
Οι αναγνώσεις δεν απαιτούν έγκριση. Οι περισσότερες εγγραφές είναι προστατευμένες. Μια πρόσκληση, μια απόρριψη με την ενέργεια Απόρριψη, μια αφαίρεση υποψηφίων από ένα έργο, μια διαγραφή έργου ή, συνήθως, μια μετακίνηση σε στάδιο που έχει ρυθμιστεί να στέλνει email στον υποψήφιο, περιμένει ένα άτομο να το εγκρίνει σε έναν σύνδεσμο, συνδεδεμένο στο Flowmingo. Ο βοηθός δεν μπορεί να το εγκρίνει, και ένα "ναι" που πληκτρολογείται στη συνομιλία δεν μετράει. Η ρύθμιση email του σταδίου ελέγχεται όταν ζητείται η μετακίνηση. Για μια σημείωση, μια βαθμολογία, μια λίστα επιλογής, μια ετικέτα ή μια μετακίνηση σε στάδιο που δεν έχει ρυθμιστεί να στέλνει email στον υποψήφιο, ο βοηθός λαμβάνει οδηγίες να σας δείξει πρώτα μια προεπισκόπηση και να προχωρήσει μόνο όταν συμφωνείτε, που είναι οδηγία προς αυτόν, όχι κλείδωμα. Μια προτροπή που εμφανίζει ο πελάτης AI σας πριν εκτελέσει ένα εργαλείο είναι δική του και δεν αποτελεί έγκριση του Flowmingo: μια πρόσκληση, μια απόρριψη με την ενέργεια Απόρριψη και μια μετακίνηση σε στάδιο με email εξακολουθούν να περιμένουν τον σύνδεσμο έγκρισης, ό,τι κι αν ρώτησε ο πελάτης. Ένας σύνδεσμος έγκρισης λήγει μετά από 15 λεπτά, και ένα αίτημα για πολλούς υποψηφίους ή αιτήσεις (το πολύ 50) είναι μία έγκριση που παραθέτει όλους. Μόλις σταδιοποιηθεί μια αλλαγή, ο βοηθός μπορεί να ελέγξει πού βρίσκεται, να την αποσύρει όσο περιμένει ακόμα και να αναιρέσει μια αναστρέψιμη αλλαγή (μια σημείωση, μια βαθμολογία, μια σήμανση λίστας επιλογής, μια ετικέτα ή μια μετακίνηση που δεν έστειλε email σε κανέναν) εντός 24 ωρών. Μια αναίρεση δεν είναι πάντα διαθέσιμη: η αλλαγή πρέπει να επιστρέψει με μια αναφορά αναίρεσης, η καταγραφή μιας είναι καλύτερη προσπάθεια, και μια μετακίνηση για υποψήφιο χωρίς προηγούμενο στάδιο δεν έχει καμία, οπότε ο βοηθός θα πρέπει να ελέγξει και να το πει όταν δεν υπάρχει τρόπος επιστροφής. Ένα email που έχει σταλεί δεν μπορεί να αναιρεθεί. Τα εργαλεία που αναφέρονται κάτω από Δημιουργία και δημοσίευση αποτελούν εξαίρεση σε όλα αυτά, εκτός από το delete_project: ενεργούν αμέσως και δεν σταδιοποιούνται για έγκριση. Μια αφαίρεση και μια διαγραφή έργου δεν μπορούν να αναιρεθούν. Όλα περιορίζονται στον οργανισμό σας.
Ανάγνωση
| Δυνατότητα | Τι κάνει |
|---|---|
| Λίστα θέσεων εργασίας | Περιηγηθείτε στις ανοιχτές και κλειστές θέσεις του οργανισμού σας. |
| Λίστα συνόλων συνεντεύξεων & έργων | Δείτε τις αξιολογήσεις σας (σύνολα συνεντεύξεων) κάθε είδους (συνεντεύξεις AI, role-plays, Τεστ Δεξιοτήτων, Τεχνικά Τεστ, Αξιολογήσεις Βιογραφικών, Επιδείξεις και εγγραφές· ερωτηματολόγια όταν τα ζητάτε) και τα έργα πρόσληψής σας. |
| Λίστα του pipeline υποψηφίων σας | Δείτε αιτήσεις ανά στάδιο σε ένα έργο. |
| Ανάγνωση αποτελεσμάτων αξιολόγησης & βαθμολογιών | Λάβετε αποτελέσματα κάθε είδους: συνεντεύξεις AI, role-plays, Τεστ Δεξιοτήτων, Τεχνικά Τεστ, Αξιολογήσεις Βιογραφικών, Επιδείξεις, εγγραφές και ερωτηματολόγια. Κάθε αποτέλεσμα φέρει ετικέτα με το είδος του. Μόνο ορισμένα είδη έχουν βαθμολογία AI: μια Επίδειξη και ένα ερωτηματολόγιο δεν βαθμολογούνται ποτέ, και ένα Τεστ Δεξιοτήτων είναι ποσοστό. |
| Αναζήτηση υποψηφίου | Λάβετε το όνομα, το email και το βιογραφικό ενός υποψηφίου. |
| Αναζήτηση υποψηφίων | Βρείτε υποψηφίους με όνομα ή email. |
| Σύγκριση υποψηφίων | Παρατάξτε 2 έως 10 υποψηφίους δίπλα-δίπλα. Απαιτεί την άδεια Read candidates καθώς και την Read hiring data. |
| Επισκόπηση προσλήψεων | Το funnel για ό,τι μπορεί να φτάσει η σύνδεσή σας (ολόκληρη η εταιρεία, εκτός αν το κλειδί δημιουργήθηκε από κάποιον περιορισμένο σε ορισμένα έργα), ή στενότερο όταν το ζητήσετε: αιτήσεις ανά στάδιο, ενεργές έναντι απορριφθέντων και, για κάθε είδος αξιολόγησης με αποτελέσματα, ολοκληρωμένα έναντι σε εξέλιξη αποτελέσματα και η μέση βαθμολογία. Ένα έργο στενεύει κάθε μέτρηση, αλλά οι μετρήσεις αποτελεσμάτων του καλύπτουν τα αποτελέσματα στις αξιολογήσεις που συνδέονται με αυτό το έργο, οπότε ένας υποψήφιος άλλου έργου που μοιράζεται μία από αυτές τις αξιολογήσεις μπορεί να μετρηθεί επίσης. Μια αξιολόγηση στενεύει μόνο τις μετρήσεις αποτελεσμάτων: οι μετρήσεις σταδίων και αιτήσεων παραμένουν σε ό,τι μπορεί να φτάσει η σύνδεσή σας. Τα είδη δεν προστίθενται ποτέ μεταξύ τους. |
| Κορυφαίοι υποψήφιοι | Τα αποτελέσματα με την υψηλότερη κατάταξη, ταξινομημένα με συνολική βαθμολογία. Κάθε είδος αξιολόγησης κατατάσσεται μαζί εκτός αν ζητήσετε ένα είδος ή μία αξιολόγηση (σύνολο συνεντεύξεων). |
| Λεπτομέρεια αποτελέσματος αξιολόγησης | Οι βαθμολογίες ανά ικανότητα ενός αποτελέσματος καθώς και η σύνοψη AI, για τα είδη που τις έχουν. Ένα Τεστ Δεξιοτήτων, ένα Τεχνικό Τεστ, μια Επίδειξη και ένα ερωτηματολόγιο έχουν ελάχιστες ή καθόλου. |
| Λεπτομέρεια θέσης εργασίας | Η πλήρης λεπτομέρεια μιας μεμονωμένης θέσης εργασίας. |
Είναι μια θέση εργασίας δημόσια; (get_job_post_publication) |
Αν οποιοσδήποτε μπορεί να ανοίξει τη δημόσια σελίδα μιας θέσης: ενεργή, ακόμα σε αναμονή για τον έλεγχο περιεχομένου AI, απορριφθείσα από αυτόν, επισημασμένη, απενεργοποιημένη ή το έργο της δεν είναι ανοιχτό. Επίσης η δημόσια διεύθυνσή της και η προώθησή της (off, flowmingo ή extended). Απαιτεί Read hiring data. |
| Επερχόμενες συνεντεύξεις | Προσκλήσεις σε οποιοδήποτε είδος αξιολόγησης που στάλθηκαν ή έχουν προγραμματιστεί και δεν έχουν ακόμα ολοκληρωθεί. Δεν είναι μέτρηση όλων όσων εκκρεμούν: μια πρόσκληση της οποίας ο υποψήφιος έχει λάβει υπενθύμιση, ή έχει ανοίξει ή κάνει κλικ στον σύνδεσμο, παραλείπεται μέχρι να ξεκινήσει ο υποψήφιος, και επίσης αυτή που δεν παραδόθηκε. |
Εγγραφή (προστατευμένη)
| Δυνατότητα | Τι κάνει |
|---|---|
| Πρόσκληση υποψηφίων σε αξιολόγηση | Προετοιμάζει τις προσκλήσεις για μια συνέντευξη AI, ένα role-play, ένα Τεστ Δεξιοτήτων ή ένα Τεχνικό Τεστ και περιμένει ένα άτομο να τις εγκρίνει σε έναν σύνδεσμο. Τίποτα δεν αποστέλλεται πριν από αυτό. Μία αξιολόγηση και το πολύ 50 υποψήφιοι ανά αίτημα· ένα Τεστ Δεξιοτήτων ή ένα Τεχνικό Τεστ χρειάζεται ένα έργο και ένα email για κάθε υποψήφιο, και ένα χορηγούμενο μπορεί να χρεώσει το πορτοφόλι του οργανισμού σας όταν ένας υποψήφιος το ξεκινήσει. |
| Μετακίνηση υποψηφίου σε άλλο στάδιο | Μια μετακίνηση σε στάδιο που έχει ρυθμιστεί να στέλνει email στον υποψήφιο συνήθως περιμένει ένα άτομο να το εγκρίνει σε έναν σύνδεσμο (η ρύθμιση email του σταδίου διαβάζεται μία φορά, λίγο πριν τη μετακίνηση, οπότε μια ρύθμιση που ενεργοποιείται εκείνη τη στιγμή μπορεί να επιτρέψει σε μια μετακίνηση να στείλει email χωρίς έγκριση). Οποιαδήποτε άλλη μετακίνηση: ο βοηθός λαμβάνει οδηγίες να την προεπισκοπήσει και να περιμένει το ναι σας, και συνήθως μπορεί να αναιρεθεί για 24 ώρες, όταν επέστρεψε με αναφορά αναίρεσης. Το πολύ 50 αιτήσεις ανά αίτημα. |
| Απόρριψη αιτήσεως | Ζητά έγκριση σε σύνδεσμο. Αν ένα άτομο την εγκρίνει, το Flowmingo προσπαθεί να μετακινήσει την αίτηση στο στάδιο Απορρίφθηκε του έργου· ελέγξτε το αποτέλεσμα στη συνέχεια. Το πολύ 50 αιτήσεις ανά αίτημα. |
Αφαίρεση υποψηφίων από έργο (remove_application) |
Απαιτεί Manage pipeline. Ζητά έγκριση σε σύνδεσμο. Αν ένα άτομο την εγκρίνει, το Flowmingo διαγράφει τις αιτήσεις από το έργο· το προφίλ του υποψηφίου παραμένει στην ομάδα ταλέντων σας και σε άλλα έργα. Δεν είναι απόρριψη και δεν υπάρχει αναίρεση. Το πολύ 50 αιτήσεις ανά αίτημα. |
| Προσθήκη σημείωσης σε αποτέλεσμα | Ο βοηθός λαμβάνει οδηγίες να προεπισκοπήσει την προτεινόμενη σημείωση και να περιμένει το ναι σας πριν την αποθηκεύσει. Μια σημείωση ανήκει σε ένα αποτέλεσμα αξιολόγησης (οποιουδήποτε είδους), όχι στον υποψήφιο ως σύνολο. |
| Βαθμολόγηση αποτελέσματος | Ο βοηθός λαμβάνει οδηγίες να προεπισκοπήσει τη βαθμολογία και να περιμένει το ναι σας. Η βαθμολογία εφαρμόζεται σε ένα αποτέλεσμα αξιολόγησης. |
| Προσθήκη σε λίστα επιλογής | Ο βοηθός λαμβάνει οδηγίες να προεπισκοπήσει την αλλαγή στη λίστα επιλογής και να περιμένει το ναι σας. Εφαρμόζεται σε ένα αποτέλεσμα αξιολόγησης. |
| Ετικέτα / προσθήκη σε συλλογή ταλέντων | Ο βοηθός λαμβάνει οδηγίες να προεπισκοπήσει την αλλαγή ετικέτας ή συλλογής ταλέντων και να περιμένει το ναι σας. |
| Έλεγχος, απόσυρση ή αναίρεση αλλαγής | Ελέγξτε πού βρίσκεται μια σταδιοποιημένη αλλαγή (σε αναμονή, εκτελέστηκε, απέτυχε, έληξε ή αντικαταστάθηκε από νεότερο αίτημα), αποσύρετε μία που περιμένει ακόμα έγκριση ή αναιρέστε μια αναστρέψιμη αλλαγή εντός 24 ωρών, όταν επέστρεψε με αναφορά αναίρεσης. |
Δημιουργία και δημοσίευση (ενεργεί αμέσως, εκτός από τη διαγραφή έργου)
Αυτά τα εργαλεία δημιουργούν πράγματα και τα ανοίγουν στο κοινό. Συμπεριφέρονται διαφορετικά από τις παραπάνω προστατευμένες εγγραφές:
- Ενεργούν αμέσως, εκτός από το
delete_project. Τίποτα δεν σταδιοποιείται για έγκριση από άτομο σε σύνδεσμο και κανένα δεν στέλνει email σε υποψήφιο. Τοdelete_projectπεριμένει έναν Ιδιοκτήτη ή Διαχειριστή να το εγκρίνει σε σύνδεσμο. - Ο δημιουργός του κλειδιού πρέπει να είναι Ιδιοκτήτης ή Διαχειριστής, για κάθε εργαλείο εδώ εκτός από την ακύρωση, που απαιτεί μόνο Invite candidates. Τα εργαλεία ενεργούν με τις άδειες του ατόμου που δημιούργησε το κλειδί API. Αν αυτό το άτομο είναι Μέλος, η κλήση απορρίπτεται.
- Δύο άδειες είναι προαιρετικές. Η Create hiring projects και η Create assessments δεν χορηγούνται από προεπιλογή. Με τη σύνδεση (επιλογή Α), ο βοηθός τις λαμβάνει μόνο αν ισχύουν και οι δύο αυτές προϋποθέσεις: ο πελάτης τις αναφέρει ονομαστικά κατά τη σύνδεση και το κλειδί API που επικολλάτε στη σελίδα συγκατάθεσης τις περιέχει. Ένας πελάτης που δεν στέλνει λίστα δικαιωμάτων λαμβάνει τα τέσσερα τυπικά δικαιώματα (Read hiring data, Read candidates, Manage pipeline, Invite candidates) που κατέχει το κλειδί. Δεν λαμβάνει κανένα από αυτά τα δύο δικαιώματα, οπότε ο βοηθός δεν βλέπει τα εργαλεία που τα απαιτούν. Με ένα στατικό κλειδί (επιλογή Β), εμφανίζονται στον βοηθό αυτά τα εργαλεία, ανεξάρτητα από τα δικαιώματα που έχει το κλειδί. Το Flowmingo απορρίπτει κάθε κλήση που δεν επιτρέπεται από το κλειδί.
- Ορισμένες κλήσεις διαρκούν λίγο. Η δημοσίευση περιμένει τον έλεγχο περιεχομένου AI, έως περίπου 90 δευτερόλεπτα. Η δημιουργία ενός έργου ή μιας αξιολόγησης χρησιμοποιεί δημιουργία AI και μπορεί να διαρκέσει περισσότερο (ένα Τεχνικό Τεστ διαρκεί 3 έως 9 λεπτά). Όταν η απάντηση λέει ότι η εργασία είναι ακόμα σε εκκρεμότητα, ο βοηθός καλεί ξανά με το ίδιο κλειδί idempotency για να δει πού έχει φτάσει. Μια επανάληψη δεν δημιουργεί ποτέ δεύτερο έργο ή αξιολόγηση.
| Δυνατότητα | Τι κάνει |
|---|---|
Δημιουργία έργου πρόσληψης (create_project) |
Απαιτεί Create hiring projects (προαιρετική). Δημιουργεί ένα έργο με τα τέσσερα προεπιλεγμένα στάδιά του και μια θέση εργασίας γραμμένη από το ίδιο AI με τον πίνακα ελέγχου, από έναν τίτλο, τη θέση και μια προαιρετική περιγραφή. Από προεπιλογή δημιουργεί επίσης μια Αξιολόγηση Βιογραφικού και μια Συνέντευξη AI· ο βοηθός μπορεί να ονομάσει άλλες αξιολογήσεις ή καμία. Η θέση εργασίας ενεργοποιείται και γίνεται δημόσια μόλις την εγκρίνει ο έλεγχος περιεχομένου AI, συνήθως εντός ενός λεπτού. Περιορίζεται σε 10 έργα ανά λεπτό και 300 ανά ημέρα για την εταιρεία σας. Το κλειδί idempotency είναι προαιρετικό: όταν παραλείπεται, δημιουργείται ένα από τα ορίσματα, οπότε μια επανάληψη δεν δημιουργεί ποτέ δεύτερο έργο. |
Δημιουργία αξιολόγησης (create_assessment) |
Απαιτεί Create assessments (προαιρετική). Δημιουργεί μία αξιολόγηση με το AI: μια Συνέντευξη AI, μια Αξιολόγηση Βιογραφικού, ένα Τεστ Δεξιοτήτων, μια Επίδειξη, ένα Τεχνικό Τεστ ή ένα Role-play, από έναν τίτλο εργασίας και μια προαιρετική περιγραφή εργασίας, όνομα, έργο και γλώσσα (μια ετικέτα όπως en ή vi-VN· ένα Τεστ Δεξιοτήτων και ένα Τεχνικό Τεστ αγνοούν τη γλώσσα). Επισυνάψτε το σε ένα έργο ώστε να μπορούν να προσκληθούν υποψήφιοι σε Τεστ Δεξιοτήτων, Τεχνικό Τεστ ή Επίδειξη. Το κλειδί idempotency είναι προαιρετικό, όπως παραπάνω. |
Δημοσίευση θέσης εργασίας (publish_job_post) |
Απαιτεί Create hiring projects. Ενεργοποιεί τη θέση εργασίας και διασφαλίζει ότι έχει εκτελεστεί ο έλεγχος περιεχομένου AI. Η απάντηση λέει αν η σελίδα είναι ζωντανή τώρα, ακόμα σε αναμονή για τον έλεγχο ή απορριφθείσα από αυτόν. Το έργο πρόσληψης πρέπει να είναι ενεργό. |
Αποδημοσίευση θέσης εργασίας (unpublish_job_post) |
Απαιτεί Create hiring projects. Απενεργοποιεί τη θέση εργασίας, οπότε ο δημόσιος σύνδεσμός της σταματά να ανοίγει. Από προεπιλογή η προώθηση απενεργοποιείται επίσης (withdraw_boost είναι true). |
Προώθηση θέσης εργασίας (boost_job_post) |
Απαιτεί Create hiring projects. Ορίζει την προώθηση σε off, flowmingo ή extended. Η προώθηση είναι δωρεάν. Η αύξηση απαιτεί τη θέση εργασίας ενεργοποιημένη, το έργο της ενεργό, ένα λογότυπο και περιγραφή εταιρείας και τον έλεγχο περιεχομένου AI· μια εταιρεία μπορεί να αυξήσει 50 προωθήσεις ανά ημέρα. |
Άνοιγμα, πρόχειρο ή αρχειοθέτηση έργου (set_project_state) |
Απαιτεί Create hiring projects. Μετακινεί ένα έργο πρόσληψης μεταξύ active, draft και archived. Τα προσχέδια και τα αρχειοθετημένα κλείνουν τον σύνδεσμο θέσης εργασίας. Τα δεδομένα υποψηφίων διατηρούνται. |
Ακύρωση προγραμματισμένης πρόσκλησης (cancel_scheduled_invite) |
Απαιτεί Invite candidates. Ακυρώνει μια πρόσκληση που είχε προγραμματιστεί για αργότερα και δεν έχει σταλεί ακόμα, χρησιμοποιώντας το αναγνωριστικό πρόσκλησης από το αποτέλεσμα πρόσκλησης. Κανείς δεν λαμβάνει email. Το άτομο παραμένει στον λογαριασμό σας και στον πίνακα του έργου. |
Διαγραφή έργου πρόσληψης (delete_project) |
Απαιτεί Create hiring projects (προαιρετική). Ζητά μόνο: δεν διαγράφει αμέσως, ζητά έγκριση σε σύνδεσμο και τίποτα δεν διαγράφεται μέχρι να το εγκρίνει ένας Ιδιοκτήτης ή Διαχειριστής. Μόνο ένα ενεργό έργο μπορεί να διαγραφεί. Αν ένα άτομο το εγκρίνει, το Flowmingo διαγράφει το έργο και τις θέσεις εργασίας του· οι αιτήσεις υποψηφίων δεν διαγράφονται μία προς μία και τα προφίλ και οι επαφές υποψηφίων, οι αξιολογήσεις σας και οι σύνδεσμοι πρόσκλησης διατηρούνται. Δεν υπάρχει αναίρεση. |
Ασφάλεια & εμπιστοσύνη
- Τα δεδομένα σας είναι περιορισμένα στον οργανισμό — ο βοηθός δεν μπορεί ποτέ να δει δεδομένα άλλης εταιρείας.
- Με το OAuth, ο βοηθός δεν λαμβάνει ποτέ το κλειδί API σας. Λαμβάνει ένα διακριτικό πρόσβασης που λήγει μετά από μία ώρα, ανανεώνεται σιωπηλά όσο παραμένει συνδεδεμένος. Η ίδια η σύνδεση διαρκεί όσο το διακριτικό ανανέωσής της, περίπου 30 ημέρες από προεπιλογή από την έκδοση ή την τελευταία ανανέωσή του, οπότε λήγει μετά από περίπου 30 ημέρες χωρίς χρήση και στη συνέχεια συνδέεστε ξανά. Με μια στατική κεφαλίδα (επιλογή Β), ο πελάτης του βοηθού σας κατέχει το κλειδί σας και το στέλνει με κάθε αίτημα, οπότε κρατήστε το μακριά από αρχεία που μπορεί να μοιραστείτε ή να δεσμεύσετε.
- Διακοπή πρόσβασης ενός βοηθού: διαγράψτε το κλειδί API με το οποίο τον εξουσιοδοτήσατε, στο Ρυθμίσεις → Ενσωματώσεις → Κλειδιά API. Η πρόσβαση σταματά αμέσως. Δεν υπάρχει ακόμα αποσύνδεση ανά βοηθό, οπότε αν θέλετε να τα ανακαλέσετε ένα προς ένα, δώστε σε κάθε βοηθό το δικό του κλειδί.
- Τα αιτήματα προς το τελικό σημείο
/mcpελέγχονται για την Προέλευσή τους: μια αδιαφανής προέλευσηnullαπορρίπτεται πάντα και ο έλεγχος μπορεί να κλειδωθεί σε μια λίστα επιτρεπόμενων, αλλά από προεπιλογή κάθε πραγματική προέλευση γίνεται αποδεκτή, οπότε η προστασία είναι το διαπιστευτήριό σας, όχι η προέλευση. Κάθε συνεδρία δεσμεύεται στο διαπιστευτήριο που την άνοιξε.
Για τον τρόπο ελέγχου ταυτότητας, δείτε Έλεγχος ταυτότητας — δύο επιλογές· για τις ακριβείς αναγνώσεις, προστατευμένες εγγραφές και ενέργειες που συμβαίνουν αμέσως, δείτε Τι μπορείτε να κάνετε. Όταν είστε έτοιμοι, μεταβείτε στο Συνδέστε τον βοηθό σας και επιλέξτε τον πελάτη σας.
URL διακομιστή MCP
Συνδέστε τον βοηθό σας
Claude Code (CLI)
Μία εντολή προσθέτει το Flowmingo πάνω από το εγγενές Streamable HTTP. Ξεκινήστε με OAuth· η στατική επιλογή --header είναι η εναλλακτική.
Βήματα: 1) προσθέστε τον διακομιστή, 2) συνδεθείτε (πρόγραμμα περιήγησης → επικολλήστε το κλειδί), 3) εκτελέστε claude mcp list για επαλήθευση.
# 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
Προσοχή: οι επιλογές πρέπει να έρχονται πριν από το όνομα και να χρησιμοποιείτε πάντα --transport http (ποτέ sse). Αντικαταστήστε το fl_YOUR_KEY με το πλήρες κλειδί σας (δείτε Πώς μοιάζει ένα πλήρες κλειδί στην ενότητα Πιστοποίηση παραπάνω).
Επαληθεύστε ότι λειτουργεί — ρωτήστε: "λίστα τις ανοιχτές θέσεις εργασίας μου."
Cursor
Ο στατικός ορισμός είναι ο πιο απλός τρόπος. Ο Cursor υποστηρίζει επίσης OAuth (με Δυναμική Εγγραφή Πελάτη) — για αυτό, αφαιρέστε το μπλοκ headers.
Βήματα: 1) προσθέστε τον διακομιστή στο ~/.cursor/mcp.json (παρακάτω), 2) ορίστε το FLOWMINGO_API_KEY με το πλήρες κλειδί σας στο προφίλ του κελύφους σας, 3) κλείστε τον Cursor και ξεκινήστε τον από ένα τερματικό όπου η μεταβλητή έχει οριστεί, 4) στις Ρυθμίσεις → MCP, κάντε εναλλαγή του διακομιστή σε απενεργοποίηση και πάλι σε ενεργοποίηση για να φορτωθεί εκ νέου.
Ο Cursor πρέπει να μπορεί να δει τη μεταβλητή. Ο Cursor διαβάζει το ${env:FLOWMINGO_API_KEY} από το δικό του περιβάλλον. Αν ξεκινήσει από το Dock ή το μενού Έναρξης, συχνά δεν βλέπει μια μεταβλητή που ορίστηκε στο προφίλ του τερματικού, και τότε ο ορισμός έρχεται κενός ή χωρίς επέκταση και ο διακομιστής απαντά Missing credential. Αν η εκκίνηση του Cursor από τερματικό δεν είναι πρακτική, αντικαταστήστε το ${env:FLOWMINGO_API_KEY} στο αρχείο με το πλήρες κλειδί σας (και κρατήστε το ~/.cursor/mcp.json εκτός git).
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
}
}
}
Εναλλακτικά με OAuth — αφαιρέστε το μπλοκ headers· ο Cursor εκτελεί Δυναμική Εγγραφή Πελάτη και ανοίγει μια σελίδα συγκατάθεσης στο πρόγραμμα περιήγησης κατά την πρώτη σύνδεση:
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp"
}
}
}
Επαληθεύστε ότι λειτουργεί — ρωτήστε: "λίστα των ενεργών θέσεων εργασίας μου."
VS Code (Copilot, agent mode)
Τα εργαλεία εμφανίζονται μόνο στο Copilot Chat → Agent mode. Το βασικό κλειδί είναι servers (όχι mcpServers) και ο τύπος είναι http. Η παρακάτω διαδρομή με προτροπής κλειδιού είναι η αξιόπιστη ρύθμιση.
Βήματα: 1) δημιουργήστε το αρχείο .vscode/mcp.json (ή εκτελέστε MCP: Add Server → HTTP), 2) όταν ξεκινάτε τον διακομιστή, το VS Code σας ζητά το κλειδί σας (δεν γράφεται στο αρχείο), 3) χρησιμοποιήστε το σε Agent mode.
{
"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 μπορεί επίσης να δοκιμάσει OAuth, αλλά η τεκμηριωμένη ρύθμιση OAuth αναμένει ένα ID πελάτη· χρησιμοποιήστε την παραπάνω διαδρομή με προτροπής κλειδιού για μια αξιόπιστη ρύθμιση.
Επαληθεύστε ότι λειτουργεί — ρωτήστε: "list my open jobs."
Claude — claude.ai & Claude Desktop
Και τα δύο χρησιμοποιούν το ίδιο UI Συνδέσμων και την ίδια ροή επικόλλησης διεύθυνσης URL. Μόνο OAuth (δεν υπάρχει πεδίο header στο UI).
Βήματα (web ή desktop):
- Ανοίξτε τις Ρυθμίσεις → Σύνδεσμοι και κάντε κλικ στο Προσθήκη προσαρμοσμένου συνδέσμου.
- Ονομάστε το
Flowmingoκαι επικολλήστε την παραπάνω διεύθυνση URL του διακομιστή MCP. Αφήστε το Προχωρημένες → ID / Μυστικό Πελάτη OAuth κενά. - Κάντε κλικ στο Προσθήκη → Σύνδεση. Στη σελίδα συναίνεσης της Flowmingo, επικολλήστε το κλειδί API
fl_σας και εξουσιοδοτήστε. - Επαληθεύστε — ρωτήστε το 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)
Ομάδα / Επιχείρηση: Ένας Ιδιοκτήτης το προσθέτει μία φορά στις Ρυθμίσεις Οργανισμού → Σύνδεσμοι → Προσαρμοσμένα· οι μέλη κάνουν μετά κλικ στο Σύνδεση.
Χρειάζεστε στατικό κλειδί στο Claude Desktop αντ' αυτού; Χρησιμοποιήστε την καρτέλα Οποιοσδήποτε πελάτης (mcp-remote).
Το πρόγραμμα περιήγησής σας ανοίγει μια σελίδα συναίνεσης Flowmingo κατά την πρώτη σύνδεση — επικολλήστε το κλειδί API σας και εξουσιοδοτήστε. Για να αποσυνδεθείτε αργότερα, διαγράψτε αυτό το κλειδί API στις Ρυθμίσεις → Ενσωματώσεις → Κλειδιά API.
ChatGPT & OpenAI Codex CLI
Και τα δύο είναι OpenAI. Το ChatGPT χρησιμοποιεί τη Λειτουργία Προγραμματιστή για προσαρμοσμένους συνδέσμους (μόνο OAuth); το Codex συνδέεται απευθείας από το CLI.
ChatGPT (web)
- Στο chatgpt.com (Plus / Pro / Business / Enterprise / Edu — όχι σε κινητό), ανοίξτε Ρυθμίσεις → Εφαρμογές → Για προχωρημένους και ενεργοποιήστε τη Λειτουργία προγραμματιστή.
- Εφαρμογές → Δημιουργία → ονομάστε το
Flowmingo, επικολλήστε τη διεύθυνση URL παρακάτω, μεταφορά Streamable HTTP, έλεγχος ταυτότητας OAuth. - Ανοίξτε το προσχέδιο, ενεργοποιήστε τα εργαλεία και κάντε Ανανέωση.
- Επισυνάψτε το μέσω του μενού + σε μια συνομιλία.
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 συνδέεται μόνο με OAuth — δεν δέχεται στατικό x-api-key / προσαρμοσμένη κεφαλίδα API-key. Οι απλοί και βαθιάς έρευνας σύνδεσμοι χρησιμοποιούν μόνο search + fetch (έχετε και τα δύο). Τα εργαλεία εγγραφής (πρόσκληση / μετακίνηση / απόρριψη) απαιτούν Λειτουργία Προγραμματιστή. Ένα μήνυμα που εμφανίζει το ChatGPT πριν εκτελέσει ένα εργαλείο είναι δικό του ChatGPT και δεν αποτελεί έγκριση του Flowmingo: μια πρόσκληση, μια απόρριψη και μια μετακίνηση σε στάδιο που στέλνει email στον υποψήφιο περιμένουν πάντα ένα άτομο να τα εγκρίνει σε έναν σύνδεσμο του Flowmingo.
OpenAI Codex CLI
Δεν χρειάζεται γέφυρα — το Codex μιλάει 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
Επαληθεύστε ότι λειτουργεί — ρωτήστε: "λίστα με τις ανοιχτές θέσεις εργασίας μου."
Gemini CLI & Code Assist
Το Gemini CLI (και η λειτουργία πράκτορα Gemini Code Assist) φτάνουν σε έναν απομακρυσμένο διακομιστή MCP μέσω του ~/.gemini/settings.json. Η εφαρμογή Gemini για καταναλωτές δεν μπορεί να προσθέσει προσαρμοσμένους συνδέσμους MCP — αυτή η διαδρομή είναι μόνο για CLI / Code Assist.
Βήματα: 1) προσθέστε τον διακομιστή κάτω από το mcpServers στο ~/.gemini/settings.json, 2) εξαγάγετε FLOWMINGO_API_KEY=fl_..., 3) εκτελέστε gemini και /mcp για να επιβεβαιώσετε ότι τα εργαλεία παρατίθενται.
{
"mcpServers": {
"flowmingo": {
"httpUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${FLOWMINGO_API_KEY}" },
"timeout": 30000
}
}
}
Το httpUrl επιλέγει εγγενές Streamable HTTP. Το πρότυπο ${FLOWMINGO_API_KEY} επεκτείνεται από το περιβάλλον σας, οπότε κανένα απλό κλειδί δεν γράφεται στο αρχείο. Προτιμάτε OAuth; Το Gemini CLI μπορεί να το κάνει εγγενώς — παραλείψτε το μπλοκ headers και προσθέστε "authProviderType": "dynamic_discovery" στην καταχώρηση του διακομιστή. Το CLI ανιχνεύει την πρόκληση 401, ανακαλύπτει τα μεταδεδομένα OAuth μας και εκτελεί δυναμική εγγραφή πελάτη από μόνο του (χωρίς ID πελάτη για ρύθμιση).
Επαληθεύστε ότι λειτουργεί — στο
gemini, ρωτήστε: "list my open jobs."
Άλλοι πελάτες — Windsurf · Zed · Cline · Continue · Antigravity
Κάθε πελάτης παρακάτω λειτουργεί με τον ίδιο διακομιστή — οι περισσότεροι υποστηρίζουν τόσο OAuth όσο και στατική κεφαλίδα. Τα αποσπάσματα χρησιμοποιούν στατικό κλειδί μέσω μεταβλητής περιβάλλοντος· αφαιρέστε τις headers για να ενεργοποιήσετε το OAuth όπου υποστηρίζεται. Προσέξτε τις παγίδες ονομάτων κλειδιών ανά πελάτη που επισημαίνονται παρακάτω.
Google Antigravity
Προσθέστε το https://mcp.flowmingo.ai/mcp ως απομακρυσμένο διακομιστή MCP και επιλέξτε να το πιστοποιήσετε: ανοίγει μια σελίδα Flowmingo και ζητά το πλήρες κλειδί API σας (δείτε Τι μοιάζει με πλήρες κλειδί στην ενότητα Αυθεντικοποίηση παραπάνω). Κάθε επιφάνεια Antigravity (το IDE, το CLI) συνδέεται ξεχωριστά. Στο mcp_config.json του Antigravity, η διεύθυνση τοποθετείται στο serverUrl, και ένα στατικό κλειδί πηγαίνει σε μπλοκ headers ως Authorization με Bearer και το πλήρες κλειδί σας, όπως στα δικά της παραδείγματα MCP του Antigravity. Δεν έχουμε καταφέρει να δοκιμάσουμε κάθε έκδοση Antigravity, οπότε αν τα μενού σας διαφέρουν από αυτά, ο οδηγός της Google έχει τα τρέχοντα βήματα.
Windsurf (Cascade)
~/.codeium/windsurf/mcp_config.json — Το Windsurf δέχεται serverUrl ή url, και υποστηρίζει OAuth (παραλείψτε τις headers για να το ενεργοποιήσετε).
{ "mcpServers": { "flowmingo": {
"serverUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Zed
~/.config/zed/settings.json — το κλειδί είναι context_servers· παραλείψτε τις headers για εγγενές OAuth. Ορίστε το FLOWMINGO_API_KEY=fl_... στο περιβάλλον σας αντί να επικολλήσετε ακατέργαστο κλειδί.
{ "context_servers": { "flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Cline
MCP Servers → Configure — ορίστε type: "streamableHttp" (camelCase), αλλιώς προεπιλέγεται το νεκρό SSE.
{ "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 — συνδεθείτε μέσω της γέφυρας mcp-remote. Ορίστε 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 }}"]
Επαληθεύστε ότι λειτουργεί — ρωτήστε: "λίστα με τις ανοιχτές θέσεις εργασίας μου."
Οποιοσδήποτε πελάτης (mcp-remote)
Για οποιονδήποτε πελάτη μόνο stdio (ή μελλοντικό πελάτη χωρίς εγγενή απομακρυσμένο transport), συνδέστε με το Flowmingo μέσω της εντολής stdio mcp-remote. Απαιτείται το --transport http-only — ο διακομιστής δεν υποστηρίζει SSE.
Βήματα: 1) βεβαιωθείτε ότι έχετε Node ≥ 18, 2) εκτελέστε τη γέφυρα ως εντολή stdio στον πελάτη σας, 3) στην πρώτη εκτέλεση OAuth ανοίγει το πρόγραμμα περιήγησης — επικολλήστε το κλειδί σας.
# 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" }
}
}
}
Διάσωση: αν η πιστοποίηση κολλήσει, εκτελέστε rm -rf ~/.mcp-auth και δοκιμάστε ξανά. Αντικαταστήστε το fl_YOUR_KEY με το πλήρες κλειδί σας (δείτε Πώς μοιάζει ένα πλήρες κλειδί στην ενότητα Πιστοποίηση παραπάνω). Σε ένα args[] JSON, αποφύγετε το κενό μετά την άνω κάτω τελεία της κεφαλίδας (ιδιαιτερότητα διαφυγής npx).
Επαληθεύστε ότι λειτουργεί — ρωτήστε: "λίστα με τις ανοιχτές θέσεις εργασίας μου."