MCP Server/Connect Claude Code

MCP Guide · Free · Read-only

Connect Claude Code to SEOMentor

If you're already fixing SEO issues in your codebase with Claude Code, this lets it check the real scan data and Search Console numbers behind whatever you're changing — no switching to a browser tab to look something up.

Before you start

A SEOMentor account with at least one completed scan
Claude Code installed and signed in

Connect in 3 steps

Add the server from your terminal

Run this from any project directory — it registers SEOMentor as a remote MCP server for Claude Code.

claude mcp add --transport http seomentor https://www.seomentor.io/mcp

Complete the OAuth sign-in

Claude Code opens your browser to SEOMentor's sign-in and consent screen. Approve it there, then return to the terminal.

Confirm it's connected

List your configured servers to verify SEOMentor shows up and is authenticated.

claude mcp list

Try it once connected

Ask these, word for word or close to it — Claude Code calls SEOMentor's MCP tools behind the scenes and answers using your real account data.

You ask:

“List the sites I've scanned in SEOMentor and their current SEO scores.”

Example of what comes back:

Claude Code calls list_sites and prints each site's hostname, score, and which integrations (GSC/GA4) are connected — useful as a quick sanity check before starting work.

You ask:

“Pull the latest scan for [yoursite.com] and summarize the top 3 technical issues.”

Example of what comes back:

It calls get_scan_results for that site, reads through the technical SEO, speed, and image data, and ranks the issues by likely impact before summarizing them.

You ask:

“Compare organic clicks against total sessions for [yoursite.com] over the last 28 days.”

Example of what comes back:

It calls both get_gsc_performance and get_ga_traffic, then lines up the two numbers side by side so you can see what share of real traffic is coming from search.

What Claude Code can and can't do

Every tool on SEOMentor's MCP server is read-only. Claude Code can pull your scan results, Search Console and Analytics data, and score history — it can't start a new scan, change a setting, or touch billing. The connection uses OAuth, so you approve it once on a consent screen and can revoke it anytime from SEOMentor settings or from Claude Code itself.

Troubleshooting

The add command errors out or isn't recognized

Claude Code's CLI flags change between versions — run claude mcp add --help to check the exact syntax your installed version expects, the --transport http part is the piece most likely to differ.

It added the server but authentication never completes

Make sure your terminal session can open a browser (this fails over SSH/remote sessions without a browser to redirect to — Claude Code has a manual auth-code flow for that case, check claude mcp --help).

get_scan_results returns nothing for a site I know I scanned

Double check the hostname matches exactly what's in SEOMentor (with or without www can matter) — try list_sites first to get the exact hostname string to use.

Disconnect anytime

—Run claude mcp remove seomentor from your terminal.
—Or in SEOMentor: Settings → Connected Apps → revoke Claude Code's access.

FAQ

Does this work the same in every project directory?

Depends how you added it — a user-level connection is available everywhere, a project-level one only applies inside that project's config. Check claude mcp add --help for the scope flags.

Can it edit my code based on the SEO data?

The MCP server itself only returns data — it can't touch your files. Whether Claude Code then edits code based on what it reads is a normal Claude Code action, same as anything else you ask it to do.

Is this the same connection as Claude web/desktop?

No, each client authenticates separately. Connecting Claude Code doesn't automatically connect Claude.ai, and vice versa.

No SEOMentor account yet?

Get started free