Übersicht
Verbinden Sie jeden MCP-kompatiblen KI-Assistenten mit Ihren Flowmingo-Einstellungsdaten – lesen Sie Ihre Jobs und Kandidaten und führen Sie geschützte Aktionen durch (einladen, verschieben, ablehnen, aus einem Projekt entfernen), sicher und mit Ihrer Erlaubnis. Mit zwei zusätzlichen Berechtigungen, die Sie selbst aktivieren, kann ein Assistent auch Einstellungsprojekte und Bewertungen erstellen sowie eine Stellenanzeige veröffentlichen, schließen oder bewerben (siehe Was Sie tun können). Neu bei MCP? Es ist der offene Standard, der es KI-Assistenten ermöglicht, mit Tools wie Flowmingo zu kommunizieren. Erfahren Sie, was MCP ist.
Transport: Streamable HTTP (der moderne Remote-Transport). Es gibt kein Legacy-SSE – richten Sie Ihren Client immer an /mcp, nie an /sse.
Behandeln Sie Ihren API-Schlüssel wie ein Passwort. Bevorzugen Sie OAuth, eine Eingabeaufforderung oder eine Umgebungsvariable gegenüber dem Einfügen eines rohen
fl_...-Schlüssels in eine Datei, die Sie möglicherweise in git committen (z. B..vscode/mcp.json,~/.cursor/mcp.json, Ihre Continue-Konfiguration).
Authentifizierung – zwei Optionen
A – Mit Flowmingo anmelden (OAuth, empfohlen). Ihr Browser öffnet eine Flowmingo-Zustimmungsseite; Sie fügen dort Ihren API-Schlüssel ein. Der Assistent erhält Ihren rohen Schlüssel nie. Er erhält ein Zugriffstoken und ein Aktualisierungstoken, mit denen er ein neues Zugriffstoken erhalten kann. Die Anmeldung hält nicht ewig. Das Aktualisierungstoken ist standardmäßig etwa 30 Tage gültig, gerechnet ab seiner Ausstellung, bei der Anmeldung oder der letzten Aktualisierung. Eine Anmeldung, die etwa so lange ungenutzt bleibt, verfällt, und eine Flowmingo-Version, die die Speicherung von Anmeldungen ändert, kann ebenfalls eine erneute Anmeldung erfordern. Der Assistent fordert Sie dann erneut zur Anmeldung auf, und Sie fügen Ihren Schlüssel erneut ein. Um es früher zu beenden, löschen Sie diesen API-Schlüssel. Es gibt keine Client-ID oder kein Secret zu erstellen (Flowmingo verwendet Dynamic Client Registration). Bei Clients, die „Erweiterte“ OAuth-Einstellungen anzeigen (z. B. Claude.ai), lassen Sie die Client-ID und das Secret leer.
B – Statischer API-Schlüssel (Header). Senden Sie Ihren Schlüssel als einen der folgenden Header:
x-api-key: fl_YOUR_KEY
Authorization: Bearer fl_YOUR_KEY
Holen Sie Ihren Schlüssel unter Flowmingo → Einstellungen → Integrationen → API-Schlüssel. Aktivieren Sie Read hiring data und Read candidates – das erste deckt Jobs, Pipeline und Ergebnisse ab, das zweite ermöglicht es einem Assistenten, jemanden nachzuschlagen. Fügen Sie Manage pipeline / Invite candidates für die geschützten Schreibaktionen hinzu. Damit ein Assistent Projekte und Bewertungen erstellen sowie eine Stellenanzeige veröffentlichen oder bewerben kann, aktivieren Sie auch Create hiring projects und Create assessments. Lesen Sie zuerst Erstellen und veröffentlichen unter „Was Sie tun können“: Diese beiden Berechtigungen sind optional, und der Ersteller des Schlüssels muss ein Eigentümer oder ein Administrator sein.
Wie ein vollständiger Schlüssel aussieht. Ein langer Wert: fl_live_, der öffentliche Name des Schlüssels, ein Punkt, dann ein langes Secret. Die Secret-Hälfte wird einmal angezeigt, direkt nachdem Sie den Schlüssel erstellt haben; später zeigt die API-Schlüssel-Liste nur den Anfang. Ein Wert ohne Punkt ist nur der Name des Schlüssels und wird abgelehnt. Überall dort, wo dieser Leitfaden fl_YOUR_KEY schreibt, ersetzen Sie alles davon durch Ihren vollständigen Schlüssel, ohne Anführungszeichen und ohne Leerzeichen.
Wenn keine Verbindung hergestellt werden kann. Ein falscher oder leerer Schlüssel wird als Missing credential oder The Flowmingo API key was rejected zurückgegeben; beide können bedeuten, dass der Wert nie vollständig bei uns angekommen ist, also überprüfen Sie zuerst den Wert. Eine Einstellung wie ${env:FLOWMINGO_API_KEY} funktioniert nur, wenn das Programm diese Variable sehen kann, und ein Editor, der vom Dock oder aus dem Startmenü geöffnet wird, liest Ihr Terminalprofil oft nicht. Starten Sie es entweder aus einem Terminal, in dem die Variable gesetzt ist, oder fügen Sie Ihren vollständigen Schlüssel in die Datei ein (und halten Sie diese Datei aus git heraus).
Welche Option wählen? Die meisten Clients unterstützen beide; einige (z. B. ChatGPT) sind nur OAuth – jede Registerkarte notiert, was dieser Client unterstützt. Im Allgemeinen eignet sich OAuth für interaktive Assistenten (Claude.ai, ChatGPT, VS Code); der API-Schlüssel-Header eignet sich für CLIs, Headless/CI und Editoren, bei denen Sie lieber einen Schlüssel einfügen.
Was Sie tun können
Lesezugriffe benötigen keine Genehmigung. Die meisten Schreibvorgänge sind geschützt. Eine Einladung, eine Ablehnung mit der Aktion „Ablehnen“, eine Entfernung von Kandidaten aus einem Projekt, eine Löschung eines Projekts oder normalerweise eine Verschiebung in eine Phase, die so eingestellt ist, dass sie den Kandidaten per E-Mail benachrichtigt, wartet auf eine Person, die sie über einen Link genehmigt, angemeldet bei Flowmingo. Der Assistent kann dies nicht genehmigen, und ein „Ja“ im Chat zählt nicht. Die E-Mail-Einstellung der Phase wird zum Zeitpunkt der Anforderung der Verschiebung geprüft. Bei einer Notiz, einer Bewertung, einer Shortlist, einem Tag oder einer Verschiebung in eine Phase, die nicht so eingestellt ist, dass sie den Kandidaten per E-Mail benachrichtigt, wird der Assistent angewiesen, Ihnen zuerst eine Vorschau zu zeigen und nur fortzufahren, wenn Sie zustimmen. Dies ist eine Anweisung an ihn, keine Sperre. Eine Aufforderung, die Ihr KI-Client vor der Ausführung eines Tools anzeigt, ist die des Clients und nicht die Genehmigung von Flowmingo: Eine Einladung, eine Ablehnung mit der Aktion „Ablehnen“ und eine Verschiebung in eine E-Mail-Phase warten immer noch auf den Genehmigungslink, was auch immer der Client fragt. Ein Genehmigungslink läuft nach 15 Minuten ab, und eine Anforderung für mehrere Kandidaten oder Bewerbungen (maximal 50) ist eine Genehmigung, die alle auflistet. Sobald eine Änderung gestuft ist, kann der Assistent den Status überprüfen, sie zurückziehen, solange sie noch wartet, und eine reversible Änderung (eine Notiz, eine Bewertung, eine Shortlist-Markierung, ein Tag oder eine Verschiebung, die niemanden per E-Mail benachrichtigt hat) innerhalb von 24 Stunden rückgängig machen. Ein Rückgängigmachen ist nicht immer verfügbar: Die Änderung muss mit einer Undo-Referenz zurückkommen, deren Aufzeichnung nach bestem Bemühen erfolgt, und eine Verschiebung für einen Kandidaten ohne frühere Phase hat keine, daher sollte der Assistent dies überprüfen und sagen, wenn es keinen Weg zurück gibt. Eine gesendete E-Mail kann nicht rückgängig gemacht werden. Die unter Erstellen und veröffentlichen aufgeführten Tools sind die Ausnahme von all dem, außer delete_project: Sie wirken sofort und werden nicht zur Genehmigung gestuft. Eine Entfernung und eine Projektlöschung können nicht rückgängig gemacht werden. Alles ist auf Ihre Organisation beschränkt.
Lesen
| Fähigkeit | Was sie tut |
|---|---|
| Stellenanzeigen auflisten | Durchsuchen Sie die offenen und geschlossenen Rollen Ihrer Organisation. |
| Interview-Sets & Projekte auflisten | Sehen Sie Ihre Bewertungen (Interview-Sets) aller Art (KI-Interviews, Rollenspiele, Fähigkeitstests, technische Tests, CV-Bewertungen, Showcases und Aufzeichnungen; Fragebögen, wenn Sie danach fragen) und Ihre Einstellungsprojekte. |
| Kandidaten-Pipeline auflisten | Bewerbungen nach Phase über ein Projekt anzeigen. |
| Bewertungsergebnisse & -werte lesen | Ergebnisse jeder Art abrufen: KI-Interviews, Rollenspiele, Fähigkeitstests, technische Tests, CV-Bewertungen, Showcases, Aufzeichnungen und Fragebögen. Jedes Ergebnis ist mit seiner Art gekennzeichnet. Nur einige Arten tragen eine KI-Bewertung: Ein Showcase und ein Fragebogen werden nie bewertet, und ein Fähigkeitstest ist ein Prozentsatz. |
| Kandidaten nachschlagen | Name, E-Mail und CV eines Kandidaten abrufen. |
| Kandidaten suchen | Kandidaten nach Name oder E-Mail finden. |
| Kandidaten vergleichen | 2 bis 10 Kandidaten nebeneinander anordnen. Benötigt die Read candidates-Berechtigung sowie Read hiring data. |
| Einstellungsübersicht | Der Trichter für alles, was Ihre Verbindung erreichen kann (das gesamte Unternehmen, es sei denn, der Schlüssel wurde von jemandem erstellt, der auf einige Projekte beschränkt ist), oder eingegrenzt, wenn Sie fragen: Bewerbungen pro Phase, aktiv vs. abgelehnt, und für jede Art von Bewertung, die Ergebnisse hat, abgeschlossene vs. laufende Ergebnisse und die Durchschnittsbewertung. Ein Projekt grenzt jede Zählung ein, aber seine Ergebnisszählungen decken die Ergebnisse der mit diesem Projekt verknüpften Bewertungen ab, sodass ein Kandidat eines anderen Projekts, das eine dieser Bewertungen teilt, mitgezählt werden kann. Eine Bewertung grenzt nur die Ergebnisszählungen ein: Die Phasen- und Bewerbungszählungen bleiben bei allem, was Ihre Verbindung erreichen kann. Die Arten werden nie addiert. |
| Top-Kandidaten | Die am höchsten bewerteten Ergebnisse, geordnet nach Gesamtwertung. Jede Art von Bewertung wird zusammen eingestuft, es sei denn, Sie fragen nach einer Art oder nach einer Bewertung (Interview-Set). |
| Bewertungsergebnis-Detail | Die Bewertungen pro Kompetenz eines Ergebnisses plus die KI-Zusammenfassung, für die Arten, die sie haben. Ein Fähigkeitstest, ein technischer Test, ein Showcase und ein Fragebogen haben wenig oder keine. |
| Stellenanzeigen-Detail | Die vollständigen Details einer einzelnen Stellenanzeige. |
Ist eine Stellenanzeige öffentlich? (get_job_post_publication) |
Ob jemand die öffentliche Seite einer Stellenanzeige öffnen kann: live, noch auf die KI-Inhaltsprüfung wartend, von ihr abgelehnt, markiert, ausgeschaltet, oder ihr Projekt ist nicht offen. Auch ihre öffentliche Adresse und ihre Bewerbung (aus, Flowmingo oder erweitert). Benötigt Read hiring data. |
| Bevorstehende Interviews | Einladungen zu jeder Art von Bewertung, die gesendet oder geplant und noch nicht abgeschlossen sind. Es ist keine Zählung aller noch offenen: Eine Einladung, deren Kandidat erinnert wurde, den Link geöffnet oder geklickt hat, wird weggelassen, bis der Kandidat beginnt, und auch eine, die nicht zugestellt werden konnte. |
Schreiben (geschützt)
| Fähigkeit | Was sie tut |
|---|---|
| Kandidaten zu einer Bewertung einladen | Bereitet die Einladungen für ein KI-Interview, ein Rollenspiel, einen Fähigkeitstest oder einen technischen Test vor und wartet auf eine Person, die sie über einen Link genehmigt. Vorher wird nichts gesendet. Eine Bewertung und höchstens 50 Kandidaten pro Anfrage; ein Fähigkeitstest oder ein technischer Test benötigt ein Projekt und eine E-Mail für jeden Kandidaten, und ein gesponserter kann das Wallet Ihrer Organisation belasten, wenn ein Kandidat ihn beginnt. |
| Kandidaten in eine andere Phase verschieben | Eine Verschiebung in eine Phase, die so eingestellt ist, dass sie den Kandidaten per E-Mail benachrichtigt, wartet normalerweise auf eine Person, die sie über einen Link genehmigt (die E-Mail-Einstellung der Phase wird einmal gelesen, kurz vor der Verschiebung, sodass eine Einstellung, die in diesem Moment eingeschaltet wird, eine Verschiebung ohne Genehmigung per E-Mail senden kann). Jede andere Verschiebung: Der Assistent wird angewiesen, eine Vorschau zu zeigen und auf Ihr Ja zu warten, und sie kann normalerweise 24 Stunden lang rückgängig gemacht werden, wenn sie mit einer Undo-Referenz zurückkam. Höchstens 50 Bewerbungen pro Anfrage. |
| Bewerbung ablehnen | Fordert Genehmigung über einen Link an. Wenn eine Person sie genehmigt, versucht Flowmingo, die Bewerbung in die abgelehnte Phase des Projekts zu verschieben; überprüfen Sie das Ergebnis danach. Höchstens 50 Bewerbungen pro Anfrage. |
Kandidaten aus einem Projekt entfernen (remove_application) |
Benötigt Manage pipeline. Fordert Genehmigung über einen Link an. Wenn eine Person sie genehmigt, löscht Flowmingo die Bewerbungen aus dem Projekt; das Kandidatenprofil bleibt in Ihrem Talentpool und in anderen Projekten. Es ist keine Ablehnung, und es gibt kein Rückgängigmachen. Höchstens 50 Bewerbungen pro Anfrage. |
| Notiz zu einem Ergebnis hinzufügen | Der Assistent wird angewiesen, die vorgeschlagene Notiz in der Vorschau zu zeigen und auf Ihr Ja zu warten, bevor er sie speichert. Eine Notiz gehört zu einem Bewertungsergebnis (jeder Art), nicht zum Kandidaten als Ganzes. |
| Ergebnis bewerten | Der Assistent wird angewiesen, die Bewertung in der Vorschau zu zeigen und auf Ihr Ja zu warten. Die Bewertung gilt für ein Bewertungsergebnis. |
| Ergebnis auf die Shortlist setzen | Der Assistent wird angewiesen, die Shortlist-Änderung in der Vorschau zu zeigen und auf Ihr Ja zu warten. Sie gilt für ein Bewertungsergebnis. |
| Tag / zu Talentkollektion hinzufügen | Der Assistent wird angewiesen, die Tag- oder Talentkollektions-Änderung in der Vorschau zu zeigen und auf Ihr Ja zu warten. |
| Änderung überprüfen, zurückziehen oder rückgängig machen | Überprüfen Sie den Status einer gestuften Änderung (wartend, ausgeführt, fehlgeschlagen, abgelaufen oder durch eine neuere Anfrage ersetzt), ziehen Sie eine zurück, die noch auf Genehmigung wartet, oder machen Sie eine reversible Änderung innerhalb von 24 Stunden rückgängig, wenn sie mit einer Undo-Referenz zurückkam. |
Erstellen und veröffentlichen (wirkt sofort, außer beim Löschen eines Projekts)
Diese Tools erstellen Dinge und machen sie öffentlich. Sie verhalten sich anders als die oben genannten geschützten Schreibvorgänge:
- Sie wirken sofort, außer
delete_project. Nichts wird zur Genehmigung durch eine Person über einen Link gestuft, und keines davon sendet eine E-Mail an einen Kandidaten.delete_projectwartet auf die Genehmigung durch einen Eigentümer oder Administrator über einen Link. - Der Ersteller des Schlüssels muss ein Eigentümer oder Administrator sein, für jedes Tool hier außer dem Abbrechen, das nur Invite candidates benötigt. Die Tools handeln mit den Berechtigungen der Person, die den API-Schlüssel erstellt hat. Wenn diese Person ein Mitglied ist, wird der Aufruf abgelehnt.
- Zwei Berechtigungen sind optional. Create hiring projects und Create assessments werden standardmäßig nicht erteilt. Bei der Anmeldung (Option A) erhält der Assistent sie nur, wenn beides zutrifft: Der Client listet sie beim Verbinden namentlich auf, und der API-Schlüssel, den Sie auf der Zustimmungsseite einfügen, enthält sie. Ein Client, der keine Liste von Berechtigungen sendet, erhält die vier Standardberechtigungen (Read hiring data, Read candidates, Manage pipeline, Invite candidates), die der Schlüssel enthält, und keine dieser beiden, sodass der Assistent die Tools, die sie benötigen, nicht sieht. Mit einem statischen Schlüssel (Option B) werden dem Assistenten diese Tools unabhängig von den Berechtigungen des Schlüssels angezeigt, und Flowmingo lehnt jeden Aufruf ab, den der Schlüssel nicht erlaubt.
- Einige Aufrufe dauern eine Weile. Die Veröffentlichung wartet auf die KI-Inhaltsprüfung, bis zu etwa 90 Sekunden. Das Erstellen eines Projekts oder einer Bewertung verwendet KI-Generierung und kann länger dauern (ein technischer Test dauert 3 bis 9 Minuten). Wenn die Antwort sagt, dass die Arbeit noch aussteht, ruft der Assistent erneut mit demselben Idempotenzschlüssel auf, um zu lesen, wo sie angekommen ist. Ein erneuter Versuch erstellt nie ein zweites Projekt oder eine zweite Bewertung.
| Fähigkeit | Was sie tut |
|---|---|
Einstellungsprojekt erstellen (create_project) |
Benötigt Create hiring projects (optional). Erstellt ein Projekt mit seinen vier Standardphasen und einer Stellenanzeige, die von derselben KI wie das Dashboard geschrieben wird, aus einem Titel, der Position und einer optionalen Beschreibung. Standardmäßig erstellt es auch eine CV-Bewertung und ein KI-Interview; der Assistent kann andere Bewertungen nennen oder keine. Die Stellenanzeige ist eingeschaltet und wird öffentlich, sobald die KI-Inhaltsprüfung sie genehmigt, normalerweise innerhalb einer Minute. Begrenzt auf 10 Projekte pro Minute und 300 pro Tag für Ihr Unternehmen. Der Idempotenzschlüssel ist optional: Wenn er weggelassen wird, wird einer aus den Argumenten erstellt, sodass ein erneuter Versuch nie ein zweites Projekt erstellt. |
Bewertung erstellen (create_assessment) |
Benötigt Create assessments (optional). Erstellt eine Bewertung mit der KI: ein KI-Interview, eine CV-Bewertung, einen Fähigkeitstest, einen Showcase, einen technischen Test oder ein Rollenspiel, aus einem Jobtitel und einer optionalen Jobbeschreibung, Name, Projekt und Sprache (ein Tag wie en oder vi-VN; ein Fähigkeitstest und ein technischer Test ignorieren die Sprache). Hängen Sie es an ein Projekt an, damit Kandidaten zu einem Fähigkeitstest, einem technischen Test oder einem Showcase eingeladen werden können. Der Idempotenzschlüssel ist optional, wie oben. |
Stellenanzeige veröffentlichen (publish_job_post) |
Benötigt Create hiring projects. Schaltet die Stellenanzeige ein und stellt sicher, dass die KI-Inhaltsprüfung ausgeführt wurde. Die Antwort sagt, ob die Seite jetzt live ist, noch auf die Prüfung wartet oder von ihr abgelehnt wurde. Das Einstellungsprojekt muss aktiv sein. |
Stellenanzeige zurückziehen (unpublish_job_post) |
Benötigt Create hiring projects. Schaltet die Stellenanzeige aus, sodass ihr öffentlicher Link nicht mehr öffnet. Standardmäßig wird auch die Bewerbung ausgeschaltet (withdraw_boost ist true). |
Stellenanzeige bewerben (boost_job_post) |
Benötigt Create hiring projects. Setzt die Bewerbung auf off, flowmingo oder extended. Bewerbung ist kostenlos. Das Erhöhen erfordert, dass die Stellenanzeige eingeschaltet ist, ihr Projekt aktiv ist, ein Firmenlogo und eine Beschreibung vorhanden sind und die KI-Inhaltsprüfung bestanden wurde; ein Unternehmen kann 50 Bewerbungen pro Tag erhöhen. |
Projekt öffnen, entwerfen oder archivieren (set_project_state) |
Benötigt Create hiring projects. Verschiebt ein Einstellungsprojekt zwischen active, draft und archived. Entwurf und Archiviert schließen den Job-Link. Kandidatendaten werden aufbewahrt. |
Geplante Einladung abbrechen (cancel_scheduled_invite) |
Benötigt Invite candidates. Bricht eine Einladung ab, die für später geplant und noch nicht gesendet wurde, unter Verwendung der Einladungs-ID aus dem Einladungsergebnis. Niemand wird per E-Mail benachrichtigt. Die Person bleibt in Ihrem Konto und auf der Projektübersicht. |
Einstellungsprojekt löschen (delete_project) |
Benötigt Create hiring projects (optional). Es fragt nur: Es löscht nicht sofort, es fordert Genehmigung über einen Link an, und nichts wird gelöscht, bis ein Eigentümer oder Administrator es genehmigt. Nur ein aktives Projekt kann gelöscht werden. Wenn eine Person es genehmigt, löscht Flowmingo das Projekt und seine Stellenanzeigen; seine Kandidatenbewerbungen werden nicht einzeln gelöscht, und Kandidatenprofile und Kontakte, Ihre Bewertungen und Einladungslinks werden aufbewahrt. Es gibt kein Rückgängigmachen. |
Sicherheit & Vertrauen
- Ihre Daten sind org-beschränkt – der Assistent kann nie die Daten eines anderen Unternehmens sehen.
- Mit OAuth erhält der Assistent nie Ihren API-Schlüssel. Er erhält ein Zugriffstoken, das nach einer Stunde abläuft und leise aktualisiert wird, solange die Verbindung besteht. Die Anmeldung selbst dauert so lange wie ihr Aktualisierungstoken, standardmäßig etwa 30 Tage ab Ausstellung oder letzter Aktualisierung, sodass sie nach etwa 30 Tagen ohne Nutzung verfällt und Sie sich dann erneut anmelden. Mit einem statischen Header (Option B) hält der Client Ihres Assistenten Ihren Schlüssel und sendet ihn mit jeder Anfrage, also halten Sie ihn aus Dateien heraus, die Sie möglicherweise teilen oder committen.
- Assistent abtrennen: Löschen Sie den API-Schlüssel, mit dem Sie ihn autorisiert haben, unter Einstellungen → Integrationen → API-Schlüssel. Der Zugriff stoppt sofort. Es gibt noch keine Trennung pro Assistent. Wenn Sie sie also einzeln widerrufen möchten, geben Sie jedem Assistenten seinen eigenen Schlüssel.
- Anfragen an den
/mcp-Endpunkt werden auf ihre Herkunft überprüft: Ein undurchsichtigernull-Ursprung wird immer abgelehnt, und die Prüfung kann auf eine Whitelist beschränkt werden, aber standardmäßig wird jeder echte Ursprung akzeptiert. Der Schutz ist also Ihre Anmeldeinformation, nicht der Ursprung. Jede Sitzung ist an die Anmeldeinformation gebunden, die sie geöffnet hat.
Informationen zur Authentifizierung finden Sie unter Authentifizierung – zwei Optionen; für die genauen Lesezugriffe, geschützten Schreibvorgänge und Aktionen, die sofort stattfinden, siehe Was Sie tun können. Wenn Sie bereit sind, springen Sie zu Verbinden Sie Ihren Assistenten und wählen Sie Ihren Client.
MCP-Server-URL
Verbinden Sie Ihren Assistenten
Claude Code (CLI)
Ein Befehl fügt Flowmingo über nativen Streamable HTTP hinzu. Führen Sie zuerst OAuth aus; der statische --header ist die Alternative.
Schritte: 1) Server hinzufügen, 2) Anmelden (Browser → Schlüssel einfügen), 3) claude mcp list zur Überprüfung.
# 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
Achtung: Flags müssen vor dem Namen stehen, und verwenden Sie immer --transport http (niemals sse). Ersetzen Sie fl_YOUR_KEY durch Ihren vollständigen Schlüssel (siehe Wie ein vollständiger Schlüssel aussieht im Abschnitt Authentifizierung oben).
Verifizieren Sie, dass es funktioniert — fragen Sie: "Liste meine offenen Stellen auf."
Cursor
Der statische Header ist der einfachste Weg. Cursor kann auch OAuth verwenden (es unterstützt Dynamic Client Registration) – dazu entfernen Sie den headers-Block.
Schritte: 1) Fügen Sie den Server zu ~/.cursor/mcp.json hinzu (siehe unten), 2) setzen Sie FLOWMINGO_API_KEY auf Ihren vollständigen Schlüssel in Ihrem Shell-Profil, 3) beenden Sie Cursor und starten Sie es aus einem Terminal, in dem die Variable gesetzt ist, 4) schalten Sie in Einstellungen → MCP den Server aus und wieder ein, um ihn neu zu laden.
Cursor muss die Variable sehen können. Cursor liest ${env:FLOWMINGO_API_KEY} aus seiner eigenen Umgebung. Wenn es vom Dock oder Startmenü gestartet wird, sieht es oft keine Variable, die in Ihrem Terminal-Profil gesetzt ist, und dann kommt der Header leer oder unexpandiert an und der Server antwortet mit Missing credential. Wenn das Starten von Cursor aus einem Terminal nicht praktikabel ist, ersetzen Sie ${env:FLOWMINGO_API_KEY} in der Datei durch Ihren vollständigen Schlüssel (und halten Sie ~/.cursor/mcp.json aus git heraus).
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
}
}
}
Stattdessen OAuth – entfernen Sie den headers-Block; Cursor führt Dynamic Client Registration aus und öffnet beim ersten Verbinden eine Browser-Zustimmungsseite:
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp"
}
}
}
Überprüfen Sie, ob es funktioniert – fragen Sie: "Listen Sie meine offenen Stellen auf."
VS Code (Copilot, Agentenmodus)
Tools erscheinen nur im Copilot Chat → Agentenmodus. Der Root-Schlüssel ist servers (nicht mcpServers) und der Typ ist http. Der Pfad mit der aufgeforderten Eingabe unten ist die zuverlässige Einrichtung.
Schritte: 1) Erstellen Sie .vscode/mcp.json (oder führen Sie MCP: Server hinzufügen → HTTP aus), 2) Wenn Sie den Server starten, fordert VS Code Ihren Schlüssel an (er wird nicht in die Datei geschrieben), 3) Verwenden Sie ihn im Agentenmodus.
{
"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 kann auch OAuth versuchen, aber die dokumentierte OAuth-Konfiguration erwartet eine Client-ID; verwenden Sie den Pfad mit der aufgeforderten Eingabe oben für eine zuverlässige Einrichtung.
Überprüfen Sie, ob es funktioniert — fragen Sie: "liste meine offenen Stellenangebote auf."
Claude — claude.ai & Claude Desktop
Beide verwenden dieselbe Connectors-Benutzeroberfläche und denselben Flow zum Einfügen der URL. Nur OAuth (es gibt kein Header-Feld in der Benutzeroberfläche).
Schritte (Web oder Desktop):
- Öffnen Sie Einstellungen → Konnektoren und klicken Sie auf Benutzerdefinierten Konnektor hinzufügen.
- Nennen Sie ihn
Flowmingound fügen Sie die MCP-Server-URL oben ein. Lassen Sie Erweitert → OAuth-Client-ID / Secret leer. - Klicken Sie auf Hinzufügen → Verbinden. Fügen Sie auf der Flowmingo-Zustimmungsseite Ihren
fl_-API-Schlüssel ein und autorisieren Sie. - Überprüfen Sie — fragen Sie Claude: "liste meine offenen Stellenangebote auf."
Remote MCP server URL: https://mcp.flowmingo.ai/mcp
Advanced → OAuth Client ID / Secret: (leave blank — Flowmingo uses Dynamic Client Registration)
Team / Enterprise: Ein Besitzer fügt ihn einmal unter Organisationseinstellungen → Konnektoren → Benutzerdefiniert hinzu; Mitglieder klicken dann auf Verbinden.
Benötigen Sie stattdessen einen statischen Schlüssel auf Claude Desktop? Verwenden Sie die Registerkarte Jeder Client (mcp-remote).
Ihr Browser öffnet bei der ersten Verbindung eine Flowmingo-Zustimmungsseite – fügen Sie Ihren API-Schlüssel ein und autorisieren Sie. Um die Verbindung später zu trennen, löschen Sie diesen API-Schlüssel unter Einstellungen → Integrationen → API-Schlüssel.
ChatGPT & OpenAI Codex CLI
Beides sind OpenAI-Produkte. ChatGPT verwendet den Entwicklermodus für benutzerdefinierte Konnektoren (nur OAuth); Codex verbindet nativ über die CLI.
ChatGPT (Web)
- Öffnen Sie auf chatgpt.com (Plus / Pro / Business / Enterprise / Edu — nicht mobil) Einstellungen → Apps → Erweitert und aktivieren Sie den Entwicklermodus.
- Apps → Erstellen → Name
Flowmingo, fügen Sie die URL unten ein, Transport Streamable HTTP, Authentifizierung OAuth. - Öffnen Sie den Entwurf, aktivieren Sie die Tools und klicken Sie auf Aktualisieren.
- Fügen Sie es über das +-Menü in einem Chat hinzu.
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)
Der Entwicklermodus von ChatGPT verbindet sich nur über OAuth — er akzeptiert keinen statischen x-api-key / benutzerdefinierten API-Key-Header. Einfache und Deep-Research-Konnektoren verwenden nur search + fetch (beide haben Sie). Schreibtools (Einladen / Verschieben / Ablehnen) erfordern den Entwicklermodus. Ein Hinweis, den ChatGPT vor der Ausführung eines Tools anzeigt, stammt von ChatGPT selbst und ist keine Genehmigung von Flowmingo: Eine Einladung, eine Ablehnung und eine Verschiebung in eine Phase, die den Kandidaten per E-Mail benachrichtigt, warten immer auf die Freigabe durch eine Person über einen Flowmingo-Link.
OpenAI Codex CLI
Keine Brücke erforderlich — Codex spricht 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
Stellen Sie sicher, dass es funktioniert — fragen Sie: "Listen Sie meine offenen Stellen auf."
Gemini CLI & Code Assist
Die Gemini CLI (und der Gemini Code Assist Agent-Modus) greifen über ~/.gemini/settings.json auf einen entfernten MCP-Server zu. Die normale Gemini-App kann keine benutzerdefinierten MCP-Konnektoren hinzufügen — dieser Pfad ist nur für CLI / Code Assist.
Schritte: 1) Server unter mcpServers in ~/.gemini/settings.json hinzufügen, 2) FLOWMINGO_API_KEY=fl_... exportieren, 3) gemini ausführen und /mcp eingeben, um zu bestätigen, dass die Tools aufgelistet sind.
{
"mcpServers": {
"flowmingo": {
"httpUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${FLOWMINGO_API_KEY}" },
"timeout": 30000
}
}
}
httpUrl wählt native Streamable HTTP. Der Platzhalter ${FLOWMINGO_API_KEY} wird aus Ihrer Umgebung erweitert, sodass kein roher Schlüssel in die Datei geschrieben wird. Bevorzugen Sie OAuth? Gemini CLI kann dies nativ tun — lassen Sie den headers-Block weg und fügen Sie "authProviderType": "dynamic_discovery" zum Server-Eintrag hinzu. Die CLI erkennt die 401-Herausforderung, entdeckt unsere OAuth-Metadaten und führt die dynamische Client-Registrierung selbst durch (keine Client-ID einzustellen).
Überprüfen Sie, ob es funktioniert — fragen Sie in
gemini: "liste meine offenen Stellenangebote auf."
Andere Clients — Windsurf · Zed · Cline · Continue · Antigravity
Jeder unten aufgeführte Client funktioniert mit demselben Server — die meisten unterstützen sowohl OAuth als auch einen statischen Header. Die Codeausschnitte verwenden einen statischen Schlüssel über eine Umgebungsvariable; entfernen Sie die headers, damit ein Client OAuth ausführt, wenn er dies unterstützt. Beachten Sie die unten genannten client-spezifischen Schlüsselnamen-Fallen.
Google Antigravity
Fügen Sie https://mcp.flowmingo.ai/mcp als Remote-MCP-Server hinzu und wählen Sie die Authentifizierung: Eine Flowmingo-Seite öffnet sich und fragt nach Ihrem vollständigen API-Schlüssel (siehe Wie ein vollständiger Schlüssel aussieht im Abschnitt Authentifizierung oben). Jede Antigravity-Oberfläche (die IDE, die CLI) meldet sich separat an. In der mcp_config.json von Antigravity wird die Adresse unter serverUrl eingetragen, und ein statischer Schlüssel kommt in einen headers-Block als Authorization mit Bearer und Ihrem vollständigen Schlüssel, wie in Googles eigenen Antigravity-MCP-Beispielen. Wir konnten nicht jede Antigravity-Version testen. Wenn sich Ihre Menüs davon unterscheiden, finden Sie in Googles Anleitung die aktuellen Schritte.
Windsurf (Cascade)
~/.codeium/windsurf/mcp_config.json — Windsurf akzeptiert serverUrl oder url und unterstützt OAuth (lassen Sie headers weg, um es auszulösen).
{ "mcpServers": { "flowmingo": {
"serverUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Zed
~/.config/zed/settings.json — der Schlüssel ist context_servers; lassen Sie headers für natives OAuth weg. Setzen Sie FLOWMINGO_API_KEY=fl_... in Ihrer Umgebung, anstatt einen rohen Schlüssel einzufügen.
{ "context_servers": { "flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Cline
MCP-Server → Konfigurieren — setzen Sie type: "streamableHttp" (camelCase), sonst wird auf tote SSE zurückgegriffen.
{ "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 — Verbindung über die mcp-remote-Brücke. Setzen Sie 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 }}"]
Überprüfen Sie, ob es funktioniert — fragen Sie: "Meine offenen Stellen auflisten."
Beliebiger Client (mcp-remote)
Für jeden stdio-only-Client (oder einen zukünftigen Client ohne nativen Remote-Transport) verbinden Sie sich mit Flowmingo über den mcp-remote-stdio-Befehl. --transport http-only ist erforderlich — der Server hat kein SSE.
Schritte: 1) Stellen Sie sicher, dass Node ≥ 18 installiert ist, 2) führen Sie die Brücke als stdio-Befehl in Ihrem Client aus, 3) Beim ersten OAuth-Lauf öffnet sich der Browser — fügen Sie Ihren Schlüssel ein.
# 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" }
}
}
}
Notfall: Wenn die Authentifizierung hängen bleibt, führen Sie rm -rf ~/.mcp-auth aus und versuchen Sie es erneut. Ersetzen Sie fl_YOUR_KEY durch Ihren vollständigen Schlüssel (siehe Wie sieht ein vollständiger Schlüssel aus im Abschnitt Authentifizierung oben). In einem JSON-args[]-Array vermeiden Sie ein Leerzeichen nach dem Header-Doppelpunkt (npx-Escaping-Eigenheit).
Überprüfen Sie, ob es funktioniert — fragen Sie: "Listen Sie meine offenen Stellen auf."