Requirements
- Python 3.10 or newer
- A Mage Pro cluster (URL + account credentials)
Download from Mage Pro
In Mage Pro, open Settings > Platform > Mage Agent to download the latest Mage Agent installer for Codex or Claude Code. The page lists the latest GitHub release assets for macOS and Windows, including file sizes and checksums. Download links use GitHub’s stable latest-release asset URLs, so Mage Pro does not need source changes when release tags or asset URLs change. Use the download that matches your operating system and AI coding client, then follow the prompts from the installer.Install from PyPI
Install from source
IDE PATH requirement
When you configure your IDE to launchmage-agent mcp, the IDE may use a different PATH than your terminal. If the MCP server fails to start, use the absolute path to the executable: