Integraciones

Conectar Asistentes de IA (MCP)

Conecta cualquier asistente de IA compatible con MCP — Claude, Claude Code, ChatGPT, Cursor, VS Code y más — a tus datos de contratación de Flowmingo, y trabaja tu pipeline en lenguaje natural.

Our team is online
¿Necesitas ayuda con la integración?

¿Te quedaste atascado en algún paso o necesitas asistencia técnica? Nuestro equipo estará encantado de ayudarte — escríbenos cuando quieras y te pondremos en contacto.

Resumen

Conecta cualquier asistente de IA compatible con MCP a tus datos de contratación de Flowmingo: lee tus puestos y candidatos y realiza acciones protegidas (invitar, mover, rechazar, eliminar de un proyecto) de forma segura y con tu permiso. Con dos permisos adicionales que activas tú mismo, un asistente también puede crear proyectos de contratación y evaluaciones, y publicar, cerrar o impulsar una oferta de empleo (consulta Qué puedes hacer). ¿Nuevo en MCP? Es el estándar abierto que permite a los asistentes de IA hablar con herramientas como Flowmingo. Aprende qué es MCP.

Transporte: Streamable HTTP (el transporte remoto moderno). No hay SSE heredado: apunta siempre tu cliente a /mcp, nunca a /sse.

Trata tu clave de API como una contraseña. Prefiere OAuth, una entrada solicitada o una variable de entorno antes que pegar una clave fl_... en un archivo que puedas enviar a git (por ejemplo, .vscode/mcp.json, ~/.cursor/mcp.json, tu configuración de Continue).

Autenticación: dos opciones

A — Inicia sesión con Flowmingo (OAuth, recomendado). Tu navegador abre una página de consentimiento de Flowmingo; pegas tu clave de API allí. El asistente nunca recibe tu clave. Recibe un token de acceso y un token de actualización, que puede usar para obtener un nuevo token de acceso. El inicio de sesión no dura para siempre. El token de actualización dura unos 30 días por defecto, contados desde que se emitió, al iniciar sesión o en la última renovación, por lo que un inicio de sesión que no se use durante ese tiempo caduca, y una versión de Flowmingo que cambie cómo se almacenan los inicios de sesión puede requerir que vuelvas a iniciar sesión. Entonces el asistente te pedirá que inicies sesión de nuevo y volverás a pegar tu clave. Para cortarlo antes, elimina esa clave de API. No hay ID de cliente ni secreto que crear (Flowmingo usa Dynamic Client Registration). En clientes que muestran ajustes OAuth "Avanzados" (por ejemplo, Claude.ai), deja el ID de cliente y el secreto en blanco.

B — Clave de API estática (cabecera). Envía tu clave como cualquiera de estas cabeceras:

x-api-key: fl_YOUR_KEY
Authorization: Bearer fl_YOUR_KEY

Obtén tu clave en Flowmingo → Ajustes → Integraciones → Claves de API. Marca Read hiring data y Read candidates — la primera cubre puestos, pipeline y resultados; la segunda permite que un asistente busque a alguien. Añade Manage pipeline / Invite candidates para las acciones de escritura protegidas. Para permitir que un asistente cree proyectos y evaluaciones y publique o impulse una oferta, también marca Create hiring projects y Create assessments. Lee primero Crear y publicar en Qué puedes hacer: estos dos permisos son opcionales y el creador de la clave debe ser un Propietario o un Administrador.

Cómo es una clave completa. Un valor largo: fl_live_, el nombre público de la clave, un punto, y luego un secreto largo. La mitad secreta se muestra una vez, justo después de crear la clave; más tarde la lista de Claves de API solo muestra el principio. Un valor sin punto es solo el nombre de la clave y será rechazado. Donde esta guía escriba fl_YOUR_KEY, reemplázalo todo por tu clave completa, sin comillas ni espacios.

