Skip to main content
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:
    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.
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.
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

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, or see how sign-in and permissions work.