Before you start
- Claude Desktop installed on your computer.
- Python 3.11 or later, or
uv(on a Mac,brew install uvinstalls it). - An IQRush account with at least one completed run.
Install the connector
- In IQRush, open Settings → MCP → Connect and choose the Claude Desktop tab. Copy the command for your operating system.
-
Run it in your terminal. On macOS and Linux the production command is:
For Windows, copy the command shown in IQRush and run it in the terminal it names.
- Fully quit and reopen Claude Desktop. On a Mac, press Cmd+Q. Minimising the window is not enough. The IQRush tools load only when the app starts.
- Open a new chat and ask: “List my IQRush projects.”
- Select the sign-in link in Claude’s reply and sign in to IQRush. You only need to do this once.
To connect Google Analytics 4 during install, add the
--with-ga flag: curl -fsSL https://api.prod.gso.iqrush.ai/api/mcp/install.sh | bash -s -- --with-ga. You can also connect it later in Settings → Integrations.Check the connection
Ask: “Show me my IQRush projects.” Claude should call IQRush and list your projects. Choose a project and ask for a summary of its latest completed run.If something goes wrong
Try asking
- “Show me my IQRush projects.”
- “What is our citation share on the latest run, and how does it compare with our top competitor?”
- “Has our brand visibility changed significantly between the last two runs?”
- “Which sources drive citations for our competitors but not for us?”