Si no conecta. Una clave incorrecta o vacía devuelve Missing credential o The Flowmingo API key was rejected; ambos pueden significar que el valor nunca llegó completo, así que verifica el valor primero. Un ajuste como ${env:FLOWMINGO_API_KEY} solo funciona si el programa puede ver esa variable, y un editor abierto desde el dock o el menú Inicio a menudo no lee tu perfil de terminal. O bien inícialo desde una terminal donde la variable esté definida, o pon tu clave completa en el archivo (y mantén ese archivo fuera de git).

¿Cuál elegir? La mayoría de los clientes admiten ambas; algunos (por ejemplo, ChatGPT) son solo OAuth — cada pestaña indica qué admite ese cliente. En general, OAuth es adecuado para asistentes interactivos (Claude.ai, ChatGPT, VS Code); la cabecera de clave de API es adecuada para CLI, headless/CI y editores donde prefieres insertar una clave.

Qué puedes hacer

Las lecturas no necesitan aprobación. La mayoría de las escrituras están protegidas. Una invitación, un rechazo hecho con la acción Rechazar, una eliminación de candidatos de un proyecto, una eliminación de proyecto o, normalmente, un movimiento a una etapa que esté configurada para enviar un correo al candidato, espera a que una persona lo apruebe en un enlace, con sesión iniciada en Flowmingo. El asistente no puede aprobarlo, y un "sí" escrito en el chat no cuenta. El ajuste de correo de la etapa se comprueba cuando se solicita el movimiento. Para una nota, una calificación, una lista corta, una etiqueta o un movimiento a una etapa que no esté configurada para enviar un correo, se le indica al asistente que te muestre una vista previa primero y que proceda solo cuando estés de acuerdo, lo cual es una instrucción para él, no un bloqueo. Un aviso que tu cliente de IA muestra antes de ejecutar una herramienta es propio del cliente y no es la aprobación de Flowmingo: una invitación, un rechazo hecho con la acción Rechazar y un movimiento a una etapa que envía correos aún esperan el enlace de aprobación, sin importar lo que pida el cliente. Un enlace de aprobación caduca después de 15 minutos, y una solicitud para varios candidatos o solicitudes (como máximo 50) es una aprobación que los lista a todos. Una vez que un cambio está en espera, el asistente puede comprobar su estado, retirarlo mientras aún espera y deshacer un cambio reversible (una nota, una calificación, una marca de lista corta, una etiqueta o un movimiento que no haya enviado un correo a nadie) dentro de las 24 horas. Deshacer no siempre está disponible: el cambio debe devolver una referencia de deshacer, registrarla es un esfuerzo máximo, y un movimiento para un candidato sin etapa anterior no la tiene, por lo que el asistente debe comprobarlo y decirlo cuando no haya vuelta atrás. Un correo que se ha enviado no se puede deshacer. Las herramientas listadas bajo Crear y publicar son la excepción a todo esto, excepto delete_project: actúan de inmediato y no se ponen en espera para aprobación. Una eliminación y un borrado de proyecto no se pueden deshacer. Todo está limitado a tu organización.

Lectura

