Integracions

Connectar assistents d'IA (MCP)

Connecteu qualsevol assistent d'IA compatible amb MCP — Claude, Claude Code, ChatGPT, Cursor, VS Code i més — a les vostres dades de contractació de Flowmingo, i gestioneu la vostra pipeline en llenguatge natural.

Our team is online
Necessites ajuda amb la integració?

Has quedat encallat en algun pas o necessites suport tècnic? El nostre equip estarà encantat d'ajudar-te — escriu-nos quan vulguis i et posarem en contacte.

Visió general

Connecta qualsevol assistent d'IA compatible amb MCP a les teves dades de contractació de Flowmingo: llegeix les teves ofertes i candidats i realitza accions protegides (convidar, moure, rebutjar, eliminar d'un projecte), de manera segura, amb el teu permís. Amb dos permisos addicionals que actives tu mateix, un assistent també pot crear projectes de contractació i avaluacions, i publicar, tancar o promocionar una oferta de feina (consulta Què pots fer). Nou a MCP? És l'estàndard obert que permet als assistents d'IA parlar amb eines com Flowmingo. Aprèn què és MCP.

Transport: Streamable HTTP (el transport remot modern). No hi ha SSE heretat: apunta sempre el teu client a /mcp, mai a /sse.

Tracta la teva clau API com una contrasenya. Prefereix OAuth, una entrada sol·licitada o una variable d'entorn en lloc d'enganxar una clau fl_... en un fitxer que puguis enviar a git (per exemple, .vscode/mcp.json, ~/.cursor/mcp.json, la teva configuració de Continue).

Autenticació — dues opcions

A — Inicia sessió amb Flowmingo (OAuth, recomanat). El teu navegador obre una pàgina de consentiment de Flowmingo; hi enganxes la teva clau API. L'assistent mai rep la teva clau en brut. Rep un token d'accés i un token de refresc, que pot utilitzar per obtenir un nou token d'accés. L'inici de sessió no dura per sempre. El token de refresc dura uns 30 dies per defecte, comptats des de la seva emissió, a l'inici de sessió o al darrer refresc, així que un inici de sessió que no s'utilitza durant aquest temps caduca, i una versió de Flowmingo que canviï com s'emmagatzemen els inicis de sessió també pot requerir que tornis a iniciar sessió. L'assistent et demanarà llavors que tornis a iniciar sessió, i que enganxis la teva clau de nou. Per tallar-ho abans, elimina aquesta clau API. No cal crear cap ID de client o secret (Flowmingo utilitza Dynamic Client Registration). En clients que mostren opcions OAuth "Avançades" (per exemple, Claude.ai), deixa l'ID de client i el Secret en blanc.

B — Clau API estàtica (capçalera). Envia la teva clau com a capçalera:

x-api-key: fl_YOUR_KEY
Authorization: Bearer fl_YOUR_KEY

Obtén la teva clau a Flowmingo → Configuració → Integracions → Claus API. Marca Read hiring data i Read candidates — la primera cobreix ofertes, pipeline i resultats; la segona permet a un assistent buscar algú. Afegeix Manage pipeline / Invite candidates per a les accions d'escriptura protegides. Per permetre que un assistent creï projectes i avaluacions i publiqui o promocioni una oferta, marca també Create hiring projects i Create assessments. Llegeix Crea i publica a Què pots fer primer: aquests dos permisos són opcionals, i el creador de la clau ha de ser un Propietari o un Administrador.

Com és una clau completa. Un valor llarg: fl_live_, el nom públic de la clau, un punt, i després un secret llarg. La meitat secreta es mostra una vegada, just després de crear la clau; després la llista de claus API només mostra el principi. Un valor sense punt és només el nom de la clau, i serà rebutjat. Allà on aquesta guia escriu fl_YOUR_KEY, substitueix-ho tot per la teva clau completa, sense cometes ni espais.

