## 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](/hiring/job_postings): 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](/docs/candidate-data-fields) 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](/docs/team-roles) 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](/docs/ai-extraction) 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](/integrations/mcp/settings), 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](/docs/connecting-ai-assistants).

## 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](/hiring/job_postings): «¿Qué tengo pendiente hoy?»
- [ ] Conecta tu cliente MCP en [Integraciones > Kit para IA](/integrations/mcp/settings) — 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](/docs/candidate-data-fields) de tu cuenta antes de apuntar un agente a los currículums

## Y ahora qué

- [Conectar asistentes de IA](/docs/connecting-ai-assistants) — configuración MCP completa, flujo OAuth y configuraciones por cliente
- [Referencia de herramientas MCP](/docs/mcp-tools-reference) — todas las herramientas de todos los módulos, con sus ámbitos
- [Gestionar tu pipeline](/docs/managing-your-pipeline) — las etapas y decisiones que impulsan estas herramientas
- [Roles de equipo](/docs/team-roles) — qué concede cada rol predefinido, incluido `recruiter`