Capacidad Qué hace
Listar ofertas de empleo Explora los puestos abiertos y cerrados de tu organización.
Listar conjuntos de entrevistas y proyectos Ve tus evaluaciones (conjuntos de entrevistas) de todo tipo (entrevistas de IA, role-plays, pruebas de habilidades, pruebas técnicas, evaluaciones de CV, showcases y grabaciones; cuestionarios cuando los pidas) y tus proyectos de contratación.
Listar tu pipeline de candidatos Ve las solicitudes por etapa en un proyecto.
Leer resultados y puntuaciones de evaluaciones Obtén resultados de todo tipo: entrevistas de IA, role-plays, pruebas de habilidades, pruebas técnicas, evaluaciones de CV, showcases, grabaciones y cuestionarios. Cada resultado está etiquetado con su tipo. Solo algunos tipos llevan una puntuación de IA: un showcase y un cuestionario nunca se puntúan, y una prueba de habilidades es un porcentaje.
Buscar un candidato Obtén el nombre, correo electrónico y CV de un candidato.
Buscar candidatos Encuentra candidatos por nombre o correo electrónico.
Comparar candidatos Coloca de 2 a 10 candidatos lado a lado. Necesita el permiso Read candidates además de Read hiring data.
Visión general de contratación El embudo para todo lo que tu conexión puede alcanzar (toda la empresa, a menos que la clave la haya creado alguien limitado a algunos proyectos), o reducido cuando lo pidas: solicitudes por etapa, activas vs. rechazadas, y, para cada tipo de evaluación con resultados, completados vs. en progreso y la puntuación media. Un proyecto reduce todos los recuentos, pero sus recuentos de resultados cubren los resultados de las evaluaciones vinculadas a ese proyecto, por lo que un candidato de otro proyecto que comparta una de esas evaluaciones también puede contarse. Una evaluación reduce solo los recuentos de resultados: los recuentos de etapas y solicitudes permanecen en todo lo que tu conexión puede alcanzar. Los tipos nunca se suman entre sí.
Mejores candidatos Los resultados mejor clasificados, ordenados por puntuación general. Todos los tipos de evaluación se clasifican juntos a menos que pidas un tipo o una evaluación (conjunto de entrevistas).
Detalle de resultado de evaluación Las puntuaciones por competencia de un resultado más el resumen de IA, para los tipos que los tienen. Una prueba de habilidades, una prueba técnica, un showcase y un cuestionario tienen poco o nada.
Detalle de oferta de empleo El detalle completo de una sola oferta de empleo.
¿Está una oferta abierta al público? (get_job_post_publication) Si alguien puede abrir la página pública de una oferta: en vivo, aún esperando la revisión de contenido de IA, rechazada por ella, marcada, desactivada, o su proyecto no está abierto. También su dirección pública y su impulso (off, flowmingo o extendido). Necesita Read hiring data.
Próximas entrevistas Invitaciones a cualquier tipo de evaluación que se enviaron o están programadas y aún no se han completado. No es un recuento de todos los pendientes: una invitación cuyo candidato ha sido recordado, o ha abierto o hecho clic en el enlace, se omite hasta que el candidato comienza, y también la que no se pudo entregar.

Escritura (protegida)

Capacidad Qué hace
Invitar candidatos a una evaluación Prepara las invitaciones para una entrevista de IA, un role-play, una prueba de habilidades o una prueba técnica, y espera a que una persona las apruebe en un enlace. No se envía nada antes de eso. Una evaluación y como máximo 50 candidatos por solicitud; una prueba de habilidades o una prueba técnica necesita un proyecto y un correo para cada candidato, y una patrocinada puede cargar a la billetera de tu organización cuando un candidato la comienza.
Mover un candidato a otra etapa Un movimiento a una etapa que esté configurada para enviar un correo al candidato normalmente espera a que una persona lo apruebe en un enlace (el ajuste de correo de la etapa se lee una vez, justo antes del movimiento, por lo que un ajuste activado en ese momento aún puede permitir que un movimiento envíe un correo sin aprobación). Cualquier otro movimiento: se le indica al asistente que lo vea y espere tu "sí", y generalmente se puede deshacer durante 24 horas, cuando devuelva una referencia de deshacer. Como máximo 50 solicitudes por solicitud.
Rechazar una solicitud Solicita aprobación en un enlace. Si una persona lo aprueba, Flowmingo intenta mover la solicitud a la etapa Rechazado del proyecto; comprueba el resultado después. Como máximo 50 solicitudes por solicitud.
Eliminar candidatos de un proyecto (remove_application) Necesita Manage pipeline. Solicita aprobación en un enlace. Si una persona lo aprueba, Flowmingo elimina las solicitudes del proyecto; el perfil del candidato permanece en tu pool de talento y en otros proyectos. No es un rechazo y no hay deshacer. Como máximo 50 solicitudes por solicitud.
Añadir una nota a un resultado Se le indica al asistente que vea la nota propuesta y espere tu "sí" antes de guardarla. Una nota pertenece a un resultado de evaluación (de cualquier tipo), no al candidato en general.
Puntuar un resultado Se le indica al asistente que vea la puntuación y espere tu "sí". La puntuación se aplica a un resultado de evaluación.
Poner en lista corta un resultado Se le indica al asistente que vea el cambio de lista corta y espere tu "sí". Se aplica a un resultado de evaluación.
Etiquetar / añadir a colección de talento Se le indica al asistente que vea el cambio de etiqueta o colección de talento y espere tu "sí".
Comprobar, retirar o deshacer un cambio Comprueba dónde está un cambio en espera (esperando, realizado, fallido, caducado o reemplazado por una solicitud más reciente), retira uno que aún espera aprobación o deshaz un cambio reversible dentro de las 24 horas, cuando devuelva una referencia de deshacer.