Si no connecta. Una clau dolenta o buida retorna Missing credential o The Flowmingo API key was rejected; tots dos poden significar que el valor no ens va arribar complet, així que primer comprova el valor. Una configuració com ${env:FLOWMINGO_API_KEY} només funciona si el programa pot veure aquesta variable, i un editor obert des del dock o el menú d'inici sovint no llegeix el teu perfil de terminal. O bé l'inicia des d'una terminal on la variable estigui definida, o bé posa la teva clau completa al fitxer (i mantén aquest fitxer fora de git).

Quina triar? La majoria de clients suporten ambdues; alguns (per exemple, ChatGPT) són només OAuth — cada pestanya indica què suporta aquell client. En general, OAuth és adequat per a assistents interactius (Claude.ai, ChatGPT, VS Code); la capçalera de clau API s'adequa a CLIs, entorns headless/CI i editors on prefereixes posar una clau.

Què pots fer

Les lectures no necessiten aprovació. La majoria d'escriptures estan protegides. Una invitació, un rebuig fet amb l'acció Rebutja, una eliminació de candidats d'un projecte, una eliminació d'un projecte o, normalment, un moviment a una etapa que està configurada per enviar un correu al candidat, espera que una persona l'aprovi en un enllaç, amb sessió iniciada a Flowmingo. L'assistent no pot aprovar-ho, i un "sí" escrit al xat no compta. La configuració de correu de l'etapa es comprova quan es sol·licita el moviment. Per a una nota, una valoració, una llista curta, una etiqueta o un moviment a una etapa que no està configurada per enviar correu al candidat, es diu a l'assistent que mostri primer una vista prèvia i que continuï només quan tu hi accedeixis, cosa que és una instrucció per a ell, no un bloqueig. Una sol·licitud que el teu client d'IA mostra abans d'executar una eina és pròpia del client i no és l'aprovació de Flowmingo: una invitació, un rebuig fet amb l'acció Rebutja i un moviment a una etapa amb correu encara esperen l'enllaç d'aprovació, sigui el que sigui el que el client hagi preguntat. Un enllaç d'aprovació caduca després de 15 minuts, i una sol·licitud per a diversos candidats o sol·licituds (com a màxim 50) és una aprovació que els llista tots. Un cop un canvi està programat, l'assistent pot comprovar on es troba, retirar-lo si encara espera i desfer un canvi reversible (una nota, una valoració, una marca de llista curta, una etiqueta o un moviment que no hagi enviat correu a ningú) dins de 24 hores. Una desfer no sempre està disponible: el canvi ha de tornar amb una referència de desfer, registrar-ne una és un esforç màxim, i un moviment per a un candidat sense etapa anterior no en té cap, així que l'assistent ha de comprovar-ho i dir-ho quan no hi hagi manera de tornar enrere. Un correu que s'ha enviat no es pot desfer. Les eines llistades sota Crea i publica són l'excepció a tot això, excepte delete_project: actuen immediatament i no estan programades per a aprovació. Una eliminació i una eliminació de projecte no es poden desfer. Tot està limitat a la teva organització.

Lectura

