> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iqrush.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect IQRush to Claude Desktop

> Install the IQRush connector in Claude Desktop with one command, sign in once, and start asking questions about your projects.

Claude Desktop uses a small local connector. You run one install command, restart Claude Desktop, and sign in to IQRush from a link Claude gives you. It usually takes a few minutes.

## Before you start

* Claude Desktop installed on your computer.
* Python 3.11 or later, or `uv` (on a Mac, `brew install uv` installs it).
* An IQRush account with at least one completed run.

## Install the connector

1. In IQRush, open **Settings → MCP → Connect** and choose the **Claude Desktop** tab. Copy the command for your operating system.
2. Run it in your terminal. On macOS and Linux the production command is:

   ```bash theme={null}
   curl -fsSL https://api.prod.gso.iqrush.ai/api/mcp/install.sh | bash
   ```

   For Windows, copy the command shown in IQRush and run it in the terminal it names.
3. **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.
4. Open a new chat and ask: "List my IQRush projects."
5. Select the sign-in link in Claude's reply and sign in to IQRush. You only need to do this once.

<Note>
  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**.
</Note>

A Dev environment has its own command and data. Copy the command from the environment that holds your projects.

## 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

| What you see | What to do |
| - | - |
| The IQRush tools are missing | Quit Claude Desktop completely and reopen it. |
| The sign-in link has expired | Restart Claude Desktop to get a new link. |
| A "Module not found" error | Run `pip install iqrush-mcp` in your terminal, then restart Claude Desktop. |
| "Already connected" | Your sign-in is still valid. No action is needed. |
| The project list is empty | Check that you are signed in to the account and workspace that hold your projects. |

## 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?"

**Next:** [make your first MCP calls](/developers/guides/02-mcp-quickstart), or [see how sign-in and permissions work](/developers/guides/04-authentication).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.