Agente de IA y herramientas MCP

Por qué importa

Contratar es gestionar una cola. Las revisiones se acumulan, las candidaturas se quedan paradas y cinco candidatos necesitan el mismo «gracias, pero esta vez no» escrito con tacto. Kit expone el módulo Hiring a los asistentes de IA por dos vías: el agente integrado que vive en cada página de Hiring, y herramientas MCP que cualquier cliente externo (Claude Desktop, Claude Code, Codex CLI o tus propios agentes) puede invocar contra tu cuenta.

No hace falta ser administrador de la cuenta para conectarte. Cualquiera con acceso a Hiring puede configurar un cliente MCP y apuntarlo a Kit. Conectar es un acto personal, como instalar una aplicación en tu propio portátil: lo que el asistente alcanza después lo deciden tus permisos en cada llamada, no quién hizo la configuración.

Ambas superficies aplican las mismas reglas que la interfaz: permisos de módulo, acceso por oferta, aislamiento por cuenta y todas las barreras del ciclo de vida que imponen los formularios. Un asistente actúa como tú. Nunca puede llegar a una oferta de empleo que tú no puedas abrir, ni hacer algo que la interfaz web te negaría.

El asistente integrado

Abre el chat de IA en cualquier página bajo Hiring: se activa automáticamente, junto a los agentes de Security y Outreach. Puede:

Atender tu cola — «¿Qué tengo pendiente hoy?» devuelve tus revisiones abiertas y cualquier revisión del equipo que terminó sin un resultado claro, cada una con el candidato, la etapa y cuánto tiempo lleva esperando.

Cribar candidatos — «Resume a los 3 mejores candidatos del puesto de Rails sénior» recupera los resúmenes de candidatura, los campos de datos de candidatos extraídos y el texto del CV, y los clasifica frente a la oferta.

Mover el pipeline — hacer avanzar a un candidato a la siguiente etapa, rechazarlo con una nota personalizada o revertir un rechazo. Cada acción queda atribuida a ti y aparece en el historial de auditoría.

Redactar respuestas a candidatos — el agente deja el correo preparado como borrador pendiente. Nada sale de Kit hasta que una persona lo envía.

Responder preguntas sobre la plataforma — el agente busca en la documentación de Kit sobre la marcha.

Referencia de herramientas MCP

Qué permite tu rol

Se acumulan tres límites independientes, y una llamada a una herramienta tiene que superarlos todos:

1. Los ámbitos de la conexión. Cuando autorizas un cliente eliges, módulo a módulo, entre lectura o lectura y escritura. Una conexión con solo hiring_read no puede escribir, seas quien seas. La escritura está desactivada de forma predeterminada en la pantalla de consentimiento.
2. Tu propio nivel en Hiring. Kit vuelve a leer tu nivel por módulo en cada llamada, así que un cambio en tu acceso surte efecto de inmediato, no en la siguiente renovación del token. Un miembro sin acceso a Hiring no obtiene ninguna herramienta de contratación. Dentro de Hiring llegas a las mismas ofertas que alcanzarías en el navegador: las no restringidas, más aquellas en cuyo equipo estés. Una oferta restringida devuelve «no encontrada», igual que un ID inventado.
3. Administración del módulo y suscripción. Un puñado de herramientas están reservadas a los administradores de Hiring: crear ofertas de empleo y plantillas de proceso, y cambiar la configuración de descarga de CV. Definir y editar metacampos sigue la misma regla que la aplicación web: los administradores de Hiring más los responsables de contratación de esa oferta concreta. Además, la mayoría de las herramientas de escritura exigen una suscripción activa.

El rol predefinido recruiter otorga administración de Hiring, así que un reclutador dispone de todo el conjunto de herramientas de contratación sin ser administrador de la cuenta en ningún otro sitio. Consulta Roles de equipo para ver qué concede cada rol predefinido.

En la columna Requiere de las tablas siguientes: lectura significa cualquier miembro de Hiring con un ámbito de lectura; escritura significa que la conexión necesita lectura y escritura; administrador de Hiring significa administración del módulo Hiring; admin o responsable significa administrador de Hiring o responsable de contratación de esa oferta; suscripción significa un plan activo.

Configuración y plantillas

Herramienta	Requiere	Qué hace
hiring_get_setup_guide	lectura	Empieza aquí. Estado de la cuenta, qué permite tu rol, una lista de comprobación de configuración con la herramienta que resuelve cada carencia, y la siguiente llamada recomendada
hiring_list_templates	lectura	Plantillas de proceso de contratación disponibles en la cuenta, con sus etiquetas y su estado de publicación
hiring_get_template	lectura	Una plantilla al completo: cada etapa, su tipo y su configuración
hiring_create_process_template	escritura · administrador de Hiring	Crea una plantilla de proceso reutilizable a partir de una lista de etapas, con revisores opcionales por etapa