Capacitat Què fa
Llista d'ofertes de feina Navega per les ofertes obertes i tancades de la teva organització.
Llista de conjunts d'entrevistes i projectes Veu les teves avaluacions (conjunts d'entrevistes) de tota mena (entrevistes d'IA, jocs de rol, tests d'habilitats, tests tècnics, avaluacions de CV, showcases i gravacions; qüestionaris quan els demanis) i els teus projectes de contractació.
Llista el teu pipeline de candidats Veu les sol·licituds per etapa en un projecte.
Llegeix resultats i puntuacions d'avaluació Extreu resultats de tota mena: entrevistes d'IA, jocs de rol, tests d'habilitats, tests tècnics, avaluacions de CV, showcases, gravacions i qüestionaris. Cada resultat està etiquetat amb el seu tipus. Només alguns tipus porten una puntuació d'IA: un showcase i un qüestionari mai es puntuen, i un test d'habilitats és un percentatge.
Cerca un candidat Obtén el nom, el correu i el CV d'un candidat.
Cerca candidats Troba candidats per nom o correu.
Compara candidats Alinea de 2 a 10 candidats costat a costat. Necessita el permís Read candidates a més de Read hiring data.
Visió general de contractació L'embut per a tot el que la teva connexió pot accedir (tota l'empresa, tret que la clau l'hagi creada algú limitat a alguns projectes), o reduït quan ho demanis: sol·licituds per etapa, actives vs rebutjades, i, per a cada tipus d'avaluació que tingui resultats, resultats completats vs en curs i la puntuació mitjana. Un projecte redueix tots els comptes, però els seus comptes de resultats cobreixen els resultats de les avaluacions vinculades a aquest projecte, així que un candidat d'un altre projecte que comparteix una d'aquestes avaluacions també pot comptar. Una avaluació redueix només els comptes de resultats: els comptes d'etapa i sol·licituds es mantenen a tot el que la teva connexió pot accedir. Els tipus mai se sumen.
Principals candidats Els resultats més ben classificats, ordenats per puntuació global. Tots els tipus d'avaluació es classifiquen junts tret que demanis un sol tipus o una sola avaluació (conjunt d'entrevistes).
Detall de resultat d'avaluació Les puntuacions per competència d'un resultat més el resum d'IA, per als tipus que en tenen. Un test d'habilitats, un test tècnic, un showcase i un qüestionari en tenen poc o cap.
Detall d'oferta de feina El detall complet d'una sola oferta.
Una oferta és pública? (get_job_post_publication) Si qualsevol pot obrir la pàgina pública d'una oferta: activa, encara esperant la revisió de contingut d'IA, rebutjada per aquesta, marcada, desactivada o el seu projecte no està obert. També la seva adreça pública i la seva promoció (desactivada, flowmingo o estesa). Necessita Read hiring data.
Properes entrevistes Invitacions a qualsevol tipus d'avaluació que s'han enviat o estan programades i encara no s'han completat. No és un recompte de tots els pendents: una invitació el candidat de la qual ha estat recordat, o ha obert o fet clic a l'enllaç, es deixa fora fins que el candidat comença, i també una que no s'ha pogut lliurar.

Escriptura (protegida)

Capacitat Què fa
Convida candidats a una avaluació Prepara les invitacions per a una entrevista d'IA, un joc de rol, un test d'habilitats o un test tècnic, i espera que una persona les aprovi en un enllaç. No s'envia res abans. Una avaluació i com a màxim 50 candidats per sol·licitud; un test d'habilitats o un test tècnic necessita un projecte i un correu per a cada candidat, i un de patrocinat pot carregar el moneder de la teva organització quan un candidat el comença.
Mou un candidat a una altra etapa Un moviment a una etapa configurada per enviar correu al candidat normalment espera que una persona l'aprovi en un enllaç (la configuració de correu de l'etapa es llegeix un cop, just abans del moviment, així que una configuració activada en aquell moment pot fer que un moviment enviï correu sense aprovació). Qualsevol altre moviment: es diu a l'assistent que el previsualitzi i esperi el teu sí, i normalment es pot desfer durant 24 hores, quan torna amb una referència de desfer. Com a màxim 50 sol·licituds per petició.
Rebutja una sol·licitud Sol·licita aprovació en un enllaç. Si una persona l'aprova, Flowmingo intenta moure la sol·licitud a l'etapa de Rebutjat del projecte; comprova el resultat després. Com a màxim 50 sol·licituds per petició.
Elimina candidats d'un projecte (remove_application) Necessita Manage pipeline. Sol·licita aprovació en un enllaç. Si una persona l'aprova, Flowmingo elimina les sol·licituds del projecte; el perfil del candidat es manté al teu viver de talent i en altres projectes. No és un rebuig, i no hi ha desfer. Com a màxim 50 sol·licituds per petició.
Afegeix una nota a un resultat Es diu a l'assistent que previsualitzi la nota proposada i esperi el teu sí abans de desar-la. Una nota pertany a un resultat d'avaluació (de qualsevol tipus), no al candidat en general.
Valora un resultat Es diu a l'assistent que previsualitzi la valoració i esperi el teu sí. La valoració s'aplica a un resultat d'avaluació.
Afegeix a la llista curta un resultat Es diu a l'assistent que previsualitzi el canvi de llista curta i esperi el teu sí. S'aplica a un resultat d'avaluació.
Etiqueta / afegeix a col·lecció de talent Es diu a l'assistent que previsualitzi el canvi d'etiqueta o col·lecció de talent i esperi el teu sí.
Comprova, retira o desfés un canvi Comprova on es troba un canvi programat (esperant, realitzat, fallit, expirat o substituït per una sol·licitud més nova), retira un que encara espera aprovació o desfés un canvi reversible dins de 24 hores, quan torna amb una referència de desfer.

