Step 6: Configure MCP

Install SEO Gets MCP

Allow MCP (Model Context Protocol) clients to use your SEO Gets data.

Create your MCP key and connect to Claude Desktop in seconds

Where to find your MCP Key

How to connect SEO Gets to Claude Desktop

  • Name your MCP Key and click Create Key

  • Once your key is generated, click Copy and paste it somewhere as it won't be shown again.

  • Install Node.js, which is required to run the MCP server. If you don't have it yet, download and install it from nodejs.org.

  • Run the setup script by opening the Terminal app (press ⌘ Space and type Terminal), then paste and run the command.

How to confirm that your connection is working

Getting started with the SEO Gets MCP only takes a few seconds, but if this is your first time, follow the steps below to confirm that your connection is working or to troubleshoot any issues you might be running into.

Step 1: Open the configuration file

You can access the config file directly from Claude Desktop:

  1. Click Claude in your menu bar (macOS) or go to the app menu (Windows)

  2. Select Settings

  3. Click the Developer tab

  4. Click Edit Config to open the configuration file

The config file is located at:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Step 2: Check for the SEO Gets MCP server

Review the JSON file to ensure that your server configuration is located under mcpServers:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/yourname/Desktop",
        "/Users/yourname/Downloads"
      ]
    }
  }
}

Replace /Users/yourname/Desktop with your actual file paths. Paths must be absolute (full path from root), not relative. On Windows, use double backslashes: C:\\Users\\yourname\\Desktop.

Key configuration fields

  • command — The executable to run (usually npx or a Node.js path)

  • args — Arguments passed to the command, including the server package name

  • env (optional) — Environment variables the server needs

Step 3: Restart Claude Desktop

This step is critical—closing the window isn't enough. You must completely quit and restart Claude Desktop for the new configuration to take effect.

  1. Right-click Claude in your dock/taskbar and select Quit

  2. Reopen Claude Desktop

Step 4: Verify the connection

When Claude reconnects, navigate to settings → customize to see if SEOGets is listed as a connector under Desktop.

Troubleshooting

My MCP server isn't connecting

Try these steps:

  • Check that your JSON syntax is valid (no missing commas or brackets)

  • Make sure all file paths are absolute, not relative

  • Run your server command directly in a terminal to check for errors

  • Verify you fully quit and restarted Claude Desktop

The connector doesn't appear in Claude Desktop

If you've added the config but SEOGets isn't showing under Settings → Customize, try these fixes:

  1. Check the config file location. On Windows, make sure you're editing the correct file: %APPDATA%\Claude\claude_desktop_config.json. If you have multiple Claude installations or profiles, you may be editing the wrong one.

  2. Verify your JSON is valid. Even a single missing comma or extra bracket will break the config. Paste your config into a JSON validator to catch syntax errors.

  3. Force a full restart. Closing the Claude window isn't enough—right-click Claude in your taskbar and select Quit, then reopen. On macOS, use ⌘Q or right-click the dock icon and select Quit.

  4. Check the logs. Look at mcp.log in your Claude logs folder for errors. If you see "server not found" or connection failures, the config may not be loading correctly.

I see "server disconnected" or timeout errors

These errors usually mean the MCP server isn't running or can't be reached. Here's how to debug:

  1. Verify Node.js is installed. Open a terminal and run node --version. If you get "command not found," install Node.js from nodejs.org.

  2. Check if the server starts manually. Open a terminal and run the server command directly. If you see errors about missing packages or permissions, fix those first.

  3. Confirm your MCP key is valid. Go to Settings → API & MCP Keys in SEO Gets and verify the key you created is still listed. If you're not sure, create a new key and update your config.

  4. Check your network. If you're behind a corporate firewall or VPN, the MCP server may be blocked. Try connecting from a different network to rule this out.

Where can I find MCP logs?

Claude Desktop logs MCP connection details to help you debug issues:

  • macOS: ~/Library/Logs/Claude/

  • Windows: %APPDATA%\Claude\logs\

Look for mcp.log for general connection logs and mcp-server-SERVERNAME.log for server-specific errors.

I see "%APPDATA%" literally in an error path

This means the environment variable isn't expanding correctly. Add it to your claude_desktop_config.json in an env block:

{
  "mcpServers": {
    "your-server": {
      "command": "...",
      "args": [...],
      "env": {
        "APPDATA": "C:\\Users\\yourname\\AppData\\Roaming"
      }
    }
  }
}
Windows: Paths with spaces aren't working

On Windows, paths with spaces (like C:\Program Files\) can cause issues if not escaped properly. You have two options:

Option 1: Use forward slashes — Windows accepts forward slashes in most cases:

"C:/Users/Your Name/AppData/Roaming"

Option 2: Escape backslashes — Double every backslash:

"C:\\Users\\Your Name\\AppData\\Roaming"

Avoid single backslashes in JSON—they'll break the config.

Windows: "npx" command not found

If Claude Desktop logs show "npx: command not found" or similar, Node.js isn't in your PATH.

  1. Reinstall Node.js from nodejs.org and make sure you check Add to PATH during installation.

  2. After installing, restart your computer to ensure PATH changes take effect.

  3. Open a new terminal and run npx --version to confirm it works.

If npx still doesn't work, you may need to use the full path to Node.js in your config:

"command": "C:\\Program Files\\nodejs\\npx.cmd"

That's it! Once configured, Claude can interact with your data in SEO Gets directly to give you deeper insights on content groups, topic clusters, data trends, and more.

Was this helpful?