# Local development quick-start

## 1. Move to runtime directory (why: inspector resolves `server.py` from current directory)

```bash
cd Workday/workday-mcp
```

## 2. Activate environment (why: guarantees the project Python and dependencies are used)

```bash
source .venv/Scripts/activate
```

## 3. Launch inspector (tested)

Use the explicit Python path to avoid shell alias/path drift:

```bash
npx @modelcontextprotocol/inspector "c:/Users/castn1.CORP/OneDrive - Wheels/Repos/mcp_servers/Workday/workday-mcp/.venv/Scripts/python.exe" server.py
```

Why: this starts the Inspector UI and spawns the MCP server over STDIO. If startup succeeds, the CLI prints a localhost URL that includes an auth token.

## 4. Port cleanup when blocked (tested)

If you see `Proxy Server PORT IS IN USE at port 6277`, use one of the following:

PowerShell terminal (recommended):

```powershell
Get-NetTCPConnection -State Listen -LocalPort 6277,6274 |
    Select-Object LocalAddress,LocalPort,OwningProcess

Stop-Process -Id <PID> -Force
```

Important: `<PID>` is a placeholder. Replace it with a real numeric process ID from the first command.

Why: kill by PID is more reliable than killing `node.exe` by name because the owning process may vary.

Git Bash alternative:

```bash
cd Workday/workday-mcp
powershell -NoProfile -Command '$ports = 6277,6274; $conns = Get-NetTCPConnection -State Listen -ErrorAction SilentlyContinue | Where-Object { $ports -contains $_.LocalPort }; $conns | ForEach-Object { Stop-Process -Id $_.OwningProcess -Force -ErrorAction SilentlyContinue }; "cleanup-done"'
```

Why: this runs PowerShell networking commands from Git Bash in one copy/paste-safe command.

## 5. Optional quick health checks after connect

Run these tools in Inspector and verify non-empty output:

- `scan_status_reconciliation`
- `scan_job_title_drift`
- `scan_department_mismatches`
- `scan_name_variance_mismatches`

Expected baseline in current mock data:

- status drift: 1 mismatch
- title drift: 1 mismatch
- department drift: 1 mismatch
- name variance: 3 mismatches