Crea i publica (actua immediatament, excepte eliminar un projecte)

Aquestes eines creen coses i les obren al públic. Es comporten de manera diferent de les escriptures protegides anteriors:

  • Actuen immediatament, excepte delete_project. Res no està programat perquè una persona ho aprovi en un enllaç, i cap d'elles envia correu a un candidat. delete_project espera que un Propietari o un Administrador l'aprovi en un enllaç.
  • El creador de la clau ha de ser un Propietari o un Administrador, per a cada eina aquí excepte la cancel·lació, que només necessita Invite candidates. Les eines actuen amb els permisos de la persona que va crear la clau API. Si aquesta persona és un Membre, la crida és rebutjada.
  • Dos permisos són opcionals. Create hiring projects i Create assessments no s'atorguen per defecte. Amb l'inici de sessió (opció A), l'assistent els obté només si es compleixen dues condicions: que el client els esmenti pel seu nom quan es connecta, i que la clau API que enganxeu a la pàgina de consentiment els inclogui. Un client que no enviï cap llista de permisos obté els quatre permisos estàndard (Read hiring data, Read candidates, Manage pipeline, Invite candidates) que té la clau, i cap d'aquests dos, de manera que l'assistent no veu les eines que els requereixen. Amb una clau estàtica (opció B), l'assistent veu aquestes eines independentment dels permisos que tingui la clau, i Flowmingo rebutja qualsevol crida que la clau no permeti.
  • Algunes crides triguen una estona. La publicació espera la revisió de contingut d'IA, fins a uns 90 segons. Crear un projecte o una avaluació utilitza generació d'IA i pot trigar més (un test tècnic triga de 3 a 9 minuts). Quan la resposta diu que el treball encara està pendent, l'assistent torna a trucar amb la mateixa clau d'idempotència per llegir on ha arribat. Una reintent mai crea un segon projecte o avaluació.
