Integracións

Conectar Asistentes de IA (MCP)

Conecta calquera asistente de IA compatible con MCP — Claude, Claude Code, ChatGPT, Cursor, VS Code e máis — aos teus datos de contratación de Flowmingo, e traballa co teu pipeline en linguaxe sinxela.

Our team is online
Precisas axuda coa integración?

Atascáchete nalgún paso ou precisas asistencia técnica? O noso equipo estará encantado de axudarte — escríbenos cando queiras e poñerémoste en contacto.

Visión xeral

Conecta calquera asistente de IA compatible con MCP aos teus datos de contratación de Flowmingo — le as túas ofertas de emprego e candidatos e realiza accións protexidas (invitar, mover, rexeitar, eliminar dun proxecto), de forma segura, co teu permiso. Con dous permisos extra que activas ti mesmo, un asistente tamén pode crear proxectos de contratación e avaliacións, e publicar, pechar ou impulsar unha oferta de emprego (consulta O que podes facer). Novo en MCP? É o estándar aberto que permite que os asistentes de IA falen con ferramentas como Flowmingo. Aprende o que é MCP.

Transporte: Streamable HTTP (o transporte remoto moderno). Non hai SSE legado — apunta sempre o teu cliente a /mcp, nunca a /sse.

Trata a túa chave de API como un contrasinal. Prefire OAuth, unha entrada solicitada ou unha variable de contorno sobre pegar unha chave fl_... en bruto nun ficheiro que poidas commit a git (por exemplo, .vscode/mcp.json, ~/.cursor/mcp.json, a túa configuración de Continue).

Autenticación — dúas opcións

A — Inicia sesión con Flowmingo (OAuth, recomendado). O teu navegador abre unha páxina de consentimento de Flowmingo; pegas a túa chave de API alí. O asistente nunca recibe a túa chave en bruto. Recibe un token de acceso e un token de actualización, que pode usar para obter un novo token de acceso. O inicio de sesión non dura para sempre. O token de actualización vive uns 30 días por defecto, contados desde a súa emisión, no inicio de sesión ou na última actualización, polo que un inicio de sesión que non se use durante ese tempo caduca, e unha versión de Flowmingo que cambie como se almacenan os inicios de sesión pode requirir que volvas iniciar sesión. Entón o asistente pídete que inicies sesión de novo e pegas a túa chave outra vez. Para cortalo antes, elimina esa chave de API. Non hai ID de cliente nin segredo que crear (Flowmingo usa Dynamic Client Registration). En clientes que mostran opcións de OAuth "Avanzadas" (por exemplo, Claude.ai), deixa o Client ID e o Secret en branco.

B — Chave de API estática (cabeceira). Envía a túa chave como calquera das dúas cabeceiras:

x-api-key: fl_YOUR_KEY
Authorization: Bearer fl_YOUR_KEY

Obtén a túa chave en Flowmingo → Configuración → Integracións → Chaves de API. Marca Read hiring data e Read candidates — a primeira cobre ofertas de emprego, pipeline e resultados, a segunda é a que permite que un asistente busque a alguén. Engade Manage pipeline / Invite candidates para as accións de escritura protexidas. Para permitir que un asistente cree proxectos e avaliacións e publique ou impulse unha oferta de emprego, marca tamén Create hiring projects e Create assessments. Le Crear e publicar baixo O que podes facer primeiro: estes dous permisos son opcionais, e o creador da chave debe ser un Propietario ou un Administrador.

Como é unha chave completa. Un valor longo: fl_live_, o nome público da chave, un punto, e despois un segredo longo. A metade secreta móstrase unha vez, xusto despois de crear a chave; despois a lista de Chaves de API mostra só o comezo. Un valor sen punto é só o nome da chave e será rexeitado. Onde este guía escriba fl_YOUR_KEY, substitúe todo por túa chave completa, sen comiñas nin espazos.

