Entrar

API y MCP.

Conecta tu asistente de IA o tus sistemas a los datos de tu empresa en Humana. Solo lectura. Incluido desde el plan Avanzado.

1. Crea una clave (opcional)

Claude y ChatGPT se conectan iniciando sesión, sin clave. La clave sirve para Claude Code, Cursor, VS Code y tus sistemas.

En Humana, ve a Configuración › Integraciones › API y MCP y elige Crear clave. Necesitas el permiso «Editar los datos y el logo de la empresa».

  • Elige las áreas que podrá leer. Los datos privados (cédula, salario, dirección) van aparte y empiezan apagados.
  • La clave actúa como tú: nunca ve más de lo que permite tu rol, y deja de funcionar si sales de la empresa.
  • Se muestra una sola vez. Guárdala como una contraseña y revócala cuando ya no la uses.

2. Conecta tu asistente (MCP)

Servidor: https://humana.do/api/mcp. Inicia sesión con tu cuenta de Humana (OAuth) o usa una clave en el encabezado Authorization: Bearer.

Claude (web, escritorio y móvil)

En claude.ai, ve a Configuración › Conectores › Agregar conector personalizado, pega la dirección del servidor y elige Conectar. Inicia sesión en Humana, elige la empresa y las áreas, y permite el acceso.

ChatGPT

En Configuración › Aplicaciones y conectores, activa el modo desarrollador, crea un conector con la dirección del servidor y autenticación OAuth. Al conectar, inicia sesión en Humana y permite el acceso.

Claude Code

claude mcp add --transport http humana https://humana.do/api/mcp \
  --header "Authorization: Bearer hum_tu_clave"

Claude Desktop

En Configuración › Desarrollador › Editar configuración, agrega esto a claude_desktop_config.json y reinicia Claude. Necesita Node.js.

{
  "mcpServers": {
    "humana": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://humana.do/api/mcp",
        "--header",
        "Authorization:${HUMANA_AUTH}"
      ],
      "env": {
        "HUMANA_AUTH": "Bearer hum_tu_clave"
      }
    }
  }
}

Cursor, VS Code y otros clientes

Cualquier cliente MCP que acepte una URL con encabezados:

{
  "mcpServers": {
    "humana": {
      "url": "https://humana.do/api/mcp",
      "headers": {
        "Authorization": "Bearer hum_tu_clave"
      }
    }
  }
}

3. Prueba

Pregúntale a tu asistente, por ejemplo:

  • ¿Quiénes entraron a Ventas este año?
  • ¿Cómo van los candidatos de la vacante de contador?
  • ¿Qué solicitudes de vacaciones están pendientes?

Herramientas

Cada clave ve solo las herramientas de sus áreas y de los módulos que tu empresa tiene contratados.

  • empresaEmpresa de esta conexión, módulos contratados y qué permite leer la clave. Úsala primero si no sabes qué datos hay.
  • buscarBusca por nombre colaboradores, candidatos y vacantes de la empresa. Devuelve el tipo y el id para pedir el detalle.
  • listar_colaboradoresColaboradores de la empresa con puesto, departamento, sucursal, supervisor y fechas. Filtra por texto, departamento o estado.
  • ver_colaboradorFicha de un colaborador: puesto, supervisor, equipo a cargo, sucursal, fechas y, si la clave lo permite, datos privados.
  • listar_puestosCatálogo de puestos de la empresa con su descripción y cuántos colaboradores activos lo ocupan.
  • listar_permisosSolicitudes de permiso y vacaciones, de la más reciente a la más antigua (50 por página). Filtra por estado, motivo o colaborador.
  • ver_permisoUna solicitud de permiso o vacaciones con su historial de aprobaciones.
  • listar_vacantesVacantes de la empresa con su estado, plazas, cuántas personas hay en cada etapa y cuántas esperan decisión.
  • ver_vacanteLas personas de una vacante: etapa, ajuste del CV al perfil, evaluaciones enviadas con su puntaje y posición, y notas del equipo. Los descartados solo con «descartados».
  • resultados_vacanteRanking de cada evaluación de la vacante: puntaje, resultado contra los mínimos, nota por prueba e incidentes de supervisión.
  • listar_evaluacionesEvaluaciones de la empresa: pruebas que incluyen, duración, vacantes donde se usan y cuántos candidatos la completaron.
  • resultados_evaluacionTodos los candidatos de una evaluación, de cualquier vacante: puntaje, resultado contra los mínimos, nota por prueba e incidentes.

API REST

Las mismas herramientas, para tus sistemas: GET /api/v1/<herramienta> con los parámetros en la URL, o POST con un cuerpo JSON. GET /api/v1 lista las herramientas de tu clave con sus parámetros.

curl https://humana.do/api/v1/listar_colaboradores?texto=ana \
  -H "Authorization: Bearer hum_tu_clave"
  • Límite: 120 consultas por minuto por clave.
  • Errores: 401 clave inválida o revocada, 403 sin permiso o plan sin API, 404 no encontrado, 429 demasiadas consultas.
  • Las listas devuelven total, items y siguiente; pide la siguiente página con desde.

Seguridad

  • Cada clave lee solo los datos de su empresa.
  • Solo lectura: no crea, cambia, envía ni gasta créditos.
  • Cada consulta queda en la actividad de la empresa, con la clave y la herramienta usadas.
  • Humana guarda solo una huella de cada clave o token, nunca el valor.
  • Las conexiones por inicio de sesión aparecen junto a las claves en Configuración › Integraciones y se revocan igual.

Integraciones a la medida

Para conectar Odoo, tu nómina o tu ERP, nuestro equipo arma la conexión y te envía una cotización. ¿Aún no tienes el plan Avanzado? Ver planes.

Consultar mi integración