rankion.ai
Advanced 15 min read

Connect MCP Server with Claude Code

Instead of clicking through the Rankion UI, control all SEO tools directly from your terminal — in natural language. Claude Code speaks to your Rankion account via the Model Context Protocol (MCP) and can do everything the API can: research keywords, create articles, track AI visibility.

01

What is MCP?

The Model Context Protocol is an open standard letting AI assistants (Claude Code, Cursor, others) access external tools and data sources. Rankion provides an MCP server exposing every API endpoint as a "tool" for the assistant.

02

Create API token in Rankion

In Rankion, go to Settings → API & Integrations → "+ New Token". Give a meaningful name (e.g. "Claude Code Mac"), select scopes (full access: "all"), and copy the token immediately — shown only once.

⚠️

Heads up

Treat the token like a password. Whoever has it can access your data AND spend credits. Never push to public repos.

03

Configure MCP server in Claude Code

Open your Claude Code MCP config (`~/.claude/mcp_servers.json` or via `claude mcp add`). Add this entry:

json
{
  "mcpServers": {
    "rankion": {
      "command": "npx",
      "args": ["-y", "@rankion/mcp-server"],
      "env": {
        "RANKION_API_TOKEN": "rk_live_xxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Alternatively as one-liner via the Claude CLI.

bash
claude mcp add rankion \
  --command "npx -y @rankion/mcp-server" \
  --env RANKION_API_TOKEN=rk_live_xxxxxxxxxxxxxxxxxxxxxx
04

Test the connection

Restart Claude Code. In any session, type.

text
Liste meine Rankion-Projekte auf

If the connection works, Claude responds with your project list. If not: check token (valid?), JSON syntax (commas?), and that `npx` is in your `$PATH`.

05

First real commands

Three examples that show what MCP is really useful for.

text
# Keyword-Recherche aus dem Terminal
> Mach eine A-Z-Expansion für "nachhaltige rucksäcke" im Projekt "Outdoor"
  und gib mir die Top-20-Keywords nach Suchvolumen.

# Artikel direkt erstellen lassen
> Generiere im Projekt "Outdoor" einen Artikel für das Keyword
  "wanderrucksack 30l damen test 2026" und exportiere ihn als Markdown
  in ./content/.

# AI-Visibility-Report on demand
> Wie ist meine Mention Rate bei "beste seo tools 2026" diese Woche
  in ChatGPT und Perplexity? Vergleiche mit letzter Woche.
06

More complex workflows

The real lever: Claude chains MCP tools autonomously. You set a goal, Claude orchestrates the steps. Example.

text
> Analysiere das Top-3-Keyword im Projekt "Magazin" auf AI-Sichtbarkeit,
  finde drei Wettbewerber, die besser ranken, identifiziere die fehlenden
  Subtopics und schlage drei neue Artikel vor mit Briefings, die ich
  direkt in Bulk Generation kippen kann.

Result

Result: An SEO co-pilot directly in your terminal that doesn't just fetch data but actively suggests and executes strategies — without ever opening the web UI.

What you learned

  • Understood MCP as open standard for connecting AI assistants with tools
  • Created API token with correct scope and stored securely
  • Configured MCP server entry in `~/.claude/mcp_servers.json`
  • Verified connection with "list my projects" command
  • Orchestrated multi-step workflows (research → comparison → briefs) via natural language

Try it yourself

50 free credits. No credit card required.

Start for free

Cookies: We use necessary cookies for functionality and optional ones for improvements. Details

Necessary
Active
Analytics
Marketing