Se non conecta. Unha chave mala ou baleira devólvese como Missing credential ou The Flowmingo API key was rejected; ambos poden significar que o valor nunca chegou completo, así que comproba o valor primeiro. Unha configuración como ${env:FLOWMINGO_API_KEY} só funciona se o programa pode ver esa variable, e un editor aberto desde o dock ou o menú Inicio moitas veces non le o teu perfil de terminal. Ou iníciao desde un terminal onde a variable estea definida, ou pon a túa chave completa no ficheiro (e mantén ese ficheiro fóra de git).

Cal elixir? A maioría dos clientes soportan ambas; algúns (por exemplo, ChatGPT) son só OAuth — cada lapela indica o que soporta ese cliente. En xeral, OAuth é axeitado para asistentes interactivos (Claude.ai, ChatGPT, VS Code); a cabeceira de chave de API é axeitada para CLIs, headless/CI e editores onde prefires poñer unha chave.

O que podes facer

As lecturas non requiren aprobación. A maioría das escrituras están protexidas. Unha invitación, un rexeitamento feito coa acción Rexeitar, unha eliminación de candidatos dun proxecto, unha eliminación dun proxecto ou, normalmente, un movemento a unha fase que estea configurada para enviar correo ao candidato, espera a que unha persoa o aprobe nunha ligazón, coa sesión iniciada en Flowmingo. O asistente non pode aprobalo, e un si escrito no chat non conta. A configuración de correo da fase compróbase cando se solicita o movemento. Para unha nota, unha valoración, unha lista curta, unha etiqueta ou un movemento a unha fase que non está configurada para enviar correo ao candidato, o asistente ten instrucións de mostrarche unha vista previa primeiro e de proceder só cando aceptes, o que é unha instrución para el, non un bloqueo. Unha mensaxe que o teu cliente de IA mostra antes de executar unha ferramenta é propia do cliente e non é aprobación de Flowmingo: unha invitación, un rexeitamento feito coa acción Rexeitar e un movemento a unha fase con envío de correo seguen esperando a ligazón de aprobación, independentemente do que pida o cliente. Unha ligazón de aprobación caduca despois de 15 minutos, e unha solicitude para varios candidatos ou solicitudes (como máximo 50) é unha aprobación que lista a todos. Unha vez que un cambio está en espera, o asistente pode comprobar como vai, retirarlo mentres aínda espera e desfacer un cambio reversible (unha nota, unha valoración, unha marca de lista curta, unha etiqueta ou un movemento que non enviou correo a ninguén) dentro de 24 horas. Un desfacer non está sempre dispoñible: o cambio ten que volver cunha referencia de desfacer, rexistrar unha é o mellor esforzo, e un movemento para un candidato sen fase anterior non ten ningunha, así que o asistente debería comprobar e dicilo cando non haxa volta atrás. Un correo que se enviou non se pode desfacer. As ferramentas listadas baixo Crear e publicar son a excepción a todo isto, excepto delete_project: actúan de inmediato e non están en espera de aprobación. Unha eliminación e unha eliminación de proxecto non se poden desfacer. Todo está limitado á túa organización.

Lectura

