Integrazioni

Collega Assistenti AI (MCP)

Collega qualsiasi assistente AI compatibile con MCP — Claude, Claude Code, ChatGPT, Cursor, VS Code e altro — ai tuoi dati di recruiting Flowmingo e gestisci la tua pipeline in linguaggio naturale.

Our team is online
Hai bisogno di aiuto per l'integrazione?

Bloccato su un passaggio o ti serve supporto tecnico? Il nostro team è felice di aiutarti — scrivici quando vuoi e ti mettiamo subito in contatto.

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_project attende 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 /mcp vengono controllate per la loro Origin: un'origine null opaca 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

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

Collega il tuo assistente

Quale assistente stai usando?

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