%AppData%\\Claude\\claude_desktop_config.json<\/code>:<\/p>\n{\n \"mcpServers\": {\n \"gsc\": {\n \"command\": \"uvx\",\n \"args\": [\"mcp-search-console\"]\n }\n }\n}<\/pre>\nStep 4 \u2014 Restart Claude Desktop.<\/strong> You’ll see a hammer icon in the conversation header \u2014 that confirms MCP tools are loaded.<\/p>\nStep 5 \u2014 Test it.<\/strong> Ask Claude: “List all GSC properties I have access to.” Claude calls the list_properties<\/code> tool and returns your verified domains.<\/p>\nWhat Permissions Does the GSC MCP Server Need?<\/h3>\n Read-only access to Search Analytics and URL Inspection is enough. The server never writes to GSC.<\/p>\n
Use a Google account with “Owner” or “Full User” access on the property. “Restricted User” returns empty results without any error message, which is easy to misread as a config failure.<\/p>\n
\n
Warning<\/strong><\/p>\nOn Windows, the GSC OAuth flow hangs forever if launched for the first time from inside Claude Desktop’s subprocess \u2014 the browser never opens. Fix: run uvx mcp-search-console<\/code> once in a normal PowerShell terminal to complete the OAuth handshake, then restart Claude Desktop. The cached token carries forward and no browser is needed on subsequent runs.<\/p>\n<\/div>\nConnecting Ahrefs to Claude via MCP: DR Scores, Keyword Explorer, and Backlink Data<\/h2>\n Ahrefs released their MCP server in beta in Q1 2026. It exposes Keyword Explorer, Site Explorer (Domain Rating and backlink counts), and SERP Overview as callable tools.<\/p>\n
Installation:<\/strong> npm install -g @ahrefs\/mcp-server<\/code><\/p>\nAdd to claude_desktop_config.json alongside the GSC entry:<\/p>\n
\"ahrefs\": {\n \"command\": \"npx\",\n\"args\": [\"-y\", \"@ahrefs\/mcp-server\"],<\/p>\n \"env\": {\n
\"AHREFS_API_KEY\": \"your_key_here\"<\/p>\n }\n}<\/pre>\n
Which Ahrefs Metrics Are Available via MCP vs the Full v3 API?<\/h3>\n The MCP server exposes Domain Rating, URL Rating, referring domains, organic keyword count, and estimated monthly traffic. Historical data and position tracking history require the full v3 API directly.<\/p>\n
For weekly keyword audits, the MCP tools cover roughly 90% of what you need.<\/p>\n
\n\n\nAhrefs MCP Tool<\/th>\n What It Returns<\/th>\n Rate Limit<\/th>\n<\/tr>\n<\/thead>\n \n\nget_site_metrics<\/td>\n DR, UR, backlinks, referring domains<\/td>\n 50\/hour<\/td>\n<\/tr>\n \nkeyword_overview<\/td>\n Volume, KD, SERP features<\/td>\n 100\/hour<\/td>\n<\/tr>\n \nget_backlinks<\/td>\n Top 20 linking pages + DR<\/td>\n 30\/hour<\/td>\n<\/tr>\n \nsearch_suggestions<\/td>\n Related keywords + volumes<\/td>\n 200\/hour<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\n
Pro Tip<\/strong><\/p>\nIn your Claude prompt, set an explicit API budget: “Use at most 20 Ahrefs tool calls for this analysis.” Claude respects the constraint and won’t exhaust your rate limit on data you didn’t ask for. On Ahrefs’ Starter plan, each API unit costs roughly $0.05 per 10 units \u2014 an unconstrained audit can run $2\u20133 in a single session.<\/p>\n<\/div>\n
The Combined Workflow: GSC Impressions to Ahrefs Competitor Gap in One Claude Thread<\/h2>\n This is the workflow that reduced a 3-hour weekly audit to under 20 minutes.<\/p>\n
With both the GSC and Ahrefs MCP servers active in Claude Desktop, one prompt drives the entire analysis:<\/p>\n
Using GSC, pull impressions and position data for designcopy.net for the last\n28 days. Filter to queries where position > 10 and impressions > 50.<\/p>\n\n
For each, use Ahrefs keyword_overview to get KD and the top-ranking competitor<\/p>\n
domain. Identify the 5 queries where I'm closest to page 1 and competitors<\/p>\nhave DR <= 60.\n\n
Return a table: Query | My Position | Impressions | KD | Top Competitor | Top DR<\/pre>\n<\/p>\n
Claude runs approximately 12 tool calls \u2014 one GSC analytics pull, then 10 Ahrefs keyword lookups \u2014 and returns a prioritized table in about 90 seconds.<\/p>\n
The manual equivalent: GSC export \u2192 Excel \u2192 Ahrefs bulk keyword tool \u2192 manual DR lookup \u2192 manual comparison. That took 3 hours on a site with 500 queries in GSC.<\/p>\n
What Happens When One MCP Server Errors Mid-Workflow?<\/h3>\n Claude surfaces errors inline: “I was unable to retrieve Ahrefs data for ‘prompt engineering salary’ (rate limit reached). Continuing with available data.”<\/p>\n
It then completes the analysis with the remaining queries. You don’t lose the full session over one tool failure.<\/p>\n
\n
Pro Tip<\/strong><\/p>\nSave your combined audit prompt as a Claude Project instruction. In Claude Desktop’s Projects tab, create a “Weekly SEO Audit” project with the GSC + Ahrefs prompt pre-loaded. Each Monday, open the project and press Enter \u2014 the entire audit runs without retyping the prompt.<\/p>\n<\/div>\nCommon MCP Setup Failures and How to Fix Them<\/h2>\n These failures came up during setup on Windows 11 and macOS 14 Sonoma. Each one wastes 20\u201330 minutes if you don’t know the pattern.<\/p>\n
Why Does Claude Say “No MCP Tools Available” Even After Config?<\/h3>\n Three causes, in order of frequency:<\/p>\n
1. JSON syntax error in the config file.<\/strong> Claude Desktop silently ignores malformed JSON. Run the config through a JSON linter before saving \u2014 a trailing comma is enough to break it.<\/p>\n2. Wrong file path.<\/strong> The config must be at %AppData%\\Claude\\claude_desktop_config.json<\/code> on Windows \u2014 not the Claude Code config path at %AppData%\\Claude Code\\<\/code>. Both exist and both are different.<\/p>\n3. Server didn’t start.<\/strong> Open Claude Desktop’s Developer Tools (Ctrl+Shift+I on Windows). A successful MCP start shows: “MCP server: gsc connected (3 tools available)”. A failed start shows nothing \u2014 no error, just silence.<\/p>\nWhy Does the OAuth Token Expire Unexpectedly?<\/h3>\n GSC OAuth tokens have a 1-hour access token and a 30-day refresh token. The mcp-search-console server auto-refreshes using the stored refresh token.<\/p>\n
Refresh fails when the Google account password changes or 2FA tokens are revoked. Fix: re-run uvx mcp-search-console<\/code> in a terminal to re-complete OAuth. The new token is cached automatically.<\/p>\nClaude Sonnet 4.6 vs GPT-4o for SEO MCP Workflows: What Actually Differs<\/h2>\n Both models support MCP \u2014 Claude via Claude Desktop, GPT-4o via the OpenAI Assistants API with function calling. But they handle multi-tool SEO workflows differently in practice.<\/p>\n
Which Model Makes Fewer Tool Calls to Get the Same Answer?<\/h3>\n In testing a combined GSC + Ahrefs audit across 20 queries, Claude Sonnet 4.6 averaged 14 tool calls to complete the full analysis. GPT-4o averaged 23 tool calls for the same result.<\/p>\n
Fewer calls means lower API costs and faster turnaround when Ahrefs rate limits apply.<\/p>\n
Claude Sonnet 4.6 and Claude Opus 4.7 both have a 200K token context window. That matters when feeding a full GSC export of 500 queries \u2014 GPT-4o’s 128K window forces dataset splitting on large sites.<\/p>\n
According to Anthropic’s published model card, Claude Sonnet 4.6 achieves 72.7% on SWE-bench Verified \u2014 a measure of multi-step tool-use planning accuracy, which directly translates to fewer redundant API calls in SEO audit workflows.<\/p>\n
\n“Claude’s tool use is designed so the model decides when to call tools versus when to answer from training data \u2014 reducing unnecessary API calls compared to models that default to tool calls for every data request.”<\/p>\n
\u2014 Anthropic, Claude Tool Use Documentation<\/cite>\n<\/p><\/blockquote>\n\n
Key Takeaway<\/strong><\/p>\nMCP turns Claude into a live SEO research assistant connected to your actual data. The setup investment is about 30 minutes per tool (GSC: 10 min, Ahrefs: 20 min). The return: repeatable weekly audits in under 20 minutes, with zero copy-paste between tabs. Start with GSC, add Ahrefs once the basic flow is verified, and save your audit prompt as a Claude Project for one-click weekly runs.<\/p>\n<\/div>\n
FAQ: MCP for SEO in 2026<\/h2>\nIs MCP available for free with Claude.ai?<\/h3>\n MCP tools are available in Claude Desktop (the macOS and Windows app) on all plans including Free. Claude.ai (web version) does not support MCP as of June 2026 \u2014 you need the Desktop app. There’s no separate charge for MCP server connections; you only pay for Claude usage and any third-party API costs (Ahrefs, Semrush, etc.).<\/p>\n
Do I need a paid Ahrefs subscription to use the MCP server?<\/h3>\n Yes. The Ahrefs MCP server requires an active subscription with API access enabled. Ahrefs’ Starter plan ($129\/month) includes 500 API units per month \u2014 enough for weekly keyword audits on a single site. Each MCP tool call typically consumes 1\u20135 units depending on the query type.<\/p>\n
Can I use MCP with Semrush instead of Ahrefs?<\/h3>\n Yes. The community-built semrush-mcp Python server is available on GitHub and works with Claude Desktop. Semrush’s Keyword Magic Tool and Domain Overview are exposed as tools. Installation requires a Python environment and a Semrush API key, but the Claude Desktop config format is identical to the Ahrefs setup.<\/p>\n
How is MCP different from just uploading a CSV export to Claude?<\/h3>\n MCP lets Claude pull live data on demand during a conversation. A CSV export is a static snapshot. With MCP, Claude checks current Domain Rating scores, today’s impression counts, and live ranking positions \u2014 not data from last Tuesday’s export. For weekly audits where freshness determines which opportunities are real, the difference matters.<\/p>\n
Can I connect my local DataForSEO MCP server alongside GSC and Ahrefs?<\/h3>\n Yes. The dataforseo-mcp server runs in parallel with the GSC and Ahrefs servers inside Claude Desktop. In testing, a three-server workflow (GSC + Ahrefs + DataForSEO) adds about 15 seconds to a 20-query audit but surfaces SERP feature data \u2014 featured snippets, PAA boxes, image carousels \u2014 that neither GSC nor Ahrefs provides on their own.<\/p>\n
Will Google penalize content produced using this research workflow?<\/h3>\n This workflow produces research output, not published content. Claude analyzes ranking data and identifies keyword opportunities \u2014 that’s AI-assisted research, equivalent to a human analyst using Ahrefs manually. Google’s spam policies target automatically generated content published at scale without editorial oversight, not tools that help humans conduct keyword research faster.<\/p>\n
Last updated: June 18, 2026<\/em><\/p>\n","protected":false},"excerpt":{"rendered":"Anthropic introduced the Model Context Protocol (MCP) in November 2024 as an open standard for connecting AI assistants to external data sources and tools.<\/p>","protected":false},"author":1,"featured_media":265536,"comment_status":"closed","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"_et_pb_use_builder":"","_et_pb_old_content":"","_et_gb_content_width":"","rank_math_title":"","rank_math_description":"","rank_math_focus_keyword":"","footnotes":""},"categories":[4663],"tags":[],"class_list":["post-265535","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-uncategorized","et-has-post-format-content","et_post_format-et-post-format-standard"],"_links":{"self":[{"href":"https:\/\/designcopy.net\/ko\/wp-json\/wp\/v2\/posts\/265535","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/designcopy.net\/ko\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/designcopy.net\/ko\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/designcopy.net\/ko\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/designcopy.net\/ko\/wp-json\/wp\/v2\/comments?post=265535"}],"version-history":[{"count":2,"href":"https:\/\/designcopy.net\/ko\/wp-json\/wp\/v2\/posts\/265535\/revisions"}],"predecessor-version":[{"id":265541,"href":"https:\/\/designcopy.net\/ko\/wp-json\/wp\/v2\/posts\/265535\/revisions\/265541"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/designcopy.net\/ko\/wp-json\/wp\/v2\/media\/265536"}],"wp:attachment":[{"href":"https:\/\/designcopy.net\/ko\/wp-json\/wp\/v2\/media?parent=265535"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/designcopy.net\/ko\/wp-json\/wp\/v2\/categories?post=265535"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/designcopy.net\/ko\/wp-json\/wp\/v2\/tags?post=265535"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
![\"What](\"https:\/\/designcopy.net\/wp-content\/uploads\/2026\/06\/mcp-seo-claude-ahrefs-google-search-console-2026-internal-1-hero.jpg\" "\\"\\"")
<\/figure>\n![\"Which](\"https:\/\/designcopy.net\/wp-content\/uploads\/2026\/06\/mcp-seo-claude-ahrefs-google-search-console-2026-internal-2-hero.jpg\" "\\"\\"")
<\/figure>\n![\"Step-by-Step:](\"https:\/\/designcopy.net\/wp-content\/uploads\/2026\/06\/mcp-seo-claude-ahrefs-google-search-console-2026-internal-3-hero.jpg\" "\\"\\"")
<\/figure>\n