Capacidade Que fai
Listar ofertas de emprego Navega polos roles abertos e pechados da túa organización.
Listar conxuntos de entrevistas e proxectos Ve as túas avaliacións (conxuntos de entrevistas) de todo tipo (entrevistas AI, role-plays, Skill Tests, Technical Tests, avaliacións de CV, Showcases e gravacións; cuestionarios cando os pidas) e os teus proxectos de contratación.
Listar o teu pipeline de candidatos Ver solicitudes por fase nun proxecto.
Ler resultados de avaliacións e puntuacións Saca resultados de todo tipo: entrevistas AI, role-plays, Skill Tests, Technical Tests, avaliacións de CV, Showcases, gravacións e cuestionarios. Cada resultado está etiquetado co seu tipo. Só algúns tipos levan unha puntuación AI: un Showcase e un cuestionario nunca se puntúan, e un Skill Test é unha porcentaxe.
Buscar un candidato Obter o nome, correo e CV dun candidato.
Buscar candidatos Atopar candidatos por nome ou correo.
Comparar candidatos Aliñar de 2 a 10 candidatos lado a lado. Necesita o permiso Read candidates ademais de Read hiring data.
Visión xeral de contratación O funil para todo o que a túa conexión pode alcanzar (toda a empresa, a menos que a chave fose creada por alguén limitado a algúns proxectos), ou estreitado cando pidas: solicitudes por fase, activos vs rexeitados e, para cada tipo de avaliación que teña resultados, resultados completados vs en curso e a puntuación media. Un proxecto estreita todas as contas, pero as súas contas de resultados cobren os resultados nas avaliacións vinculadas a ese proxecto, polo que un candidato doutro proxecto que comparta unha desas avaliacións tamén se pode contar. Unha avaliación estreita só as contas de resultados: as contas de fase e solicitudes quedan en todo o que a túa conexión pode alcanzar. Os tipos nunca se suman.
Principais candidatos Os resultados máis altos, ordenados por puntuación xeral. Cada tipo de avaliación clasifícase xunto a menos que pidas un tipo ou unha avaliación (conxunto de entrevistas).
Detalle de resultado de avaliación As puntuacións por competencia dun resultado máis o resumo AI, para os tipos que os teñen. Un Skill Test, un Technical Test, un Showcase e un cuestionario teñen pouco ou ningún.
Detalle de oferta de emprego O detalle completo dunha oferta de emprego individual.
Unha oferta de emprego está aberta ao público? (get_job_post_publication) Se calquera pode abrir a páxina pública dunha oferta de emprego: activa, aínda agardando a comprobación de contido AI, rexeitada por ela, marcada, apagada, ou o seu proxecto non está aberto. Tamén o seu enderezo público e o seu impulso (desactivado, flowmingo ou estendido). Necesita Read hiring data.
Próximas entrevistas Invitacións a calquera tipo de avaliación que foron enviadas ou están programadas e aínda non se completaron. Non é unha conta de todos os pendentes: unha invitación cuxo candidato foi lembrado, ou abriu ou fixo clic na ligazón, déixase fóra ata que o candidato comece, e tamén unha que fallou na entrega.

Escritura (protexida)

Capacidade Que fai
Invitar candidatos a unha avaliación Prepara as invitacións para unha entrevista AI, un role-play, un Skill Test ou un Technical Test, e espera a que unha persoa as aprobe nunha ligazón. Nada se envía antes. Unha avaliación e como máximo 50 candidatos por solicitude; un Skill Test ou un Technical Test necesita un proxecto e un correo para cada candidato, e un patrocinado pode debitar da carteira da túa organización cando un candidato o comeza.
Mover un candidato a outra fase Un movemento a unha fase que está configurada para enviar correo ao candidato normalmente espera a que unha persoa o aprobe nunha ligazón (a configuración de correo da fase lese unha vez, xusto antes do movemento, polo que unha configuración activada nese momento pode aínda deixar que un movemento envíe correo sen aprobación). Calquera outro movemento: o asistente ten instrucións de mostralo en vista previa e esperar o teu si, e normalmente pódese desfacer durante 24 horas, cando volveu cunha referencia de desfacer. Como máximo 50 solicitudes por solicitude.
Rexeitar unha solicitude Solicita aprobación nunha ligazón. Se unha persoa a aproba, Flowmingo tenta mover a solicitude á fase de Rexeitado do proxecto; comproba o resultado despois. Como máximo 50 solicitudes por solicitude.
Eliminar candidatos dun proxecto (remove_application) Necesita Manage pipeline. Solicita aprobación nunha ligazón. Se unha persoa a aproba, Flowmingo elimina as solicitudes do proxecto; o perfil do candidato queda no teu grupo de talento e noutros proxectos. Non é un rexeitamento e non hai desfacer. Como máximo 50 solicitudes por solicitude.
Engadir unha nota a un resultado O asistente ten instrucións de mostrar a nota proposta en vista previa e esperar o teu si antes de gardala. Unha nota pertence a un resultado de avaliación (de calquera tipo), non ao candidato como conxunto.
Valorar un resultado O asistente ten instrucións de mostrar a valoración en vista previa e esperar o teu si. A valoración aplícase a un resultado de avaliación.
Engadir a lista curta un resultado O asistente ten instrucións de mostrar o cambio de lista curta en vista previa e esperar o teu si. Aplícase a un resultado de avaliación.
Etiquetar / engadir a colección de talento O asistente ten instrucións de mostrar a etiqueta ou o cambio de colección de talento en vista previa e esperar o teu si.
Comprobar, retirar ou desfacer un cambio Comprobar onde está un cambio en espera (agardando, executado, fallado, expirado ou substituído por unha solicitude máis nova), retirar un que aínda agarda aprobación, ou desfacer un cambio reversible dentro de 24 horas, cando volveu cunha referencia de desfacer.

