Evaluar Server

MCP Server para lanzar procesos eTalent en Evaluar desde tu IDE.

Requisitos

• Node.js >= 18
• Cuenta de Evaluar con credenciales válidas

Instalación

git clone https://github.com/YOUR_USERNAME/evaluar-mcp.git
cd evaluar-mcp
npm install
npm run build

Configuración en Claude Code

Agrega la configuración en ~/.claude.json o en el archivo de configuración MCP de tu IDE:

{
  "mcpServers": {
    "evaluar": {
      "command": "node",
      "args": ["/ruta/absoluta/a/evaluar-mcp/dist/index.js"],
      "env": {
        "EVALUAR_AUTH_URL": "https://auth.evaluar.com/auth/realms/evcore/protocol/openid-connect/token",
        "EVALUAR_API_URL": "https://apis.evaluar.com",
        "EVALUAR_GRAPHQL_URL": "https://apis.evaluar.com/v2/graphql",
        "EVALUAR_CLIENT_ID": "evcap"
      }
    }
  }
}

Tools Disponibles

Tool	Descripción
auth_login	Autenticación con usuario/password
auth_refresh	Refrescar token de autenticación
company_list	Listar empresas del usuario
company_select	Seleccionar empresa activa
position_search	Buscar positions por nombre
process_create	Crear proceso eTalent en DRAFT
process_assign_position	Asociar position al proceso
process_launch	Lanzar proceso y obtener URL summary

Flujo de Uso

1. Autenticarse: auth_login con tus credenciales
2. Seleccionar empresa (si tienes varias): company_list → company_select
3. Buscar position: position_search con el nombre del perfil
4. Crear proceso: process_create con nombre descriptivo
5. Asignar position: process_assign_position con IDs del paso 3 y 4
6. Lanzar: process_launch → obtener URL del summary

Ejemplo

Usuario: "Lanza un proceso eTalent para un asesor de ventas"

1. auth_login(username, password)
2. company_list() → seleccionar empresa
3. position_search("asesor ventas")
4. process_create(name: "Proceso eTalent - Asesor Ventas")
5. process_assign_position(processId, positionId, agencyId, departmentId)
6. process_launch(processId) → URL: https://app.evaluar.com/cap/process/etalent/{id}/summary

Licencia

MIT