Capacitat Què fa
Crea un projecte de contractació (create_project) Necessita Create hiring projects (opcional). Fa un projecte amb les seves quatre etapes per defecte i una oferta de feina escrita per la mateixa IA que el tauler, a partir d'un títol, la posició i una descripció opcional. Per defecte també fa una Avaluació de CV i una Entrevista d'IA; l'assistent pot nomenar altres avaluacions, o cap. L'oferta s'activa i es fa pública un cop la revisió de contingut d'IA l'aprova, normalment en un minut. Limitat a 10 projectes per minut i 300 al dia per a la teva empresa. La clau d'idempotència és opcional: quan s'omet, se'n fa una a partir dels arguments, així que una reintent mai crea un segon projecte.
Crea una avaluació (create_assessment) Necessita Create assessments (opcional). Fa una avaluació amb la IA: una Entrevista d'IA, una Avaluació de CV, un Test d'Habilitats, un Showcase, un Test Tècnic o un Joc de Rol, a partir d'un títol de feina i una descripció, nom, projecte i llengua opcionals (una etiqueta com en o vi-VN; un Test d'Habilitats i un Test Tècnic ignoren la llengua). Adjunta-la a un projecte perquè els candidats puguin ser convidats a un Test d'Habilitats, un Test Tècnic o un Showcase. La clau d'idempotència és opcional, com abans.
Publica una oferta de feina (publish_job_post) Necessita Create hiring projects. Activa l'oferta i assegura que la revisió de contingut d'IA s'ha executat. La resposta diu si la pàgina és activa ara, encara esperant la revisió o rebutjada per aquesta. El projecte de contractació ha d'estar actiu.
Deixa de publicar una oferta (unpublish_job_post) Necessita Create hiring projects. Desactiva l'oferta, de manera que el seu enllaç públic deixa d'obrir-se. Per defecte, la promoció també es desactiva (withdraw_boost és cert).
Promociona una oferta (boost_job_post) Necessita Create hiring projects. Estableix la promoció a off, flowmingo o extended. Promocionar és gratuït. Augmentar-la necessita l'oferta activada, el seu projecte actiu, un logotip d'empresa i una descripció, i la revisió de contingut d'IA; una empresa pot augmentar 50 promocions al dia.
Obre, esborrany o arxiva un projecte (set_project_state) Necessita Create hiring projects. Mou un projecte de contractació entre active, draft i archived. Els esborranys i els arxivats tanquen l'enllaç de la feina. Les dades del candidat es conserven.
Cancel·la una invitació programada (cancel_scheduled_invite) Necessita Invite candidates. Cancel·la una invitació que estava programada per a més tard i encara no s'ha enviat, utilitzant l'ID d'invitació del resultat d'invitació. No s'envia correu a ningú. La persona es manté al teu compte i al tauler del projecte.
Elimina un projecte de contractació (delete_project) Necessita Create hiring projects (opcional). Només demana: no elimina immediatament, sol·licita aprovació en un enllaç, i res no s'elimina fins que un Propietari o un Administrador ho aprova. Només es pot eliminar un projecte actiu. Si una persona ho aprova, Flowmingo elimina el projecte i les seves ofertes; les sol·licituds de candidats no s'eliminen una a una, i els perfils i contactes dels candidats, les teves avaluacions i els enllaços d'invitació es conserven. No hi ha desfer.

Seguretat i confiança

  • Les teves dades estan limitades a l'organització — l'assistent mai pot veure dades d'una altra empresa.
  • Amb OAuth, l'assistent mai rep la teva clau API. Rep un token d'accés que caduca després d'una hora, refrescat silenciosament mentre es manté connectat. L'inici de sessió en si dura tant com el seu token de refresc, uns 30 dies per defecte des de la seva emissió o darrer refresc, així que caduca després d'uns 30 dies sense ús, i llavors tornes a iniciar sessió. Amb una capçalera estàtica (opció B), el client del teu assistent manté la teva clau i l'envia amb cada sol·licitud, així que mantén-la fora de fitxers que puguis compartir o enviar a git.
  • Tallar la connexió d'un assistent: elimina la clau API amb què el vas autoritzar, a Configuració → Integracions → Claus API. L'accés s'atura immediatament. Encara no hi ha desconnexió per assistent, així que si vols revocar-los un a un, dona a cada assistent la seva pròpia clau.
  • Les sol·licituds a l'endpoint /mcp es comproven per l'Origen: un origen opac null sempre es rebutja, i la comprovació es pot bloquejar a una llista blanca, però per defecte s'accepta qualsevol origen real, així que la protecció és la teva credencial, no l'origen. Cada sessió està vinculada a la credencial que la va obrir.

Per saber com autenticar-te, consulta Autenticació — dues opcions; per a les lectures exactes, escriptures protegides i accions que es produeixen immediatament, consulta Què pots fer. Quan estiguis a punt, salta a Connecta el teu assistent i tria el teu client.

URL del servidor MCP

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

Connecteu el vostre assistent

Quin assistent estàs utilitzant?

Claude Code (CLI)

Una ordre afegeix Flowmingo sobre Streamable HTTP natiu. Lidera amb OAuth; l'--header estàtic és l'alternativa.

Passos: 1) afegeix el servidor, 2) inicia sessió (navegador → enganxa la clau), 3) claude mcp list per verificar.

# 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

Avís: les banderes han d'anar abans del nom, i sempre utilitza --transport http (mai sse). Substitueix fl_YOUR_KEY amb la teva clau completa (vegeu Què és una clau completa a la secció d'Autenticació anterior).

Verifica que funciona — pregunta: "llista les meves ofertes de feina obertes."