Crear e publicar (actúa de inmediato, excepto eliminar un proxecto)

Estas ferramentas crean cousas e ábrenas ao público. Compórtanse de xeito diferente ás escrituras protexidas anteriores:

  • Actúan de inmediato, excepto delete_project. Nada está en espera para que unha persoa o aprobe nunha ligazón, e ningunha delas envía correo a un candidato. delete_project espera a que un Propietario ou un Administrador o aprobe nunha ligazón.
  • O creador da chave debe ser un Propietario ou un Administrador, para cada ferramenta aquí excepto a cancelación, que só necesita Invite candidates. As ferramentas actúan cos permisos da persoa que creou a chave de API. Se esa persoa é un Membro, a chamada é rexeitada.
  • Dous permisos son optativos. Create hiring projects e Create assessments non se conceden por defecto. Co inicio de sesión (opción A), o asistente só os recibe se se cumpren ambas as dúas condicións: o cliente os lista polo seu nome ao conectarse e a clave API que pegas na páxina de consentimento os inclúe. Un cliente que non envía unha lista de permisos recibe os catro permisos estándar (Read hiring data, Read candidates, Manage pipeline, Invite candidates) que ten a clave, e ningún destes dous, polo que o asistente non ve as ferramentas que os requiren. Cunha clave estática (opción B), o asistente ve estas ferramentas independentemente dos permisos que teña a clave, e Flowmingo rexeita calquera chamada que a clave non permita.
  • Algunhas chamadas tardan un pouco. Publicar espera a comprobación de contido AI, ata uns 90 segundos. Crear un proxecto ou unha avaliación usa xeración AI e pode tardar máis (un Technical Test leva de 3 a 9 minutos). Cando a resposta di que o traballo aínda está pendente, o asistente chama de novo coa mesma chave de idempotencia para ler onde chegou. Un reintento nunca crea un segundo proxecto ou avaliación.