Crear y publicar (actúa de inmediato, excepto eliminar un proyecto)

Estas herramientas crean cosas y las abren al público. Se comportan de manera diferente a las escrituras protegidas anteriores:

  • Actúan de inmediato, excepto delete_project. Nada se pone en espera para que una persona lo apruebe en un enlace, y ninguna envía un correo a un candidato. delete_project espera a que un Propietario o un Administrador lo apruebe en un enlace.
  • El creador de la clave debe ser un Propietario o un Administrador, para cada herramienta aquí excepto la cancelación, que solo necesita Invite candidates. Las herramientas actúan con los permisos de la persona que creó la clave de API. Si esa persona es un Miembro, la llamada se rechaza.
  • Dos permisos son opcionales. Create hiring projects y Create assessments no se otorgan por defecto. Con el inicio de sesión (opción A), el asistente los obtiene solo si se cumplen ambas condiciones: el cliente los enumera por su nombre al conectarse, y la clave API que pegas en la página de consentimiento los incluye. Un cliente que no envía una lista de permisos obtiene los cuatro permisos estándar (Read hiring data, Read candidates, Manage pipeline, Invite candidates) que tiene la clave, y ninguno de estos dos, por lo que el asistente no ve las herramientas que los necesitan. Con una clave estática (opción B), el asistente ve estas herramientas independientemente de los permisos que tenga la clave, y Flowmingo rechaza cualquier llamada que la clave no permita.
  • Algunas llamadas tardan un tiempo. Publicar espera la revisión de contenido de IA, hasta unos 90 segundos. Crear un proyecto o una evaluación usa generación de IA y puede tardar más (una prueba técnica tarda de 3 a 9 minutos). Cuando la respuesta dice que el trabajo aún está pendiente, el asistente vuelve a llamar con la misma clave de idempotencia para leer dónde ha llegado. Un reintento nunca crea un segundo proyecto o evaluación.
