The MDM-friendly install path
GenZAgents ships @genzagentsio/setup — a CLI that detects installed AI tools (Claude Desktop, ChatGPT Desktop, Cursor, Cline, Windsurf) and writes the right MCP config block for each. Idempotent. The org install token (install_only-scoped) lives in /etc/genzagents.env (mode 600). Engineers see GenZAgents configured after their next laptop sync; they don't click anything, don't reset preferences, don't need to remember a password.
JAMF / Intune / Workspace ONE templates
We ship ready-to-deploy templates at /integrations/mdm. JAMF policy XML, Intune PowerShell scripts, Workspace ONE configuration profiles. Drop into your MDM, set the install-token env var, deploy to your engineering smart group. Standard MDM workflow.
What happens on an engineer's laptop
MDM pushes the package. The post-install script runs `npx @genzagentsio/setup --org-install`. The CLI reads the org install token from /etc/genzagents.env. It detects which AI tools are installed (e.g. Claude Desktop and Cursor). It writes the MCP config block to each tool's config file (using config-merge so existing entries are preserved). It registers the laptop with the GenZAgents API and gets a per-laptop human_id back. Done — receipts start flowing on the engineer's next AI conversation.
Security model — install_only-scoped tokens
The org install token can ONLY call /v1/install/* endpoints. Even if leaked from /etc/genzagents.env, it can't read receipts, can't register agents in other orgs, can't do anything except configure tools on the user's laptop. The blast radius is small by design. Rotate tokens by updating the MDM secret and re-pushing.
Audit of the install fleet
/admin/install-fleet shows every laptop that's registered: hostname, last-seen timestamp, MCP version, OS, which AI tools are configured. Standard fleet-management view. Useful for compliance audits ("show every laptop with GenZAgents installed and active in the last 30 days") and for catching install failures ("these 3 laptops haven't reported in 14 days — investigate").
Uninstall path
For laptops being decommissioned: `npx @genzagentsio/setup --uninstall` removes the MCP config block from each tool's config file (preserving everything else), unregisters the laptop from the API, deletes /etc/genzagents.env. Run via MDM during the decommission workflow. The laptop is clean.