# Evaluar MCP Server

MCP Server para lanzar procesos eTalent en [Evaluar](https://evaluar.com) desde tu IDE.

## Requisitos

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

## Instalación

```bash
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:

```json
{
  "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