Ofertas de empleo

Herramienta	Requiere	Qué hace
hiring_list_job_postings	lectura	Las ofertas a las que tienes acceso, con estado, recuento de candidaturas y resumen de etapas
hiring_get_job_posting	lectura	Una oferta al completo: cuerpo, etapas con su configuración, revisores y URL del portal
hiring_create_job_posting	escritura · administrador de Hiring · suscripción	Crea una oferta en borrador aplicando una plantilla o etapas en línea. Devuelve la URL de edición
hiring_list_metafield_definitions	lectura	Los campos de datos personalizados definidos en una oferta, con sus tipos y sus ajustes de extracción. Los campos solo para responsables aparecen únicamente para los admins y los responsables de contratación de la oferta
hiring_create_metafield_definition	escritura · admin o responsable	Añade un metacampo a una oferta, opcionalmente marcado para extracción por IA o restringido solo a responsables

Pipeline

Herramienta	Requiere	Qué hace
hiring_list_applications	lectura	Candidaturas enviadas, filtrables por oferta, estado y rango de fechas
hiring_get_application_summary	lectura	Todo lo necesario para cribar una candidatura: candidato, respuestas, historial de etapas y notas
hiring_get_stage_details	lectura	El detalle propio del tipo de etapa: ejercicio de código, entrevista, vídeo o portafolio
hiring_search_video_transcripts	lectura	Búsqueda semántica y de texto en las transcripciones de entrevistas en vídeo
hiring_get_metafield_values	lectura	Valores de campo extraídos y manuales de una candidatura, con sus puntuaciones de confianza. Los campos solo para responsables aparecen únicamente para los admins y los responsables de contratación de la oferta
hiring_advance_application	escritura · suscripción	Mueve una candidatura a la siguiente etapa, o salta directamente a una concreta
hiring_reject_application	escritura · suscripción	Rechaza una candidatura. Se envía un correo al candidato, con tu mensaje personalizado si lo indicas
hiring_unreject_application	escritura · suscripción	Revierte un rechazo, con un motivo de auditoría obligatorio
hiring_save_note	escritura · suscripción	Guarda comentarios o el resumen de un hilo en una candidatura, atribuido a ti
hiring_update_metafield_value	escritura · admin o responsable	Fija el valor de un campo a mano; queda registrado como edición tuya y protegido frente a nuevas extracciones
hiring_trigger_metafield_extraction	escritura · admin o responsable	Vuelve a ejecutar la extracción por IA sobre el currículum de una candidatura

Revisiones

Herramienta	Requiere	Qué hace
hiring_list_reviews	lectura	Tu bandeja de revisiones, dividida en lo que necesita una decisión, lo que debes tú y lo que está pendiente de otros
hiring_get_review_details	lectura	Todo lo que un revisor necesita para un candidato en una etapa: criterios, entregas y puntuaciones previas
hiring_list_pending_decisions	lectura	Revisiones del equipo que terminaron sin un resultado claro: voto dividido o sin quórum
hiring_decide_review	escritura · suscripción	Registra una decisión atribuida y auditada sobre una revisión del equipo atascada, con justificación obligatoria

Bolsa de talento

Herramienta	Requiere	Qué hace
hiring_list_talent_pool	lectura	Entradas verificadas de la bolsa de talento con resúmenes compactos del currículum, paginadas
hiring_search_talent_pool	lectura	Busca en la bolsa por habilidades, experiencia o correo — semántica con respaldo de texto
hiring_invite_talent_pool	escritura · suscripción	Invita a una entrada de la bolsa a presentar candidatura a una oferta concreta

Mensajes

Herramienta	Requiere	Qué hace
hiring_list_messages	lectura	El hilo de correo completo entre tu equipo y un candidato
hiring_send_message	escritura · suscripción	Deja una respuesta preparada como borrador pendiente. No se envía ningún correo al candidato hasta que lo hace una persona

Candidatos y CV

Herramienta	Requiere	Qué hace
hiring_get_candidate_summary	lectura	Un candidato con todas las candidaturas que te ha presentado
hiring_get_candidate_cv	lectura	El texto del currículum extraído de un candidato o de una entrada de la bolsa de talento
hiring_get_candidate_cv_url	lectura	Una URL de descarga firmada y de vida corta para el archivo original: cinco minutos por defecto, diez como máximo
hiring_get_cv_download_settings	lectura	La configuración de confianza de la cuenta para descargar CV: dominios de confianza, modo estricto y qué significa en la práctica
hiring_update_cv_download_settings	escritura · administrador de Hiring · suscripción	Añade o quita dominios de confianza, o activa y desactiva el modo estricto

