Skip to main content

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

We recommend installing inside a virtual environment:
Verify:

Install from source

IDE PATH requirement

When you configure your IDE to launch mage-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:
Then update your IDE config: