qualty-mcp

# Qualty MCP User Setup This guide shows how to install and use the published `qualty-mcp` package from PyPI in a new project, for both **Claude Code** and **Cursor**. --- ## Prerequisites - Python 3.11+ available on your machine - `pipx` installed - A Qualty API token (`qlty_ci_...`) Install `pipx` if needed: ```bash python3 -m pip install --user --upgrade pipx python3 -m pipx ensurepath ``` Open a new terminal after `ensurepath`. --- ## 1) Install Qualty MCP ```bash pipx install qualty-mcp ``` If already installed and you want latest: ```bash pipx upgrade qualty-mcp ``` --- ## 2) Go to your project folder ```bash cd /path/to/your-project ``` All project-specific files (`.mcp.json`, `.qualty.json`) will be created in the current folder. --- ## 3) Initialize token + default project ```bash qualty-mcp init ``` This will: - prompt for your `qlty_ci_...` token - fetch projects in your account - let you pick an active project for this workspace Notes: - token is stored globally at `~/.qualty/credentials` - active project is stored per project in `.qualty.json` --- ## 4A) Configure MCP for Claude Code ```bash qualty-mcp install-claude-code ``` --- ## 4B) Configure MCP for Cursor ```bash qualty-mcp install-cursor ``` --- ## 5) Restart your client After writing `.mcp.json`, fully restart: - Claude Code, or - Cursor This reloads MCP servers and starts `qualty-mcp serve`. --- ## 6) Verify setup From the same project directory: ```bash qualty-mcp doctor qualty-mcp status ``` Expected: - token configured - API reachable - default project configured --- ## Common commands ### List/switch active project for this workspace ```bash qualty-mcp list-projects ``` or directly: ```bash qualty-mcp switch-project --project-id 123 qualty-mcp switch-project --project-name "My Project" ``` ### Show config snippet only ```bash qualty-mcp print-claude-code-config qualty-mcp print-cursor-config ``` --- ## File model (important) - `~/.qualty/crede…