Los registros se direccionan con IDs prefijados (job_… ofertas, app_… candidaturas, cand_… candidatos, tpe_… entradas de la bolsa de talento) que las herramientas devuelven y aceptan, de modo que un agente encadena listar → consultar → actuar sin capturar pantallas.

Límites

• Los mensajes a candidatos son correos reales a personas reales. hiring_send_message se detiene a propósito en un borrador pendiente: no existe ninguna ruta MCP que deje un correo en la bandeja de un candidato sin que una persona pulse enviar. hiring_reject_application sí escribe al candidato, sujeto al periodo de espera de rechazo de tu cuenta; trátalo como un envío, no como un cambio de estado.
• El acceso a los CV sigue la configuración de descarga de CV de la cuenta. hiring_get_candidate_cv_url emite una URL firmada con las mismas reglas de confianza que aplica el navegador: dominios de confianza, modo estricto y el acceso propio de tu equipo. Activar el modo estricto reduce lo que la herramienta te devolverá.
• Las ofertas restringidas son invisibles, no prohibidas. Una oferta de la que estás excluido devuelve «no encontrada» en lugar de «acceso denegado», así que no se filtra nada sobre ella, ni siquiera si existe.
• Ningún agente puede ascenderse a sí mismo. Nada del conjunto de herramientas de contratación cambia el rol, el nivel de acceso ni la pertenencia a módulos de nadie.

Conectar un cliente externo

La configuración vive en Integraciones > Kit para IA, con los ajustes listos para copiar y pegar por cliente. No hace falta acceso de administrador para abrirla. Para Claude Code:

claude mcp add --transport http kit https://startupkit.app/api/v1/mcp

En el primer uso, tu cliente recorre el flujo OAuth de Kit en el navegador. Elige la cuenta y concede hiring_read para el triaje y los informes, y hiring_write solo a los asistentes que deban actuar en tu nombre. Los módulos a los que no tienes acceso aparecen en la pantalla de consentimiento marcados como ajenos a tu rol: concederlos no emite nada utilizable.

La configuración completa de cada cliente, el flujo OAuth y la purga por 90 días de inactividad se explican en Conectar asistentes de IA.

Ejemplos de peticiones

Lo que escribes	Lo que ocurre
«¿Qué tengo pendiente hoy?»	hiring_list_reviews + hiring_list_pending_decisions → tus revisiones abiertas y todas las decisiones de equipo atascadas, las más antiguas primero
«Resume a los 3 mejores candidatos del puesto de Rails sénior»	hiring_list_applications → hiring_get_application_summary → hiring_get_candidate_cv → una preselección ordenada con las pruebas que sustentan cada posición
«Mueve a Priya Raman a la etapa de entrevista técnica»	hiring_get_application_summary → hiring_advance_application → el candidato avanza y recibe el aviso, con la acción atribuida a ti
«Redacta un rechazo cordial para todos los que lleven 3 semanas o más parados en el cribado; enséñamelo antes de enviarlo»	hiring_list_applications → un borrador por candidato en el chat; no se envía nada hasta que apruebes cada hiring_reject_application
«¿Quién de la bolsa de talento encaja con esta oferta?»	hiring_get_job_posting → hiring_search_talent_pool → coincidencias con sus motivos, y luego hiring_invite_talent_pool cuando tú lo digas
«¿Por qué descartamos a este candidato el año pasado?»	hiring_get_candidate_summary → todas sus candidaturas anteriores, la etapa a la que llegó y las notas adjuntas

En resumen

• Prueba el agente integrado en Hiring: «¿Qué tengo pendiente hoy?»
• Conecta tu cliente MCP en Integraciones > Kit para IA — no hace falta acceso de administrador
• Concede hiring_read con amplitud; reserva hiring_write para los asistentes en los que confías para actuar
• Pide primero hiring_get_setup_guide: le dice al agente qué permite tu rol antes de que planifique
• Encadena el flujo de triaje: listar revisiones → obtener el detalle de la revisión → avanzar o rechazar
• Confirma la configuración de descarga de CV de tu cuenta antes de apuntar un agente a los currículums

Y ahora qué

• Conectar asistentes de IA — configuración MCP completa, flujo OAuth y configuraciones por cliente
• Referencia de herramientas MCP — todas las herramientas de todos los módulos, con sus ámbitos
• Gestionar tu pipeline — las etapas y decisiones que impulsan estas herramientas
• Roles de equipo — qué concede cada rol predefinido, incluido recruiter