Local development quick-start

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

cd Workday/workday-mcp

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

source .venv/Scripts/activate

3. Launch inspector (tested)

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

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):

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:

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

2.0 KiB Raw Blame History