Capacidade Que fai
Crear un proxecto de contratación (create_project) Necesita Create hiring projects (opcional). Fai un proxecto cos seus catro fases predeterminadas e unha oferta de emprego escrita pola mesma IA que o panel, a partir dun título, a posición e unha descrición opcional. Por defecto tamén fai unha avaliación de CV e unha entrevista AI; o asistente pode nomear outras avaliacións, ou ningunha. A oferta de emprego actívase e faise pública unha vez que a comprobación de contido AI a aprobe, normalmente nun minuto. Limitado a 10 proxectos por minuto e 300 ao día para a túa empresa. A chave de idempotencia é opcional: cando se omite, fai unha a partir dos argumentos, polo que un reintento nunca crea un segundo proxecto.
Crear unha avaliación (create_assessment) Necesita Create assessments (opcional). Fai unha avaliación coa IA: unha entrevista AI, unha avaliación de CV, un Skill Test, un Showcase, un Technical Test ou un Role-play, a partir dun título de traballo e unha descrición opcional, nome, proxecto e idioma (unha etiqueta como en ou vi-VN; un Skill Test e un Technical Test ignoran o idioma). Anexa a un proxecto para que os candidatos poidan ser invitados a un Skill Test, un Technical Test ou un Showcase. A chave de idempotencia é opcional, como arriba.
Publicar unha oferta de emprego (publish_job_post) Necesita Create hiring projects. Activa a oferta de emprego e asegúrate de que a comprobación de contido AI se executou. A resposta di se a páxina está activa agora, aínda agardando a comprobación, ou rexeitada por ela. O proxecto de contratación debe estar activo.
Despublicar unha oferta de emprego (unpublish_job_post) Necesita Create hiring projects. Desactiva a oferta de emprego, para que a súa ligazón pública deixe de abrir. Por defecto o impulso tamén se desactiva (withdraw_boost é verdadeiro).
Impulsar unha oferta de emprego (boost_job_post) Necesita Create hiring projects. Establece o impulso a off, flowmingo ou extended. Impulsar é gratuíto. Aumentalo necesita a oferta activa, o seu proxecto activo, un logo e descrición da empresa, e a comprobación de contido AI; unha empresa pode aumentar 50 impulsos ao día.
Abrir, borrador ou arquivar un proxecto (set_project_state) Necesita Create hiring projects. Move un proxecto de contratación entre active, draft e archived. Os borradores e os arquivados pechan a ligazón do posto. Os datos dos candidatos consérvanse.
Cancelar unha invitación programada (cancel_scheduled_invite) Necesita Invite candidates. Cancela unha invitación que foi programada para máis tarde e aínda non se enviou, usando o ID de invitación do resultado de invitación. Ninguén recibe correo. A persoa queda na túa conta e no taboleiro do proxecto.
Eliminar un proxecto de contratación (delete_project) Necesita Create hiring projects (opcional). Só pide: non elimina de inmediato, solicita aprobación nunha ligazón, e nada se elimina ata que un Propietario ou un Administrador o aprobe. Só un proxecto activo pode eliminarse. Se unha persoa o aproba, Flowmingo elimina o proxecto e as súas ofertas de emprego; as súas solicitudes de candidatos non se eliminan unha a unha, e os perfís e contactos de candidatos, as túas avaliacións e ligazóns de invitación consérvanse. Non hai desfacer.

Seguridade e confianza

  • Os teus datos están limitados á organización — o asistente nunca pode ver datos doutra empresa.
  • Con OAuth, o asistente nunca recibe a túa chave de API. Obtén un token de acceso que caduca despois dunha hora, refrescado silenciosamente mentres permanece conectado. O inicio de sesión en si dura tanto como o seu token de actualización, uns 30 días por defecto desde a súa emisión ou última actualización, polo que caduca despois duns 30 días sen uso, e entón inicias sesión de novo. Cunha cabeceira estática (opción B) o cliente do teu asistente garda a túa chave e envíaa con cada solicitude, así que mantéñaa fóra de ficheiros que poidas compartir ou commit.
  • Cortar a un asistente: elimina a chave de API coa que o autorizaches, en Configuración → Integracións → Chaves de API. O acceso detense inmediatamente. Non hai desconexión por asistente aínda, así que se queres revogalos un a un, dálle a cada asistente a súa propia chave.
  • As solicitudes ao endpoint /mcp son comprobadas pola súa orixe: unha orixe opaca null sempre é rexeitada, e a comprobación pode bloquearse a unha lista de permitidos, pero por defecto toda orixe real é aceptada, así que a protección é a túa credencial, non a orixe. Cada sesión está vinculada á credencial que a abriu.

Para saber como autenticarte, consulta Autenticación — dúas opcións; para as lecturas exactas, escrituras protexidas e accións que ocorren de inmediato, consulta O que podes facer. Cando esteas listo, salta a Conecta o teu asistente e escolle o teu cliente.

URL do servidor MCP

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

Conecta o teu asistente

Que asistente estás a usar?

Claude Code (CLI)

Un só comando engade Flowmingo sobre Streamable HTTP nativo. Lidera con OAuth; o --header estático é a alternativa.

Pasos: 1) engade o servidor, 2) inicia sesión (navegador → pega a clave), 3) claude mcp list para 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

Atención: as opcións deben ir antes do nome, e usa sempre --transport http (nunca sse). Substitúe fl_YOUR_KEY pola túa clave completa (consulta Que aspecto ten unha clave completa na sección Autenticación anterior).

Verifica que funciona — pregunta: "lista os meus empregos abertos."