Bizneo MCP

Qué hace

Cuando un asistente de inteligencia artificial necesita consultar o gestionar información del ATS (Bizneo), este flujo actúa como puente para ejecutar esas acciones. Permite buscar perfiles de candidatos por email o por etiquetas, consultar el listado de etiquetas de la empresa, crear o editar etiquetas, y asignárselas a un candidato específico. El resultado queda reflejado directamente en los perfiles y etiquetas dentro de Bizneo.

Cuándo se rompe

• Si el asistente intenta crear o actualizar una etiqueta y la operación falla: significa que se intentó usar un color no permitido por el sistema o que el identificador de la etiqueta ya no existe en Bizneo.
• Si una búsqueda de candidato no arroja datos: significa que el email ingresado no coincide con ningún postulante registrado o que el candidato no tiene asociadas las etiquetas consultadas.
• Si el asistente no logra ejecutar ninguna consulta o modificación: significa que las credenciales de conexión con Bizneo o los permisos de acceso al servidor MCP expiraron o son inválidos.

Detalle técnico

• Expone un servidor MCP mediante el nodo MCP Server Trigger configurado con autenticación Bearer.
• Consume la API v3 de Bizneo ATS (https://ats.bizneo.com/api/v3/companies/171404/).
• La herramienta getCandidatesBetweenDates se encuentra desconectada del trigger principal en el workflow, por lo que el agente no tiene acceso a ella.
• Los nodos createCompanyTags y updateCompanyTags reciben parámetros extraídos por IA ($fromAI), donde el campo color está restringido a default, green, yellow o red.
• La búsqueda de candidatos por etiqueta (getCandidatesbyTags) maneja paginación iterativa sobre el parámetro user[page] hasta que la respuesta de candidatos devuelve un arreglo vacío.

Diagrama

Ficha

| Abrir en n8n | rPmgi2zI4xlXj3jG |