Łączenie MCP Server z Claude Code

Zamiast klikać w interfejsie Rankion, można sterować wszystkimi narzędziami SEO bezpośrednio z terminala — w naturalnym języku. Claude Code komunikuje się z kontem Rankion przez Model Context Protocol (MCP) i może robić wszystko, co API: researching słów kluczowych, tworzenie artykułów, śledzenie AI Visibility.

Czym jest MCP?

Model Context Protocol to otwarty standard umożliwiający asystentom AI (Claude Code, Cursor i innym) dostęp do zewnętrznych narzędzi i źródeł danych. Rankion udostępnia serwer MCP, który eksponuje każdy endpoint API jako „narzędzie" dla asystenta.

Tworzenie tokenu API w Rankion

W Rankion należy przejść do Settings → API & Integrations → „+ Nowy token". Należy nadać opisową nazwę (np. „Claude Code Mac"), wybrać zakresy (dla pełnego dostępu: „all") i od razu skopiować token — jest wyświetlany tylko raz.

⚠️

Uwaga

Token należy traktować jak hasło. Kto go posiada, może uzyskać dostęp do danych ORAZ zużywać Credits. Nigdy nie należy umieszczać go w publicznych repozytoriach.

Konfiguracja serwera MCP w Claude Code

Otwórz konfigurację MCP Claude Code (`~/.claude/mcp_servers.json` lub przez `claude mcp add`). Dodaj następujący wpis:

json

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

Alternatywnie jako one-liner przez Claude CLI:

bash

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

Testowanie połączenia

Uruchom ponownie Claude Code. W dowolnej sesji wpisz:

text

Liste meine Rankion-Projekte auf

Jeśli połączenie działa, Claude odpowie listą projektów. Jeśli nie: sprawdź token (czy jest ważny?), składnię JSON w konfiguracji (przecinki?) oraz czy `npx` jest dostępny w `$PATH`.

Pierwsze prawdziwe polecenia

Trzy przykłady pokazujące, do czego MCP naprawdę się przydaje:

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.

Bardziej złożone przepływy pracy

Prawdziwa siła tkwi w tym, że Claude samodzielnie łączy narzędzia MCP. Wystarczy podać cel, a Claude orkiestruje kolejne kroki. Przykład:

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.

✓

Wynik

Efekt: SEO Co-Pilot dostępny bezpośrednio w terminalu — nie tylko pobiera dane, ale aktywnie proponuje i realizuje strategie, bez konieczności otwierania interfejsu webowego.

Czego się Pan/Pani nauczył/nauczyła

✓ MCP jako otwarty standard łączenia asystentów AI z narzędziami — zrozumiany
✓ Token API z właściwym zakresem uprawnień — utworzony i bezpiecznie zapisany
✓ Wpis serwera MCP w `~/.claude/mcp_servers.json` — skonfigurowany
✓ Połączenie zweryfikowane poleceniem „Wyświetl moje projekty"
✓ Wieloetapowe przepływy pracy (research → porównanie → briefingi) orkiestrowane językiem naturalnym

Łączenie MCP Server z Claude Code

Czym jest MCP?

Tworzenie tokenu API w Rankion

Konfiguracja serwera MCP w Claude Code

Testowanie połączenia

Pierwsze prawdziwe polecenia

Bardziej złożone przepływy pracy

Czego się Pan/Pani nauczył/nauczyła

Wypróbuj teraz samodzielnie