Connect Claude, ChatGPT, or Cursor to Scrunch MCP

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.

MCP server URL: https://app.scrunchai.com/api/mcpAll platforms below use this URL. Authentication happens via Scrunch’s standard OAuth sign-in flow; no API key or shared secret is needed.

Custom connectors are available on Free, Pro, Max, Team, and Enterprise Claude plans. Free users are limited to one custom connector.

Open Customize

In the Claude web app (claude.ai) or Claude desktop app, click Customize in the sidebar navigation.

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 your account has already added.

Add a custom connector

Select the + on the Connectors menu and click Add custom connector.

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.

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.

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.

Claude Code is the Claude CLI tool. Run the following command in your terminal:

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:

List my Scrunch brands

Your assistant should respond with the brands accessible in your Scrunch org.

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.

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.

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.

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.

Go back to Apps and find Create app

Navigate back to the main Apps tab. With Developer Mode enabled, a Create app widget appears.

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

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.

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.

Confirm and create

Check the trust acknowledgment and click Create. ChatGPT redirects you to Scrunch to authenticate. Sign in and approve the connection.

Use it in a chat

In any new chat, click the apps / + menu in the composer, choose Developer mode, and select Scrunch AI.

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.

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.

Open your agent

In Microsoft Copilot Studio, open the agent you want to extend with Scrunch. From the agent’s left navigation, choose Tools.

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.

Fill in the wizard

Provide:

Server name: Scrunch AI
Server description: AI brand monitoring and analytics
Server URL: https://app.scrunchai.com/api/mcp

Authenticate

Click Create. Copilot Studio redirects you to Scrunch to authenticate. Sign in with your Scrunch account and approve the connection.

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.

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.

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

Go to Connectors

Add a new custom connector

Click New Connector (or the equivalent + button), then select Custom.

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).

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.

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.

MCP server URL: https://app.scrunchai.com/api/mcp
Authentication uses Scrunch’s standard OAuth sign-in. No API key is required.

Open Cursor Settings

Go to Cursor Settings → Tools & Integrations → MCP.

Add the Scrunch server

Click Add custom server and enter:

Name: scrunch
Server URL: https://app.scrunchai.com/api/mcp
Transport type: Streamable HTTP

Authenticate

Save the configuration. On first use, Cursor will prompt you to authenticate with your Scrunch account.

Verify the connection:

List my Scrunch brands

Create a .vscode/mcp.json file in your workspace root with the following content:

{
  "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.

To share the configuration across your team, commit .vscode/mcp.json to your repository.

Open Windsurf Settings

Go to Windsurf Settings → MCP.

Add the Scrunch server

Click Add server and enter:

Name: scrunch
Server URL: https://app.scrunchai.com/api/mcp
Transport type: Streamable HTTP

Authenticate

Save and restart Windsurf if prompted. On first use, Windsurf will redirect you to authenticate with your Scrunch account.

Verify the connection:

List my Scrunch brands

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

Need more help? Contact your Scrunch CSM or email support@scrunchai.com.

Next steps

Feature Reference

Browse all MCP features with descriptions and example prompts for each.

Use cases

Step-by-step workflows for reporting, competitive analysis, prompt management, and more.

​Troubleshooting

​Next steps

Feature Reference

Use cases

Troubleshooting

Next steps