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

# Connect Claude, ChatGPT, or Cursor to Scrunch MCP

> Step-by-step setup to connect the Scrunch MCP server to Claude, ChatGPT, Microsoft Copilot Studio, Cursor, VS Code, or Windsurf using OAuth in 5 minutes.

All setup flows connect to the same server and use the same OAuth sign-in — your Scrunch account credentials, no API key required. Pick your AI client below.

<Note>
  **MCP server URL:** `https://app.scrunchai.com/api/mcp`

  All platforms below use this URL. Authentication happens via Scrunch's standard OAuth sign-in flow; no API key or shared secret is needed.
</Note>

<Tabs>
  <Tab title="Claude">
    Custom connectors work across Free, Pro, Max, Team, and Enterprise Claude plans. How you add Scrunch depends on whether you're on a personal plan or part of a Team or Enterprise organization.

    <Tabs>
      <Tab title="Personal (Free, Pro, Max)">
        Free plans are limited to one active custom connector at a time.

        <Steps>
          <Step title="Open Customize">
            In the Claude web app ([claude.ai](http://claude.ai)) or Claude desktop app, click **Customize** in the sidebar navigation.

            <Frame>
              <img src="https://mintcdn.com/scrunchai/ak5yAmkXHU_XWgdE/images/claude-customize.png?fit=max&auto=format&n=ak5yAmkXHU_XWgdE&q=85&s=c335fa3071454d9aa060a98b0f198b11" alt="Claude Customize setting" title="Screenshot 2026 05 14 At 8 47 11 AM" lightAlt="Claude Customize setting" darkAlt="Claude Customize setting" width="718" height="510" data-path="images/claude-customize.png" />
            </Frame>
          </Step>

          <Step title="Go to Connectors">
            In the Settings sidebar, select **Connectors**. You'll see built-in connectors (Google Drive, Slack, Notion, etc.) followed by any custom connectors you've already added.

            <Frame>
              <img src="https://mintcdn.com/scrunchai/ak5yAmkXHU_XWgdE/images/claude-connectors.png?fit=max&auto=format&n=ak5yAmkXHU_XWgdE&q=85&s=e1c3b71a5ce04c7e076d486c84f4c59c" alt="Claude connectors setting" width="1338" height="322" data-path="images/claude-connectors.png" />
            </Frame>
          </Step>

          <Step title="Add a custom connector">
            Click the **+** button and select **Add custom connector**.
          </Step>

          <Step title="Fill in the connector details">
            In the dialog that opens, enter:

            * **Name:** `Scrunch AI` (or whatever you'd like to call it)
            * **Remote MCP server URL:** `https://app.scrunchai.com/api/mcp`
            * **OAuth Client ID / Client Secret:** Leave blank. These are only needed if you're hosting your own OAuth provider.

            <Frame>
              <img src="https://mintcdn.com/scrunchai/ak5yAmkXHU_XWgdE/images/claude-custom-connector.png?fit=max&auto=format&n=ak5yAmkXHU_XWgdE&q=85&s=665155a76bd9e9b7a4c9942e5cbbd634" alt="claude-custom-connector" width="1164" height="1078" data-path="images/claude-custom-connector.png" />
            </Frame>
          </Step>

          <Step title="Click Add, then sign in to Scrunch">
            Claude redirects you to Scrunch to authenticate. Sign in with your Scrunch account, approve the connection, and Claude returns to the Connectors page with the connector active.
          </Step>
        </Steps>
      </Tab>

      <Tab title="Team & Enterprise — Owners">
        On Team and Enterprise plans, only **owners** can add custom connectors. Once added, the connector becomes available for all members in your organization to enable.

        <Steps>
          <Step title="Open Customize">
            In the Claude web app ([claude.ai](http://claude.ai)) or Claude desktop app, click **Customize** in the sidebar navigation.
          </Step>

          <Step title="Go to Connectors">
            In the Settings sidebar, select **Connectors**.
          </Step>

          <Step title="Add a custom connector">
            Click the **+** button and select **Add custom connector**.
          </Step>

          <Step title="Fill in the connector details">
            In the dialog that opens, enter:

            * **Name:** `Scrunch AI`
            * **Remote MCP server URL:** `https://app.scrunchai.com/api/mcp`
            * **OAuth Client ID / Client Secret:** Leave blank.

            <Frame>
              <img src="https://mintcdn.com/scrunchai/ak5yAmkXHU_XWgdE/images/claude-custom-connector.png?fit=max&auto=format&n=ak5yAmkXHU_XWgdE&q=85&s=665155a76bd9e9b7a4c9942e5cbbd634" alt="claude-custom-connector" width="1164" height="1078" data-path="images/claude-custom-connector.png" />
            </Frame>
          </Step>

          <Step title="Click Add, then sign in to Scrunch">
            Claude redirects you to Scrunch to authenticate. Sign in with your Scrunch account and approve the connection. The Scrunch connector is now available for members in your organization.
          </Step>
        </Steps>
      </Tab>

      <Tab title="Team & Enterprise — Members">
        Regular members on Team and Enterprise plans cannot add custom connectors — that's restricted to org owners. Once an owner has added Scrunch, you can enable it for your own account.

        <Steps>
          <Step title="Ask an owner to add Scrunch">
            Have an org owner follow the **Team & Enterprise — Owners** tab to add the Scrunch connector. They only need to do this once for the whole organization.
          </Step>

          <Step title="Open Customize → Connectors">
            Once the connector has been added, go to **Customize → Connectors** in your Claude account. Scrunch AI will appear in the list.
          </Step>

          <Step title="Enable and authenticate">
            Toggle the connector on. Claude redirects you to Scrunch to sign in with your own Scrunch account. Your individual brand access and permissions are determined by your Scrunch account — not the owner's.
          </Step>
        </Steps>
      </Tab>
    </Tabs>

    <Tip>
      **Enabling the connector in a chat** — When you start a new conversation, click the connector icon in the message composer and toggle **Scrunch AI** on for that chat. To enable it by default for all new chats, go to **Settings → Connectors → Configure** on the Scrunch AI connector.
    </Tip>
  </Tab>

  <Tab title="Claude Code">
    Claude Code is the Claude CLI tool. Run the following command in your terminal:

    ```bash theme={null}
    claude mcp add scrunch --transport streamable-http https://app.scrunchai.com/api/mcp
    ```

    Claude Code will prompt you to authenticate with your Scrunch account the first time you use a Scrunch tool in a session.

    **Verify the connection:**

    ```text theme={null}
    List my Scrunch brands
    ```

    Your assistant should respond with the brands accessible in your Scrunch org.
  </Tab>

  <Tab title="ChatGPT">
    Requires a paid ChatGPT plan (Plus, Pro, Team, Enterprise, or Edu). Plus and Pro accounts get read-only access; Team, Enterprise, and Edu accounts get full read + write access.

    <Warning>
      **Critical:** You must remove `openid` from the OAuth scopes in **two separate places** during setup (steps 5 and 6 below). If you miss either one, authentication will fail.
    </Warning>

    <Steps>
      <Step title="Open Settings → Apps → Advanced Settings">
        Click your profile picture in ChatGPT and choose **Settings**. Open the **Apps** tab, then click **Advanced Settings** at the bottom.

        <Frame>
          <img src="https://mintcdn.com/scrunchai/ak5yAmkXHU_XWgdE/images/Screenshot-2026-05-14-at-8.58.59-AM.png?fit=max&auto=format&n=ak5yAmkXHU_XWgdE&q=85&s=1153b0f11661237675d127efdc02207a" alt="Screenshot 2026 05 14 At 8 58 59 AM" width="1412" height="1242" data-path="images/Screenshot-2026-05-14-at-8.58.59-AM.png" />
        </Frame>
      </Step>

      <Step title="Enable Developer Mode">
        In Advanced Settings, toggle **Developer Mode** on. Workspace owners can also enable this org-wide under **Workspace Settings → Permissions & Roles → Connected Data → Developer mode**.

        <Frame>
          <img src="https://mintcdn.com/scrunchai/ak5yAmkXHU_XWgdE/images/Screenshot-2026-05-14-at-8.59.23-AM.png?fit=max&auto=format&n=ak5yAmkXHU_XWgdE&q=85&s=1f5b33c08d75c8e1e85a892bfeb37dea" alt="Screenshot 2026 05 14 At 8 59 23 AM" width="1410" height="1238" data-path="images/Screenshot-2026-05-14-at-8.59.23-AM.png" />
        </Frame>
      </Step>

      <Step title="Go back to Apps and find Create app">
        Navigate back to the main **Apps** tab. With Developer Mode enabled, a **Create app** widget appears.

        <Frame>
          <img src="https://mintcdn.com/scrunchai/ak5yAmkXHU_XWgdE/images/Screenshot-2026-05-14-at-8.56.25-AM.png?fit=max&auto=format&n=ak5yAmkXHU_XWgdE&q=85&s=2a9b843194c607d7b4e0f1ba93a6729f" alt="Screenshot 2026 05 14 At 8 56 25 AM" width="1038" height="670" data-path="images/Screenshot-2026-05-14-at-8.56.25-AM.png" />
        </Frame>
      </Step>

      <Step title="Create a new app">
        Click **Create app** and fill in:

        * **Name / icon / description:** Anything you like — `Scrunch AI` works well.
        * **MCP Server URL:** `https://app.scrunchai.com/api/mcp`
        * **Authentication:** OAuth
      </Step>

      <Step title="Remove openid from Scopes">
        Inside the Create app form, expand **Advanced settings**. In the **Scopes** field, deselect or delete `openid`. Leave all other default scopes.
      </Step>

      <Step title="Remove openid from OIDC scope supported">
        Still in Advanced settings, scroll to the bottom. Find the **OIDC scope supported** field and delete `openid` from that field as well. Both removals are required.
      </Step>

      <Step title="Confirm and create">
        Check the trust acknowledgment and click **Create**. ChatGPT redirects you to Scrunch to authenticate. Sign in and approve the connection.
      </Step>

      <Step title="Use it in a chat">
        In any new chat, click the **apps / +** menu in the composer, choose **Developer mode**, and select **Scrunch AI**.
      </Step>
    </Steps>

    <Tip>
      **Plan limits** — Plus and Pro accounts have read-only access. Features like `list_brands` and `get_presence_metrics` work on any plan, but operations that modify data — `create_brand`, `archive_prompt`, `update_tags` — require a Team, Business, Enterprise, or Edu workspace.
    </Tip>
  </Tab>

  <Tab title="Copilot Studio">
    Microsoft Copilot Studio lets you attach the Scrunch MCP to any custom agent. You'll need an agent already created before connecting Scrunch to it.

    <Steps>
      <Step title="Open your agent">
        In Microsoft Copilot Studio, open the agent you want to extend with Scrunch. From the agent's left navigation, choose **Tools**.
      </Step>

      <Step title="Add a new tool">
        Click **+ Add a tool**. In the dialog, choose **New tool**, then select **Model Context Protocol**. This launches the MCP onboarding wizard.
      </Step>

      <Step title="Fill in the wizard">
        Provide:

        * **Server name:** `Scrunch AI`
        * **Server description:** `AI brand monitoring and analytics`
        * **Server URL:** `https://app.scrunchai.com/api/mcp`
      </Step>

      <Step title="Authenticate">
        Click **Create**. Copilot Studio redirects you to Scrunch to authenticate. Sign in with your Scrunch account and approve the connection.
      </Step>

      <Step title="Add features to your agent">
        After connecting, you'll see the full list of Scrunch features. Select which ones the agent should have access to, click **Add to agent**, then save and publish your agent.
      </Step>
    </Steps>

    <Tip>
      **Editing the connector later** — If you need to update the connector details (e.g., swap to a different Scrunch account), open **Power Apps → Custom connectors**, find the Scrunch entry, and update there. The change propagates back into Copilot Studio automatically.
    </Tip>
  </Tab>

  <Tab title="Grok">
    Grok (grok.com / xAI) supports custom MCP connectors on all paid plans. Free users may have limited or no access to custom connectors.

    <Steps>
      <Step title="Go to Connectors">
        Log in to [grok.com](https://grok.com) and navigate to **Connectors** (direct link: [grok.com/connectors](https://grok.com/connectors) or via the main menu).

        <Frame>
          <img src="https://mintcdn.com/scrunchai/eEie11k8RqXVQIyk/images/grok-connectors.png?fit=max&auto=format&n=eEie11k8RqXVQIyk&q=85&s=f799d0f35139372a76044d57986770a8" alt="Grok connectors" width="800" height="574" data-path="images/grok-connectors.png" />
        </Frame>
      </Step>

      <Step title="Add a new custom connector">
        Click **New Connector** (or the equivalent + button), then select **Custom**.

        <Frame>
          <img src="https://mintcdn.com/scrunchai/Xn4EEeBaa2q1GkTh/images/Screenshot-2026-05-14-at-9.22.36-AM.png?fit=max&auto=format&n=Xn4EEeBaa2q1GkTh&q=85&s=2f75bdab8bc911431ccc24ce1a476ca2" alt="Grok new connector" width="2420" height="918" data-path="images/Screenshot-2026-05-14-at-9.22.36-AM.png" />
        </Frame>
      </Step>

      <Step title="Fill in the connector details">
        Enter:

        * **Name:** `Scrunch AI` (or your preferred name)
        * **MCP Server URL:** `https://app.scrunchai.com/api/mcp`

        Leave any OAuth Client ID / Secret fields blank unless instructed otherwise (Scrunch handles authentication via its standard OAuth flow).

        <Frame>
          <img src="https://mintcdn.com/scrunchai/Xn4EEeBaa2q1GkTh/images/Screenshot-2026-05-14-at-9.23.05-AM.png?fit=max&auto=format&n=Xn4EEeBaa2q1GkTh&q=85&s=5c7e7346233b1f8d8366f5056beed4cc" alt="Grok custom connector" width="1236" height="650" data-path="images/Screenshot-2026-05-14-at-9.23.05-AM.png" />
        </Frame>
      </Step>

      <Step title="Save and authenticate">
        Click **Add** / **Create**. Grok will redirect you to Scrunch to sign in with your Scrunch account and approve the connection. Once approved, the connector becomes active.
      </Step>
    </Steps>

    <Tip>
      **Enabling in a chat** — In a new conversation, look for the connector / tools icon or sidebar. Toggle **Scrunch AI** on for that chat. You can set it as default for new chats in the connector settings.
    </Tip>

    <Note>
      **MCP server URL:** `https://app.scrunchai.com/api/mcp`\
      Authentication uses Scrunch's standard OAuth sign-in. No API key is required.
    </Note>
  </Tab>

  <Tab title="Cursor">
    <Steps>
      <Step title="Open Cursor Settings">
        Go to **Cursor Settings → Tools & Integrations → MCP**.
      </Step>

      <Step title="Add the Scrunch server">
        Click **Add custom server** and enter:

        * **Name:** `scrunch`
        * **Server URL:** `https://app.scrunchai.com/api/mcp`
        * **Transport type:** Streamable HTTP
      </Step>

      <Step title="Authenticate">
        Save the configuration. On first use, Cursor will prompt you to authenticate with your Scrunch account.
      </Step>
    </Steps>

    **Verify the connection:**

    ```text theme={null}
    List my Scrunch brands
    ```
  </Tab>

  <Tab title="VS Code">
    Create a `.vscode/mcp.json` file in your workspace root with the following content:

    ```json theme={null}
    {
      "servers": {
        "scrunch": {
          "type": "http",
          "url": "https://app.scrunchai.com/api/mcp"
        }
      }
    }
    ```

    Save the file. VS Code (with GitHub Copilot) will detect the MCP configuration and prompt you to authenticate with Scrunch on first use.

    <Tip>
      To share the configuration across your team, commit `.vscode/mcp.json` to your repository.
    </Tip>
  </Tab>

  <Tab title="Windsurf">
    <Steps>
      <Step title="Open Windsurf Settings">
        Go to **Windsurf Settings → MCP**.
      </Step>

      <Step title="Add the Scrunch server">
        Click **Add server** and enter:

        * **Name:** `scrunch`
        * **Server URL:** `https://app.scrunchai.com/api/mcp`
        * **Transport type:** Streamable HTTP
      </Step>

      <Step title="Authenticate">
        Save and restart Windsurf if prompted. On first use, Windsurf will redirect you to authenticate with your Scrunch account.
      </Step>
    </Steps>

    **Verify the connection:**

    ```text theme={null}
    List my Scrunch brands
    ```
  </Tab>
</Tabs>

***

## Troubleshooting

| Symptom                                    | Likely cause                                 | Fix                                                                           |
| ------------------------------------------ | -------------------------------------------- | ----------------------------------------------------------------------------- |
| Authentication fails immediately           | Signed in with the wrong account             | Sign out of Scrunch in your browser, then reconnect using the correct account |
| "No brands found"                          | Your Scrunch account has no brand access     | Ask your org admin to grant you access to at least one brand                  |
| ChatGPT auth fails                         | `openid` not removed from both scope fields  | Recreate the app and follow steps 5–6 carefully                               |
| Tools not appearing in Claude              | Connector not enabled for this chat          | Click the connector icon in the composer and toggle Scrunch AI on             |
| Free Claude plan limit                     | Free plan is limited to one custom connector | Remove an existing custom connector or upgrade your plan                      |
| Scrunch connector not visible (org member) | Owner hasn't added it to the org yet         | Ask an org owner to follow the Team & Enterprise — Owners setup steps         |

Need more help? Contact your Scrunch CSM or email [support@scrunchai.com](mailto:support@scrunchai.com).

***

## Next steps

<CardGroup cols={2}>
  <Card title="Feature Reference" icon="wrench" href="/mcp/tools">
    Browse all MCP features with descriptions and example prompts for each.
  </Card>

  <Card title="Use cases" icon="sparkles" href="/mcp/workflows/new-brand-live">
    Step-by-step workflows for reporting, competitive analysis, prompt management, and more.
  </Card>
</CardGroup>