transformSEO

Overview

Claude Desktop and Claude Code both support automatic OAuth authentication for MCP servers. You provide the server URL, and the client handles the rest — opening a browser window, completing the login, and storing your token. No API keys to copy.

Claude Desktop — Connector UI

The simplest way to connect. No config files required.

Open Claude Desktop and go to Settings → Connectors.
Click Add Custom Connector.
Enter the server URL: https://gettransformseo.com/mcp
Give it a name (e.g. "TransformSEO") and save.
A browser window opens — log in to your TransformSEO account.
Select the team you want to use and click Authorize.
Return to Claude Desktop — your SEO tools are ready.

Claude Desktop — JSON Config

If you prefer editing config files directly, add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "transformseo": {
      "url": "https://gettransformseo.com/mcp"
    }
  }
}

On macOS this file is at ~/Library/Application Support/Claude/claude_desktop_config.json. On Windows it’s at %APPDATA%\Claude\claude_desktop_config.json. Restart Claude Desktop after saving. The OAuth flow will start automatically.

Claude Code

Add the same config to your global ~/.claude/settings.json or a project-level .mcp.json file:

{
  "mcpServers": {
    "transformseo": {
      "url": "https://gettransformseo.com/mcp"
    }
  }
}

Claude Code will detect the MCP server on next launch and walk you through OAuth in your browser.

What Happens After Connecting

Once connected, your AI assistant gains access to TransformSEO’s full suite of SEO tools. The tools available depend on your subscription plan:

Keyword research — search volume, difficulty, ideas, and suggestions
Competitor analysis — domain comparisons, content gaps, and SERP competitors
Backlink analysis — link profiles, referring domains, and anchor text
Site audits — on-page issues, Core Web Vitals, and crawl results
SERP tracking — live search results and historical ranking data
AI/LLM mentions — track how AI models reference your brand
Data syncing — Google Search Console, Analytics, and Business Profile integrations

Troubleshooting

OAuth window doesn’t open — Make sure the URL is exactly https://gettransformseo.com/mcp with no trailing slash or extra path.
Token expired — Remove and re-add the connector (or delete and re-add the JSON entry), then authorize again.
Wrong team — You select a team during the OAuth approval step. To switch teams, disconnect and reconnect to choose a different one.
Tools not appearing — Verify your subscription is active. Free plans have access to a limited set of tools.
Connection timeout — Check your internet connection and ensure gettransformseo.com is reachable.