Capacidad Qué hace
Crear un proyecto de contratación (create_project) Necesita Create hiring projects (opcional). Crea un proyecto con sus cuatro etapas por defecto y una oferta de empleo escrita por la misma IA que el panel, a partir de un título, el puesto y una descripción opcional. Por defecto también crea una Evaluación de CV y una Entrevista de IA; el asistente puede nombrar otras evaluaciones, o ninguna. La oferta se activa y se vuelve pública una vez que la revisión de contenido de IA la aprueba, normalmente en un minuto. Limitado a 10 proyectos por minuto y 300 al día para tu empresa. La clave de idempotencia es opcional: cuando se omite, se crea una a partir de los argumentos, por lo que un reintento nunca crea un segundo proyecto.
Crear una evaluación (create_assessment) Necesita Create assessments (opcional). Crea una evaluación con la IA: una Entrevista de IA, una Evaluación de CV, una Prueba de Habilidades, un Showcase, una Prueba Técnica o un Role-play, a partir de un título de puesto y una descripción de puesto opcional, nombre, proyecto e idioma (una etiqueta como en o vi-VN; una Prueba de Habilidades y una Prueba Técnica ignoran el idioma). Adjúntala a un proyecto para que los candidatos puedan ser invitados a una Prueba de Habilidades, una Prueba Técnica o un Showcase. La clave de idempotencia es opcional, como antes.
Publicar una oferta de empleo (publish_job_post) Necesita Create hiring projects. Activa la oferta y asegura que la revisión de contenido de IA se haya ejecutado. La respuesta indica si la página está en vivo ahora, aún esperando la revisión, o rechazada por ella. El proyecto de contratación debe estar activo.
Despublicar una oferta de empleo (unpublish_job_post) Necesita Create hiring projects. Desactiva la oferta, por lo que su enlace público deja de abrir. Por defecto, el impulso también se desactiva (withdraw_boost es true).
Impulsar una oferta de empleo (boost_job_post) Necesita Create hiring projects. Establece el impulso en off, flowmingo o extended. Impulsar es gratis. Aumentarlo requiere que la oferta esté activada, su proyecto activo, un logotipo y descripción de empresa, y la revisión de contenido de IA; una empresa puede aumentar 50 impulsos al día.
Abrir, borrador o archivar un proyecto (set_project_state) Necesita Create hiring projects. Mueve un proyecto de contratación entre active, draft y archived. Los borradores y archivados cierran el enlace de la oferta. Los datos de los candidatos se conservan.
Cancelar una invitación programada (cancel_scheduled_invite) Necesita Invite candidates. Cancela una invitación que estaba programada para más tarde y aún no se ha enviado, usando el id de invitación del resultado de invitación. No se envía un correo a nadie. La persona permanece en tu cuenta y en el tablero del proyecto.
Eliminar un proyecto de contratación (delete_project) Necesita Create hiring projects (opcional). Solo solicita: no elimina de inmediato, solicita aprobación en un enlace, y nada se elimina hasta que un Propietario o un Administrador lo apruebe. Solo se puede eliminar un proyecto activo. Si una persona lo aprueba, Flowmingo elimina el proyecto y sus ofertas de empleo; sus solicitudes de candidatos no se eliminan una por una, y los perfiles y contactos de candidatos, tus evaluaciones y enlaces de invitación se conservan. No hay deshacer.

Seguridad y confianza

  • Tus datos están limitados a la organización: el asistente nunca puede ver datos de otra empresa.
  • Con OAuth, el asistente nunca recibe tu clave de API. Obtiene un token de acceso que caduca después de una hora, renovado silenciosamente mientras esté conectado. El inicio de sesión en sí dura tanto como su token de actualización, unos 30 días por defecto desde que se emitió o se actualizó por última vez, por lo que caduca después de unos 30 días sin uso, y entonces vuelves a iniciar sesión. Con una cabecera estática (opción B), el cliente de tu asistente tiene tu clave y la envía con cada solicitud, así que mantenla fuera de archivos que puedas compartir o enviar a git.
  • Cortar la conexión de un asistente: elimina la clave de API con la que lo autorizaste, en Ajustes → Integraciones → Claves de API. El acceso se detiene de inmediato. Aún no hay desconexión por asistente, así que si quieres revocarlos uno a uno, da a cada asistente su propia clave.
  • Las solicitudes al endpoint /mcp se verifican por su Origen: un origen null opaco siempre se rechaza, y la verificación se puede bloquear a una lista de permitidos, pero por defecto se acepta cualquier origen real, así que la protección es tu credencial, no el origen. Cada sesión está vinculada a la credencial que la abrió.

Para saber cómo autenticarte, consulta Autenticación: dos opciones; para las lecturas exactas, escrituras protegidas y acciones que ocurren a la vez, consulta Qué puedes hacer. Cuando estés listo, salta a Conecta tu asistente y elige tu cliente.

URL del servidor MCP

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

Conecta tu asistente

¿Qué asistente estás usando?

Claude Code (CLI)

Un solo comando añade Flowmingo sobre Streamable HTTP nativo. Lidera con OAuth; el --header estático es la alternativa.

Pasos: 1) añade el servidor, 2) inicia sesión (navegador → pega la 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: las banderas deben ir antes del nombre, y usa siempre --transport http (nunca sse). Reemplaza fl_YOUR_KEY con tu clave completa (consulta Cómo es una clave completa en la sección de Autenticación anterior).

Verifica que funciona — pregunta: "lista mis trabajos abiertos."