MCP

Get access to Marketing Miner’s features and data directly in your AI assistant (ChatGPT or Claude) via MCP. This lets you optimize your website and make important decisions based on data, not on AI guesswork. You’ll have at hand, for example, data on keyword search volumes, which keywords your competitors rank for and how much traffic they get from them, and more. Below you’ll find your access credentials and a connection guide. What all can your AI assistant do thanks to our MCP?

Access credentials

In all the guides below, sample values of OAuth Client ID and OAuth Client Secret are shown. You must insert your own, which you’ll find on this page in your account.

So let’s take a look at how to connect Marketing Miner MCP to ChatGPT, Claude, and Claude Code step by step.

How to connect ChatGPT

1. Turn on developer mode

In ChatGPT, go to Settings → Apps → Advanced settings, or open this link directly: Open advanced connector settings.

Turn on the Developer Mode toggle.

2. Create a new app

A Create app button will appear at the top. Click it and fill in:

Name

Marketing Miner

Connection (server URL)

https://mcp.marketingminer.com/mcp

3. Fill in the OAuth credentials

Click Advanced OAuth settings and enter:

OAuth Client ID – you’ll find it in your profile

4e82ce3b63faf8e6b19859bb1876c845

OAuth Client Secret – you’ll find it in your profile

66329bd2082161e6ab57531690001c78

4. Confirm and create

Check I understand and want to continue and click Create.

Then click Sign in with Marketing Miner and confirm signing in to your account. After a successful connection, it will show in green that the connector is connected.

5. Use it in chat

Go to the chat, click +, choose More and select Marketing Miner.

Then you can enter a question, e.g. “What is the traffic of the Amazon.com website in US?”.

6. Done

Everything is set up and working. You can now use Marketing Miner in your ChatGPT.

How to connect Claude

1. Open the connector setup

In the Claude app, go to Settings → Connectors and click Add custom connector. Alternatively, open this link directly: Open the connector setup in Claude

2. Fill in the MCP details

In the dialog, fill in the following fields:

Name (connector name)

Marketing Miner

Remote MCP Server URL

https://mcp.marketingminer.com/mcp

Then expand Advanced settings and add:

OAuth Client ID – you’ll find it in your profile

4e82ce3b63faf8e6b19859bb1876c845

OAuth Client Secret – you’ll find it in your profile

66329bd2082161e6ab57531690001c78

3. Connect the connector

Click Add. The connector will appear in the list – next to it, click Connect. The connection is now done.

4. Test the connection

In the chat, type for example “What is the traffic of the Amazon.com website in US?” – Claude should offer to use the Marketing Miner tool.

5. Done

Everything is set up and working. You can now use Marketing Miner in your Claude.

How to connect Claude Code

1. Check your Claude Code version

Connecting with pre-filled OAuth credentials requires Claude Code version 2.1.30 or newer. You can check the version with the command:

claude --version

If you have an older version, update it with the command:

npm install -g @anthropic-ai/claude-code

2. Add the MCP server

In the terminal, run the following command. The secret key is passed directly via an environment variable, so you don’t have to enter it manually. The -s user switch ensures the connector will be available across all your projects.

Windows (PowerShell):

$env:MCP_CLIENT_SECRET = "66329bd2082161e6ab57531690001c78"
claude mcp add --transport http -s user `
  --client-id 4e82ce3b63faf8e6b19859bb1876c845 `
  --client-secret `
  --callback-port 8080 `
  marketing-miner https://mcp.marketingminer.com/mcp

macOS / Linux:

export MCP_CLIENT_SECRET="66329bd2082161e6ab57531690001c78"
claude mcp add --transport http -s user \
  --client-id 4e82ce3b63faf8e6b19859bb1876c845 \
  --client-secret \
  --callback-port 8080 \
  marketing-miner https://mcp.marketingminer.com/mcp

Claude Code may ask whether the client has a secret. Choose the option “Yes, has a secret” – it will take the key from the MCP_CLIENT_SECRET variable. At the “Do you want to proceed?” prompt, confirm Yes.

3. Restart Claude Code

Claude Code loads MCP servers only at startup, so the currently running session doesn’t yet see the connector you just added. To verify it’s saved correctly, use the command:

claude mcp list

Then restart Claude Code – end the session (press Ctrl+C twice or type the /exit command) and start it again with the claude command.

4. Sign in via OAuth

In the session, enter the /mcp command, select marketing-miner and choose Authenticate to complete the OAuth sign-in.

/mcp

Claude Code should open a browser with the sign-in. If the browser doesn’t open by itself, copy the link (URL) shown in the terminal and paste it manually into your browser.

This links your account with Marketing Miner. Then close the browser and return to Claude Code, where you should now have Marketing Miner MCP successfully connected.

5. Test the connection

In the session, type for example “What is the traffic of the Amazon.com website in US?” – Claude Code should offer to use the Marketing Miner tool.

6. Done

Everything is set up and working. You can now use Marketing Miner in your Claude Code.