Panoramica
Connetti qualsiasi assistente AI compatibile con MCP ai tuoi dati di assunzione Flowmingo: leggi le tue offerte di lavoro e i tuoi candidati e intraprendi azioni protette (invita, sposta, rifiuta, rimuovi da un progetto), in modo sicuro e con la tua autorizzazione. Con due autorizzazioni extra che attivi tu stesso, un assistente può anche creare progetti di assunzione e valutazioni, e pubblicare, chiudere o potenziare un'offerta di lavoro (vedi Cosa puoi fare). Nuovo a MCP? È lo standard aperto che consente agli assistenti AI di parlare con strumenti come Flowmingo. Scopri cos'è MCP.
Trasporto: Streamable HTTP (il moderno trasporto remoto). Non esiste SSE legacy: punta sempre il tuo client a /mcp, mai a /sse.
Tratta la tua chiave API come una password. Preferisci OAuth, un input richiesto o una variabile d'ambiente piuttosto che incollare una chiave grezza
fl_...in un file che potresti committare su git (ad es..vscode/mcp.json,~/.cursor/mcp.json, la tua configurazione di Continue).
Autenticazione: due opzioni
A — Accedi con Flowmingo (OAuth, consigliato). Il tuo browser apre una pagina di consenso Flowmingo; incolli lì la tua chiave API. L'assistente non riceve mai la tua chiave grezza. Riceve un token di accesso e un token di aggiornamento, che può utilizzare per ottenere un nuovo token di accesso. L'accesso non dura per sempre. Il token di aggiornamento vive circa 30 giorni per impostazione predefinita, contati dalla sua emissione, al momento dell'accesso o all'ultimo aggiornamento, quindi un accesso che rimane inutilizzato per circa quel periodo decade, e una release di Flowmingo che modifica il modo in cui gli accessi vengono memorizzati potrebbe richiederti di accedere di nuovo. L'assistente ti chiederà quindi di accedere di nuovo e incollerai di nuovo la tua chiave. Per interrompere prima, elimina quella chiave API. Non c'è client ID o secret da creare (Flowmingo usa Dynamic Client Registration). Sui client che mostrano impostazioni OAuth "Avanzate" (ad es. Claude.ai), lascia vuoti Client ID e Secret.
B — Chiave API statica (header). Invia la tua chiave come uno di questi header:
x-api-key: fl_YOUR_KEY
Authorization: Bearer fl_YOUR_KEY
Ottieni la tua chiave in Flowmingo → Impostazioni → Integrazioni → Chiavi API. Spunta Read hiring data e Read candidates — la prima copre offerte, pipeline e risultati, la seconda è ciò che consente a un assistente di cercare una persona. Aggiungi Manage pipeline / Invite candidates per le azioni di scrittura protette. Per consentire a un assistente di creare progetti e valutazioni e pubblicare o potenziare un'offerta di lavoro, spunta anche Create hiring projects e Create assessments. Leggi Crea e pubblica nella sezione Cosa puoi fare prima: queste due autorizzazioni sono opzionali e il creatore della chiave deve essere un Proprietario o un Amministratore.
Che aspetto ha una chiave completa. Un unico valore lungo: fl_live_, il nome pubblico della chiave, un punto, poi un lungo segreto. La metà segreta viene mostrata una volta, subito dopo la creazione della chiave; in seguito l'elenco delle Chiavi API mostra solo l'inizio. Un valore senza punto è solo il nome della chiave e verrà rifiutato. Ovunque questa guida scriva fl_YOUR_KEY, sostituiscilo completamente con la tua chiave completa, senza virgolette e senza spazi.
Se non si connette. Una chiave errata o vuota restituisce Missing credential o The Flowmingo API key was rejected; entrambi possono significare che il valore non ci è mai arrivato interamente, quindi controlla prima il valore. Un'impostazione come ${env:FLOWMINGO_API_KEY} funziona solo se il programma può vedere quella variabile, e un editor aperto dal dock o dal menu Start spesso non legge il profilo del terminale. Avvialo da un terminale dove la variabile è impostata, oppure inserisci la tua chiave completa nel file (e tieni quel file fuori da git).
Quale scegliere? La maggior parte dei client supporta entrambe; alcuni (ad es. ChatGPT) sono solo OAuth — ogni scheda nota ciò che quel client supporta. In generale, OAuth si adatta ad assistenti interattivi (Claude.ai, ChatGPT, VS Code); l'header con chiave API si adatta a CLI, headless/CI ed editor dove preferisci inserire una chiave.
Cosa puoi fare
Le letture non richiedono approvazione. La maggior parte delle scritture sono protette. Un invito, un rifiuto effettuato con l'azione Rifiuta, una rimozione di candidati da un progetto, una cancellazione di un progetto o, normalmente, uno spostamento a una fase impostata per inviare email al candidato, attendono che una persona li approvi tramite un link, con accesso a Flowmingo. L'assistente non può approvare e un "sì" digitato nella chat non conta. L'impostazione email della fase viene controllata quando viene richiesto lo spostamento. Per una nota, una valutazione, una shortlist, un tag o uno spostamento a una fase che non invia email al candidato, all'assistente viene detto di mostrarti prima un'anteprima e di procedere solo quando sei d'accordo, che è un'istruzione per lui, non un blocco. Un prompt che il tuo client AI mostra prima di eseguire uno strumento è del client e non è l'approvazione di Flowmingo: un invito, un rifiuto effettuato con l'azione Rifiuta e uno spostamento a una fase con email attendono comunque il link di approvazione, qualunque cosa chieda il client. Un link di approvazione scade dopo 15 minuti e una richiesta per diversi candidati o candidature (al massimo 50) è un'unica approvazione che elenca tutti. Una volta che una modifica è in attesa, l'assistente può controllare lo stato, ritirarla mentre è ancora in attesa e annullare una modifica reversibile (una nota, una valutazione, un segno di shortlist, un tag o uno spostamento che non ha inviato email a nessuno) entro 24 ore. Un annullamento non è sempre disponibile: la modifica deve tornare con un riferimento di annullamento, registrarlo è un tentativo, e uno spostamento per un candidato senza una fase precedente non ne ha, quindi l'assistente dovrebbe controllare e dirlo quando non c'è via di ritorno. Un'email che è stata inviata non può essere annullata. Gli strumenti elencati in Crea e pubblica sono l'eccezione a tutto questo, tranne delete_project: agiscono immediatamente e non sono in attesa di approvazione. Una rimozione e una cancellazione di progetto non possono essere annullate. Tutto è limitato alla tua organizzazione.
Lettura
| Capacità | Cosa fa |
|---|---|
| Elenca offerte di lavoro | Sfoglia i ruoli aperti e chiusi della tua organizzazione. |
| Elenca set di interviste e progetti | Vedi le tue valutazioni (set di interviste) di ogni tipo (interviste AI, role-play, Skill Test, Technical Test, valutazioni CV, Showcase e registrazioni; questionari quando li richiedi) e i tuoi progetti di assunzione. |
| Elenca la tua pipeline di candidati | Visualizza le candidature per fase in un progetto. |
| Leggi risultati e punteggi delle valutazioni | Recupera risultati di ogni tipo: interviste AI, role-play, Skill Test, Technical Test, valutazioni CV, Showcase, registrazioni e questionari. Ogni risultato è etichettato con il suo tipo. Solo alcuni tipi hanno un punteggio AI: uno Showcase e un questionario non vengono mai valutati, e un Skill Test è una percentuale. |
| Cerca un candidato | Recupera nome, email e CV di un singolo candidato. |
| Cerca candidati | Trova candidati per nome o email. |
| Confronta candidati | Allinea da 2 a 10 candidati fianco a fianco. Richiede l'autorizzazione Read candidates oltre a Read hiring data. |
| Panoramica assunzioni | Il funnel per tutto ciò che la tua connessione può raggiungere (l'intera azienda, a meno che la chiave non sia stata creata da qualcuno limitato ad alcuni progetti), o ridotto quando chiedi: candidature per fase, attivi vs rifiutati e, per ogni tipo di valutazione che ha risultati, risultati completati vs in corso e punteggio medio. Un progetto restringe ogni conteggio, ma i suoi conteggi dei risultati coprono i risultati sulle valutazioni collegate a quel progetto, quindi un candidato di un altro progetto che condivide una di quelle valutazioni può essere contato anche lui. Una valutazione restringe solo i conteggi dei risultati: i conteggi di fase e candidature rimangono a tutto ciò che la tua connessione può raggiungere. I tipi non vengono mai sommati. |
| Migliori candidati | I risultati con il punteggio più alto, ordinati per punteggio complessivo. Ogni tipo di valutazione viene classificato insieme, a meno che tu non richieda un tipo o una valutazione specifica (set di interviste). |
| Dettaglio risultato valutazione | I punteggi per competenza di un singolo risultato più il riepilogo AI, per i tipi che li hanno. Un Skill Test, un Technical Test, uno Showcase e un questionario ne hanno poco o niente. |
| Dettaglio offerta di lavoro | Il dettaglio completo di una singola offerta di lavoro. |
Un'offerta di lavoro è pubblica? (get_job_post_publication) |
Se chiunque può aprire la pagina pubblica di un'offerta di lavoro: attiva, ancora in attesa del controllo contenuti AI, rifiutata da esso, segnalata, disattivata, o il suo progetto non è aperto. Inoltre il suo indirizzo pubblico e il suo boost (off, flowmingo o extended). Richiede Read hiring data. |
| Prossime interviste | Inviti a qualsiasi tipo di valutazione che sono stati inviati o programmati e non ancora completati. Non è un conteggio di tutti quelli ancora in sospeso: un invito il cui candidato è stato sollecitato, o ha aperto o cliccato il link, viene escluso finché il candidato non inizia, e così anche uno che non è stato consegnato. |
Scrittura (protetta)
| Capacità | Cosa fa |
|---|---|
| Invita candidati a una valutazione | Prepara gli inviti per un'intervista AI, un role-play, un Skill Test o un Technical Test e attende che una persona li approvi tramite un link. Nulla viene inviato prima. Una valutazione e al massimo 50 candidati per richiesta; un Skill Test o un Technical Test richiede un progetto e un'email per ogni candidato, e uno sponsorizzato può addebitare il portafoglio della tua organizzazione quando un candidato lo inizia. |
| Sposta un candidato in un'altra fase | Uno spostamento a una fase impostata per inviare email al candidato attende normalmente che una persona lo approvi tramite un link (l'impostazione email della fase viene letta una volta, appena prima dello spostamento, quindi un'impostazione attivata in quel momento può ancora consentire a uno spostamento di inviare email senza approvazione). Qualsiasi altro spostamento: all'assistente viene detto di mostrarlo in anteprima e attendere il tuo sì, e di solito può essere annullato per 24 ore, quando è tornato con un riferimento di annullamento. Al massimo 50 candidature per richiesta. |
| Rifiuta una candidatura | Richiede approvazione tramite un link. Se una persona la approva, Flowmingo tenta di spostare la candidatura nella fase Rifiutato del progetto; controlla il risultato dopo. Al massimo 50 candidature per richiesta. |
Rimuovi candidati da un progetto (remove_application) |
Richiede Manage pipeline. Richiede approvazione tramite un link. Se una persona la approva, Flowmingo elimina le candidature dal progetto; il profilo del candidato resta nel tuo talent pool e in altri progetti. Non è un rifiuto e non c'è annullamento. Al massimo 50 candidature per richiesta. |
| Aggiungi una nota a un risultato | All'assistente viene detto di mostrare in anteprima la nota proposta e attendere il tuo sì prima di salvarla. Una nota appartiene a un risultato di valutazione (di qualsiasi tipo), non al candidato nel suo insieme. |
| Valuta un risultato | All'assistente viene detto di mostrare in anteprima la valutazione e attendere il tuo sì. La valutazione si applica a un risultato di valutazione. |
| Metti in shortlist un risultato | All'assistente viene detto di mostrare in anteprima la modifica della shortlist e attendere il tuo sì. Si applica a un risultato di valutazione. |
| Tagga / aggiungi a una talent collection | All'assistente viene detto di mostrare in anteprima la modifica del tag o della talent collection e attendere il tuo sì. |
| Controlla, ritira o annulla una modifica | Controlla lo stato di una modifica in attesa (in attesa, eseguita, fallita, scaduta o sostituita da una richiesta più recente), ritira una che è ancora in attesa di approvazione, o annulla una modifica reversibile entro 24 ore, quando è tornata con un riferimento di annullamento. |
Crea e pubblica (agisce subito, tranne l'eliminazione di un progetto)
Questi strumenti creano cose e le aprono al pubblico. Si comportano diversamente dalle scritture protette sopra:
- Agiscono subito, tranne
delete_project. Nulla è in attesa che una persona approvi tramite un link e nessuno invia email a un candidato.delete_projectattende che un Proprietario o un Amministratore lo approvi tramite un link. - Il creatore della chiave deve essere un Proprietario o un Amministratore, per ogni strumento qui tranne l'annullamento, che richiede solo Invite candidates. Gli strumenti agiscono con le autorizzazioni della persona che ha creato la chiave API. Se quella persona è un Membro, la chiamata viene rifiutata.
- Due autorizzazioni sono opzionali. Create hiring projects e Create assessments non sono concesse per impostazione predefinita. Con l'accesso (opzione A), l'assistente le ottiene solo se entrambe le condizioni sono vere: il client le elenca per nome quando si connette e la chiave API che incolli nella pagina di consenso le possiede. Un client che non invia un elenco di autorizzazioni ottiene le quattro autorizzazioni standard (Read hiring data, Read candidates, Manage pipeline, Invite candidates) che la chiave possiede, e nessuna di queste due, quindi l'assistente non vede gli strumenti che le richiedono. Con una chiave statica (opzione B), all'assistente vengono mostrati questi strumenti indipendentemente dalle autorizzazioni della chiave, e Flowmingo rifiuta qualsiasi chiamata che la chiave non consente.
- Alcune chiamate richiedono tempo. La pubblicazione attende il controllo contenuti AI, fino a circa 90 secondi. La creazione di un progetto o di una valutazione usa la generazione AI e può richiedere più tempo (un Technical Test richiede da 3 a 9 minuti). Quando la risposta dice che il lavoro è ancora in sospeso, l'assistente chiama di nuovo con la stessa chiave di idempotenza per leggere dove è arrivato. Un nuovo tentativo non crea mai un secondo progetto o valutazione.
| Capacità | Cosa fa |
|---|---|
Crea un progetto di assunzione (create_project) |
Richiede Create hiring projects (opzionale). Crea un progetto con le sue quattro fasi predefinite e un'offerta di lavoro scritta dalla stessa AI della dashboard, da un titolo, la posizione e una descrizione facoltativa. Per impostazione predefinita crea anche una Valutazione CV e un'Intervista AI; l'assistente può nominare altre valutazioni, o nessuna. L'offerta di lavoro viene attivata e diventa pubblica una volta che il controllo contenuti AI la approva, normalmente entro un minuto. Limite di 10 progetti al minuto e 300 al giorno per la tua azienda. La chiave di idempotenza è facoltativa: quando viene omessa, se ne crea una dagli argomenti, quindi un nuovo tentativo non crea mai un secondo progetto. |
Crea una valutazione (create_assessment) |
Richiede Create assessments (opzionale). Crea una valutazione con l'AI: un'Intervista AI, una Valutazione CV, un Skill Test, uno Showcase, un Technical Test o un Role-play, da un titolo di lavoro e una descrizione del lavoro facoltativa, nome, progetto e lingua (un tag come en o vi-VN; un Skill Test e un Technical Test ignorano la lingua). Collega un progetto in modo che i candidati possano essere invitati a un Skill Test, un Technical Test o uno Showcase. La chiave di idempotenza è facoltativa, come sopra. |
Pubblica un'offerta di lavoro (publish_job_post) |
Richiede Create hiring projects. Attiva l'offerta di lavoro e assicura che il controllo contenuti AI sia stato eseguito. La risposta dice se la pagina è attiva ora, ancora in attesa del controllo, o rifiutata da esso. Il progetto di assunzione deve essere attivo. |
Annulla pubblicazione di un'offerta di lavoro (unpublish_job_post) |
Richiede Create hiring projects. Disattiva l'offerta di lavoro, quindi il suo link pubblico smette di aprirsi. Per impostazione predefinita anche il boost viene disattivato (withdraw_boost è true). |
Potenzia un'offerta di lavoro (boost_job_post) |
Richiede Create hiring projects. Imposta il boost su off, flowmingo o extended. Il potenziamento è gratuito. Alzarlo richiede l'offerta di lavoro attiva, il progetto attivo, un logo aziendale e una descrizione, e il controllo contenuti AI; un'azienda può alzare 50 boost al giorno. |
Apri, imposta come bozza o archivia un progetto (set_project_state) |
Richiede Create hiring projects. Sposta un progetto di assunzione tra active, draft e archived. Le bozze e le archiviate chiudono il link del lavoro. I dati dei candidati vengono conservati. |
Annulla un invito programmato (cancel_scheduled_invite) |
Richiede Invite candidates. Annulla un invito programmato per dopo e non ancora inviato, usando l'ID invito dal risultato dell'invito. Nessuno riceve email. La persona resta nel tuo account e nella bacheca del progetto. |
Elimina un progetto di assunzione (delete_project) |
Richiede Create hiring projects (opzionale). Chiede soltanto: non elimina subito, richiede approvazione tramite un link e nulla viene eliminato finché un Proprietario o un Amministratore lo approva. Solo un progetto attivo può essere eliminato. Se una persona lo approva, Flowmingo elimina il progetto e le sue offerte di lavoro; le sue candidature non vengono eliminate una per una, e i profili dei candidati e i contatti, le tue valutazioni e i link di invito sono conservati. Non c'è annullamento. |
Sicurezza e fiducia
- I tuoi dati sono limitati all'organizzazione: l'assistente non può mai vedere i dati di un'altra azienda.
- Con OAuth, l'assistente non riceve mai la tua chiave API. Ottiene un token di accesso che scade dopo un'ora, aggiornato silenziosamente mentre rimane connesso. L'accesso stesso dura quanto il suo token di aggiornamento, circa 30 giorni per impostazione predefinita dalla sua emissione o ultimo aggiornamento, quindi decade dopo circa 30 giorni senza utilizzo e poi accedi di nuovo. Con un header statico (opzione B) il client del tuo assistente tiene la tua chiave e la invia con ogni richiesta, quindi tienila fuori da file che potresti condividere o committare.
- Interrompere un assistente: elimina la chiave API con cui lo hai autorizzato, in Impostazioni → Integrazioni → Chiavi API. L'accesso si interrompe immediatamente. Non esiste ancora una disconnessione per assistente, quindi se vuoi revocarli uno alla volta, dai a ogni assistente la sua chiave.
- Le richieste all'endpoint
/mcpvengono controllate per la loro Origin: un'originenullopaca viene sempre rifiutata e il controllo può essere bloccato su una lista bianca, ma per impostazione predefinita ogni origine reale viene accettata, quindi la protezione è la tua credenziale, non l'origine. Ogni sessione è legata alla credenziale che l'ha aperta.
Per come autenticarti, vedi Autenticazione: due opzioni; per le letture esatte, le scritture protette e le azioni che avvengono subito, vedi Cosa puoi fare. Quando sei pronto, vai a Connetti il tuo assistente e scegli il tuo client.
URL del server MCP
Collega il tuo assistente
Claude Code (CLI)
Un singolo comando aggiunge Flowmingo sopra Streamable HTTP nativo. Inizia con OAuth; lo --header statico è l'alternativa.
Passaggi: 1) aggiungi il server, 2) accedi (browser → incolla la chiave), 3) claude mcp list per 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
Attenzione: i flag devono essere messi prima del nome e usa sempre --transport http (mai sse). Sostituisci fl_YOUR_KEY con la tua chiave completa (vedi Come appare una chiave completa nella sezione Autenticazione sopra).
Verifica che funzioni — chiedi: "elenca le mie offerte di lavoro aperte."
Cursor
L'header statico è il percorso più semplice. Cursor supporta anche OAuth (con registrazione dinamica del client) — in tal caso, rimuovi il blocco headers.
Passaggi: 1) aggiungi il server a ~/.cursor/mcp.json (sotto), 2) imposta FLOWMINGO_API_KEY con la tua chiave completa nel profilo della shell, 3) esci da Cursor e riavvialo da un terminale in cui la variabile è impostata, 4) in Impostazioni → MCP, disattiva e riattiva il server per ricaricarlo.
Cursor deve poter vedere la variabile. Cursor legge ${env:FLOWMINGO_API_KEY} dal proprio ambiente. Se avviato dal dock o dal menu Start, spesso non vede una variabile impostata nel profilo del terminale, e quindi l'header arriva vuoto o non espanso e il server risponde Missing credential. Se avviare Cursor da un terminale non è pratico, sostituisci ${env:FLOWMINGO_API_KEY} nel file con la tua chiave completa (e tieni ~/.cursor/mcp.json fuori da git).
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
}
}
}
In alternativa, OAuth — rimuovi il blocco headers; Cursor esegue la registrazione dinamica del client e apre una pagina di consenso nel browser al primo collegamento:
{
"mcpServers": {
"flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp"
}
}
}
Verifica che funzioni — chiedi: "elenca le mie offerte di lavoro aperte."
VS Code (Copilot, modalità agente)
Gli strumenti appaiono solo in Modalità Agente Copilot Chat. La chiave principale è servers (non mcpServers) e il tipo è http. Il percorso della chiave richiesta di seguito è la configurazione affidabile.
Passaggi: 1) crea .vscode/mcp.json (o esegui MCP: Aggiungi Server → HTTP), 2) quando avvii il server, VS Code richiede la tua chiave (non viene scritta nel file), 3) usala in Modalità Agente.
{
"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 può anche tentare OAuth, ma la configurazione OAuth documentata si aspetta un ID client; usa il percorso della chiave richiesta sopra per una configurazione affidabile.
Verifica che funzioni — chiedi: "elenca i miei lavori aperti."
Claude — claude.ai & Claude Desktop
Entrambi utilizzano la stessa interfaccia Utente Connettori e lo stesso flusso di incolla-l'URL. Solo OAuth (non c'è campo header nell'interfaccia utente).
Passaggi (web o desktop):
- Apri Impostazioni → Connettori e fai clic su Aggiungi connettore personalizzato.
- Chiamalo
Flowmingoe incolla l'URL del server MCP sopra. Lascia Avanzate → ID client OAuth / Segreto vuoti. - Fai clic su Aggiungi → Connetti. Nella pagina di consenso Flowmingo, incolla la tua chiave API
fl_e autorizza. - Verifica — chiedi a Claude: "elenca i miei lavori aperti."
Remote MCP server URL: https://mcp.flowmingo.ai/mcp
Advanced → OAuth Client ID / Secret: (leave blank — Flowmingo uses Dynamic Client Registration)
Team / Enterprise: Un Proprietario lo aggiunge una volta in Impostazioni Organizzazione → Connettori → Personalizzati; i membri quindi fanno clic su Connetti.
Hai bisogno di una chiave statica su Claude Desktop invece? Usa la scheda Qualsiasi client (mcp-remote).
Il tuo browser aprirà una pagina di consenso Flowmingo alla prima connessione — incolla la tua chiave API e autorizza. Per disconnettere in seguito, elimina quella chiave API in Impostazioni → Integrazioni → Chiavi API.
ChatGPT e OpenAI Codex CLI
Entrambi sono OpenAI. ChatGPT usa la Modalità Sviluppatore per connettori personalizzati (solo OAuth); Codex si connette nativamente dalla CLI.
ChatGPT (web)
- Su chatgpt.com (Plus / Pro / Business / Enterprise / Edu — non mobile), apri Impostazioni → App → Avanzate e attiva la Modalità Sviluppatore.
- App → Crea → denomina
Flowmingo, incolla l'URL qui sotto, trasporto Streamable HTTP, autenticazione OAuth. - Apri la bozza, attiva gli strumenti e fai clic su Aggiorna.
- Collega tramite il menu + in una 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)
La Modalità Sviluppatore di ChatGPT si connette solo con OAuth — non accetta una chiave x-api-key statica / un'intestazione API key personalizzata. I connettori semplici e di ricerca approfondita usano solo search + fetch (hai entrambi). Gli strumenti di scrittura (invita / sposta / rifiuta) richiedono la Modalità Sviluppatore. Un prompt che ChatGPT mostra prima di eseguire uno strumento è di ChatGPT e non è l'approvazione di Flowmingo: un invito, un rifiuto e uno spostamento in una fase che invia email al candidato attendono sempre che una persona li approvi tramite un link Flowmingo.
OpenAI Codex CLI
Nessun bridge necessario — Codex parla Streamable HTTP nativamente.
# ~/.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
Verifica che funzioni — chiedi: "elenca i miei lavori aperti."
Gemini CLI & Code Assist
La Gemini CLI (e la modalità agente Gemini Code Assist) raggiungono un server MCP remoto tramite ~/.gemini/settings.json. L'app Gemini consumer non può aggiungere connettori MCP personalizzati — questo percorso è solo per CLI / Code Assist.
Passaggi: 1) aggiungi il server sotto mcpServers in ~/.gemini/settings.json, 2) esporta FLOWMINGO_API_KEY=fl_..., 3) esegui gemini e /mcp per confermare che gli strumenti sono elencati.
{
"mcpServers": {
"flowmingo": {
"httpUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${FLOWMINGO_API_KEY}" },
"timeout": 30000
}
}
}
httpUrl seleziona HTTP Streamable nativo. Il placeholder ${FLOWMINGO_API_KEY} viene espanso dal tuo ambiente, quindi nessuna chiave grezza viene scritta nel file. Preferisci OAuth? Gemini CLI può farlo nativamente — ometti il blocco headers e aggiungi "authProviderType": "dynamic_discovery" alla voce del server. La CLI rileva la sfida 401, scopre i nostri metadati OAuth ed esegue la registrazione dinamica del client da sola (nessun ID client da impostare).
Verifica che funzioni — in
gemini, chiedi: "elenca i miei lavori aperti."
Altri client — Windsurf · Zed · Cline · Continue · Antigravity
Ogni client sotto funziona con lo stesso server — la maggior parte supporta sia OAuth che un header statico. Gli snippet usano una chiave statica tramite una variabile d'ambiente; rimuovi gli headers per consentire a un client di eseguire OAuth dove supportato. Fai attenzione alle insidie specifiche dei nomi di chiave per client, come evidenziato sotto.
Google Antigravity
Aggiungi https://mcp.flowmingo.ai/mcp come server MCP remoto e scegli di autenticarlo: si apre una pagina Flowmingo che chiede la tua chiave API completa (vedi Come appare una chiave completa nella sezione Autenticazione sopra). Ogni superficie di Antigravity (l'IDE, la CLI) accede separatamente. In mcp_config.json di Antigravity, l'indirizzo va sotto serverUrl, e una chiave statica va in un blocco headers come Authorization con Bearer e la tua chiave completa, come negli esempi MCP di Antigravity di Google. Non abbiamo potuto testare ogni versione di Antigravity, quindi se i tuoi menu differiscono da questo, la guida di Google ha i passaggi aggiornati.
Windsurf (Cascade)
~/.codeium/windsurf/mcp_config.json — Windsurf accetta serverUrl o url, e supporta OAuth (ometti headers per attivarlo).
{ "mcpServers": { "flowmingo": {
"serverUrl": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Zed
~/.config/zed/settings.json — la chiave è context_servers; ometti headers per OAuth nativo. Imposta FLOWMINGO_API_KEY=fl_... nel tuo ambiente piuttosto che incollare una chiave grezza.
{ "context_servers": { "flowmingo": {
"url": "https://mcp.flowmingo.ai/mcp",
"headers": { "Authorization": "Bearer ${env:FLOWMINGO_API_KEY}" }
} } }
Cline
MCP Servers → Configura — imposta type: "streamableHttp" (camelCase), altrimenti il default è SSE non funzionante.
{ "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 — connettiti tramite il bridge mcp-remote. Imposta 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 che funzioni — chiedi: "elenca le mie offerte di lavoro aperte."
Qualsiasi client (mcp-remote)
Per qualsiasi client solo stdio (o un client futuro senza trasporto remoto nativo), collega a Flowmingo con il comando stdio mcp-remote. --transport http-only è obbligatorio — il server non ha SSE.
Passaggi: 1) assicurati che Node ≥ 18, 2) esegui il bridge come comando stdio nel tuo client, 3) al primo run OAuth si apre il browser — incolla la tua chiave.
# 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" }
}
}
}
Recupero: se l'autenticazione si blocca, esegui rm -rf ~/.mcp-auth e riprova. Sostituisci fl_YOUR_KEY con la tua chiave completa (vedi Come è fatta una chiave completa nella sezione Autenticazione sopra). In un args[] JSON, evita uno spazio dopo i due punti dell'header (peculiarità di escape di npx).
Verifica che funzioni — chiedi: "elenca i miei lavori aperti."