MCP Server

SEO-Tools fuer Claude Code, Cursor und andere MCP-Clients. Nutze kostenlose Tools sofort oder schalte Premium-Analysen mit einem API-Key frei.

Schnellstart

Personalisierte Installationsanleitung
Lade die Anleitung herunter — dein API-Key ist bereits eingetragen. Ziehe die Datei in Claude und bitte ihn, den MCP einzurichten.
Noch kein Claude? Claude herunterladen oder Claude Code (npm install -g @anthropic-ai/claude-code)
Wenn du eingeloggt bist, enthaelt die Datei deinen persoenlichen API-Key. Teile die Datei nicht weiter.
Anleitung herunterladen
1

Remote (kein Install)

Fuege die Server-URL direkt in Claude Code oder Cursor ein. Keine lokale Installation erforderlich. 8 kostenlose Tools funktionieren sofort ohne API-Key.

2

API-Key holen (optional)

Gehe zu Account > API Keys und erstelle einen neuen Key. Der Key beginnt mit lc_. Damit schaltest du alle Premium- und Google-Tools frei.

3

Tools verwenden

Frage Claude Code direkt nach SEO-Daten: Traffic, Keywords, Backlinks, Wettbewerber und mehr - alles aus dem Chat heraus.

Der schnellste Einstieg ist der Remote-Server: keine Installation, keine Abhaengigkeiten. Starte einfach mit dem Befehl aus dem Abschnitt "Einrichtung: Remote Server".

Verfügbare Tools

Der MCP Server stellt 32 Tools bereit. 8 kostenlose Tools funktionieren ohne API-Key. 19 Premium-Tools erfordern einen gueltigen API-Key mit Credits. 5 Google/Projekt-Tools erfordern einen API-Key, verbrauchen aber keine Credits.

Kostenlose Tools (8)

Tool Beschreibung Credits
classify_keywords_simple Keyword-Klassifizierung per lokalem Regex (offline, ohne API): Intent, Brand-Typ, Funnel-Stufe, Thema, Conversion Score. Fuer DataForSEO-gestutzte Analyse: classify_keywords_advanced (kostenpflichtig). Kostenlos
seo_checklist SEO-Checklisten für 5 Typen: general, blog, ecommerce, discover, backlink Kostenlos
seo_guidance SEO Best Practices zu 10 Themen wie technisches SEO, Content, Backlinks, Core Web Vitals und mehr Kostenlos
get_google_guidelines Offizielle Google-Richtlinien nach Kategorie: Helpful Content, EEAT, Spam, Core Updates, Structured Data und mehr Kostenlos
analyze_url_structure URL-SEO-Analyse: Laenge, Lesbarkeit, Keywords in der URL, Sonderzeichen, Empfehlungen Kostenlos
get_account_info Kontostand und Abo-Stufe pruefen: verfuegbare Credits, Subscription-Tier, Kontoinformationen Kostenlos
list_locations Verfuegbare Laender und Regionen fuer ortsspezifische Datenabfragen bei Traffic und Keywords Kostenlos
get_skill SEO-Workflow-Skills abrufen: Fertige Anleitungen fuer SEO-Audits, Keyword-Recherche, Wettbewerberanalyse und mehr. Zeige verfuegbare Skills mit name="list". Kostenlos

Premium-Tools (19)

Premium-Tools erfordern einen gueltigen API-Key mit ausreichend Credits. Die Anzahl der abgezogenen Credits haengt vom Datenvolumen der Abfrage ab. Pruefen deinen Kontostand jederzeit mit get_account_info.
Google-First Fallback: Die Tools get_traffic_snapshot, get_historical_traffic und get_keywords erkennen automatisch ob Google Analytics bzw. Search Console verbunden ist. Falls ja, werden echte Google-Daten verwendet (0 Credits). Falls nicht, wird DataForSEO als Fallback genutzt (kostet Credits). Die Antwort enthaelt ein data_source-Feld mit dem Wert 'google' oder 'dataforseo'.
Tool Beschreibung Credits
classify_keywords_advanced Keyword-Klassifizierung mit DataForSEO Search Intent API + Regex-Classifier: Intent, Brand-Typ, Funnel-Stufe, Thema, Modifier und Conversion Score pro Keyword Dynamisch
get_traffic_snapshot Aktueller Traffic einer Domain. Nutzt automatisch Google Analytics (kostenlos) falls verbunden, sonst DataForSEO (Credits). Antwort enthaelt data_source. Dynamisch
get_historical_traffic Historische Traffic-Trends. Nutzt automatisch Google Analytics (kostenlos) falls verbunden, sonst DataForSEO (Credits, bis 5 Jahre). Antwort enthaelt data_source. Dynamisch
get_keywords Top-Keywords einer Domain. Nutzt automatisch Google Search Console (kostenlos, echte Klick-Daten) falls verbunden, sonst DataForSEO (Credits). Antwort enthaelt data_source. Dynamisch
get_competitors Wettbewerber-Domains nach Keyword-Ueberlappung: gemeinsame Keywords, Traffic-Vergleich, Aehnlichkeits-Score Dynamisch
get_backlinks Backlink-Profil einer Domain: Domain Rating (0-100), Gesamtzahl Backlinks, verweisende Domains, DoFollow/NoFollow-Aufschluesslung Dynamisch
get_referring_domains Verweisende Domains mit Authority-Score, Anzahl Backlinks je Domain und DoFollow-Anteil Dynamisch
validate_keywords Suchvolumen, Wettbewerb (CPC) und Keyword-Schwierigkeit fuer eine Liste von Keywords validieren Dynamisch
crawl_website Website-Crawl mit anschliessender 24-Punkt OnPage-Analyse: Titel, Meta-Tags, Struktur, interne Links, Ladezeit 15-60
onpage_analysis 24-Punkt OnPage SEO-Audit einer einzelnen URL: Title, Meta-Description, H1-H6, Alt-Tags, kanonische URL, Robots-Direktiven 15
check_serp Live Google SERP-Ergebnisse fuer ein Keyword: Top-10 organische Resultate mit Position, URL, Domain, Titel — fuer Wettbewerbsanalyse und Content-Gap-Erkennung 15
check_links Broken-Link-Erkennung fuer eine Domain oder URL: HTTP-Status-Codes, tote Links, Weiterleitungsketten 20
check_pagespeed Google PageSpeed Insights + Core Web Vitals: Performance-, Accessibility- und SEO-Score, LCP, CLS, TBT, FCP sowie Top-Optimierungsvorschlaege 5
audit_sitemap XML-Sitemap-Audit: Gesamtzahl URLs, Duplikate, Broken Links (Stichprobe bis 200 URLs), lastmod-Abdeckung, Sitemap-Struktur 20
check_structured_data JSON-LD und Microdata Validierung: Schema-Typen erkennen, Pflichtfelder pruefen, Fehler und Warnungen fuer Article, Product, Organization, FAQPage etc. 5
check_hreflang Hreflang-Validierung: x-default vorhanden, Sprachcodes gueltig, alle Ziel-URLs erreichbar, bidirektionale Verlinkung geprueft 10
seo_agent SEO-Agent-System: 6 spezialisierte Agenten fuer Crawling, SEO-Analyse, Strategie, Copywriting, Content-Review und Beratung Dynamisch
seo_workflow Mehrstufige SEO-Workflows mit Report-Generierung: seo_performance_audit (GSC-Analyse + PDF, Keyword-Performance-Report) und indexing_diagnosis 150-200
query_knowledge_base RAG-Suche ueber die SEO-Wissensdatenbank: Blog-Artikel, Dokumentation, Google-Richtlinien — semantische Volltextsuche nach Relevanz und Aktualitaet 2

Google- und Projekt-Tools (5)

Diese Tools greifen auf deine eigenen Google-Daten zu und verbrauchen keine Credits. Voraussetzung: Google OAuth muss unter Account > Google-Verbindungen eingerichtet sein.
Tool Beschreibung Credits
list_projects EEAT-Projekte auflisten mit Scores, Status und Anzahl der Wettbewerber Kostenlos
get_project Projektdetails inkl. Wettbewerber und Google-Verbindungsstatus (GSC/GA4) abrufen Kostenlos
get_google_connections Verbundene Google Search Console- und Analytics-4-Properties sowie GSC-GA4-Paarungen anzeigen Kostenlos
query_search_console Google Search Console abfragen: Keywords, Seiten, Laender, Geraete. Property wird automatisch erkannt. Kostenlos
query_analytics Google Analytics 4 abfragen: Traffic-Uebersicht, Top-Seiten, Traffic-Quellen oder E-Commerce-Umsatz. Property wird automatisch erkannt. Kostenlos

Skills & Workflows

Skills sind fertige SEO-Workflows mit Methodik, Schritten und Quality Gates. Im SEO Copilot Chat werden sie per @-Befehl ausgelöst. Per MCP werden sie über das get_skill-Tool geladen.

Im Copilot Chat: Tippe @ um das Workflow-Menue zu oeffnen. Beispiel: @full-seo-audit example.com Per MCP-Tool: get_skill(name="list")
Workflow Beschreibung Credits (ca.)
@full-seo-audit Komplett-Audit: Sitemap-Crawl, PageSpeed/CWV, Structured Data, Hreflang, Backlinks, Keywords, Wettbewerber — mit P1/P2/P3-Priorisierung und 30-60-90 Tage Roadmap 300–500
@quick-seo-audit Schnell-Audit: 100-Seiten-Stichprobe, PageSpeed, Kern-Checks, Health-Score — ideal fuer Ersteinschaetzung oder Monitoring 80–120
@seo-audit Standard SEO-Audit: Traffic, Keywords, OnPage, Backlinks, Wettbewerber — nach dem 4-Phasen Neuro-SEO-Ansatz 80–120
@keyword-optimization Keyword-Optimierung: Live SERP-Check, GSC-Daten, Close-Variant-Analyse, Seiten-Crawl, OnPage-Score, priorisierte Strategie 55–70
@keyword-research Keyword-Recherche mit Suchvolumen-Validierung, Intent-Klassifizierung, Cluster-Bildung und Quick-Win-Identifikation 20–40
@keyword-performance-report Keyword-Performance-Deep-Dive: Ranking-Verteilung, Intent-Mapping, CTR-Benchmarking, Quick-Win-Priorisierung, Cannibalisierung 20–30
@seo-potential-report Potenzialanalyse mit CTR-Modell, Cluster-Breakdown, Lead-Berechnung, SEA-Aequivalenz, Phasen-Angebot und ROI 50–80
@competitor-analysis Wettbewerbsvergleich: Keyword-Luecken, Traffic-Vergleich, Backlink-Authority, Ranking-Verteilung 40–60
@traffic-analysis Traffic-Analyse mit historischen Trends, SEA-Aequivalenz-Berechnung und Wachstumsprognose 15–30
@gsc-report Google Search Console Report: Top-Queries, Seiten, CTR-Benchmarking gegen Keyword Study 2026, Quick Wins 0
@site-health-check Website-Gesundheitscheck: Broken Links, OnPage-Probleme, Crawlbarkeit, Indexierung 30–50
@seo-structure-check Technische SEO-Struktur-Pruefung: URL-Routing, Canonical-URLs, Sitemap, robots.txt, Hreflang 30–50

Workflow aufrufen

Im SEO Copilot Chat

Tippe @ im Chat-Eingabefeld, ein Dropdown zeigt alle verfügbaren Workflows:

# Beispiele fuer den Copilot Chat: @full-seo-audit example.com @quick-seo-audit example.com @keyword-optimization "Ehering aus Gold" example.com @seo-potential-report example.com DE-Markt

Per MCP-Tool (Claude Code, Cursor etc.)

Nutze das get_skill-Tool um den Workflow-Leitfaden zu laden:

# Alle verfuegbaren Skills anzeigen: get_skill(name="list") # Einen Skill laden (z.B. Full SEO Audit): get_skill(name="full-seo-audit") # Oder direkt im Prompt: # "Lade den full-seo-audit Skill und fuehre ihn fuer example.com aus" # monatliches SEA-Budget 20.000 EUR, B2B Industrie"
Skills laufen vollstaendig automatisch ab. Claude laedt den Skill, fuehrt alle notwendigen MCP-Tool-Aufrufe durch und liefert einen strukturierten Report — ohne manuelle Zwischenschritte.

Einrichtung: Remote Server (empfohlen)

Der Remote-Server laeuft auf unserer Infrastruktur. Du musst nichts installieren. Fuege einfach die Server-URL zu deiner MCP-Konfiguration hinzu.

Claude Code CLI

# PowerShell / Windows (mit API-Key, alle 32 Tools verfuegbar): claude mcp add --transport http visiblyai https://mcp.visibly-ai.com/mcp --header "Authorization: Bearer lc_your_key" # PowerShell / Windows (ohne API-Key, nur 8 kostenlose Tools): claude mcp add --transport http visiblyai https://mcp.visibly-ai.com/mcp
Wichtig für PowerShell: Nutze den Befehl als Einzeiler. Der Backslash \ ist dort keine gültige Zeilenfortsetzung für claude mcp add und fuehrt leicht zu Parser-Fehlern.

JSON-Konfiguration (settings.json / mcp_servers.json)

Fuer Cursor, VS Code und andere Clients, die eine JSON-Konfigurationsdatei verwenden:

{ "mcpServers": { "visiblyai": { "type": "http", "url": "https://mcp.visibly-ai.com/mcp", "headers": { "Authorization": "Bearer lc_your_key" } } } }
Ersetze lc_your_key durch deinen echten API-Key aus Account > API Keys. Ohne den headers-Block funktionieren nur die 8 kostenlosen Tools.

Verbindung testen

Nach dem Hinzufuegen kannst du die Verbindung direkt im Chat testen:

# Kontostand und verfuegbare Credits pruefen: # Frage Claude: "Wie viele Credits habe ich noch? Nutze das get_account_info Tool." # Kostenlose URL-Analyse ohne Key: # Frage Claude: "Analysiere die URL-Struktur von https://example.com/produkte/seo-tools"

Einrichtung: pip install

Installiere das Paket lokal und registriere es als stdio-Transport. Geeignet wenn du den Server lokal ausfuehren oder anpassen moechtest.

Installation und Registrierung

# Paket installieren: pip install visiblyai-mcp-server # In Claude Code registrieren (PowerShell / Windows): claude mcp add --transport stdio -e VISIBLYAI_API_KEY=lc_your_key visiblyai -- visiblyai-mcp-server

JSON-Konfiguration (stdio)

{ "mcpServers": { "visiblyai": { "type": "stdio", "command": "visiblyai-mcp-server", "env": { "VISIBLYAI_API_KEY": "lc_your_key" } } } }
Der stdio-Transport startet den Server als lokalen Prozess. Der Remote-Transport (HTTP) ist fuer die meisten Anwender einfacher, da er keine lokale Installation benoetigt.

Einrichtung: uvx

Mit uvx kannst du den Server direkt ausfuehren, ohne ihn vorher zu installieren. Das Paket wird bei jedem Start automatisch bezogen.

Claude Code CLI mit uvx

# Direkt ausfuehren ohne vorherige Installation (PowerShell / Windows): claude mcp add --transport stdio -e VISIBLYAI_API_KEY=lc_your_key visiblyai -- uvx visiblyai-mcp-server

JSON-Konfiguration (uvx)

{ "mcpServers": { "visiblyai": { "type": "stdio", "command": "uvx", "args": ["visiblyai-mcp-server"], "env": { "VISIBLYAI_API_KEY": "lc_your_key" } } } }
uvx benötigt uv als Package-Manager. Falls nicht vorhanden, installiere es mit pip install uv oder besuche docs.astral.sh/uv.

Authentifizierung

Der MCP Server akzeptiert einen Bearer-Token im Authorization-Header:

Authorization: Bearer lc_your_api_key_here

API-Keys verwaltest du unter /account/api-keys.

Key-Format

Eigenschaft Wert
Prefix lc_
Beispiel lc_a1b2c3d4e5f6789...
Erstellen Account > API Keys
Sichtbarkeit Wird nur einmal bei Erstellung angezeigt

Zugriffsstufen

Szenario Verfügbare Tools
Ohne API-Key 8 kostenlose Tools (classify_keywords_simple, seo_checklist, seo_guidance, get_google_guidelines, get_skill, analyze_url_structure, get_account_info, list_locations)
Mit API-Key, genuegend Credits Alle 32 Tools
Mit API-Key, keine Credits 8 kostenlose Tools + 5 Google/Projekt-Tools + Fehlermeldung bei Premium-Tools
Inaktive oder geloeschte API-Keys werden sofort mit dem Fehlercode -32001 (Authentication required) abgelehnt. Jeder API-Key ist an ein Konto gebunden und hat Zugriff nur auf die Credits des jeweiligen Kontos.

Rate Limits

Der MCP Server begrenzt die Anzahl der Anfragen pro Zeitfenster, um eine faire Nutzung sicherzustellen.

Grenzwert Wert Basis
Anfragen pro Minute 60 Pro API-Key (in-memory)
Anfragen pro Minute (anonym) 10 Pro IP-Adresse

Bei Ueberschreitung gibt der Server den JSON-RPC-Fehlercode -32000 (Rate limit exceeded) zurueck. Warte kurz und sende die Anfrage erneut.

Rate Limits werden im Arbeitsspeicher gehalten und zurueckgesetzt, wenn der Server neu gestartet wird. Sie sind pro API-Key isoliert, sodass ein anderer Nutzer dein Limit nicht beeinflusst.

Fehler-Antworten

Der MCP Server gibt Fehler als JSON-RPC-Fehlerobjekte zurück:

{ "jsonrpc": "2.0", "id": 1, "error": { "code": -32001, "message": "Authentication required. Provide a valid API key." } }
Code Bedeutung Ursache
-32700 Parse error Ungueltige JSON-Anfrage konnte nicht geparst werden
-32600 Invalid request Die JSON-Anfrage entspricht nicht dem JSON-RPC 2.0 Format
-32601 Method not found Das angeforderte Tool oder die Methode existiert nicht
-32602 Invalid params Ein erforderlicher Parameter fehlt oder hat einen ungueltigen Wert
-32603 Internal error Interner Serverfehler beim Verarbeiten der Anfrage
-32001 Authentication required Kein oder ungueltiger API-Key angegeben. Tool erfordert Authentifizierung.
-32002 Insufficient credits Nicht genuegend Credits fuer diese Aktion. Lade Credits auf oder upgrade dein Abo.
-32000 Rate limit exceeded Zu viele Anfragen pro Minute. Warte kurz und versuche es erneut.

Credit-System

Premium-Tools verbrauchen Credits aus deinem Konto. Die Anzahl der abgezogenen Credits haengt vom Umfang der Abfrage ab.

Credit-Abzug

Preismodell Beschreibung Betroffene Tools
Kostenlos Kein Credit-Abzug. Kein API-Key erforderlich. seo_checklist, seo_guidance, analyze_url_structure, get_account_info, list_locations, list_projects, get_project, get_google_connections, query_search_console, query_analytics
Dynamisch Credit-Abzug basierend auf Datenvolumen der Antwort (Anzahl Keywords, Domains, Datenpunkte) classify_keywords_advanced, get_traffic_snapshot, get_historical_traffic, get_keywords, get_competitors, get_backlinks, get_referring_domains, validate_keywords, seo_agent
5 Festpreis: 5 Credits pro Aufruf check_pagespeed, check_structured_data
10 Festpreis: 10 Credits pro Aufruf check_hreflang
15 Festpreis: 15 Credits pro Aufruf onpage_analysis, check_serp
15-60 Gestaffelter Preis: 15 Credits fuer kleine Websites, bis zu 60 Credits fuer grosse Crawls crawl_website
20 Festpreis: 20 Credits pro Aufruf check_links, audit_sitemap
150-200 Mehrstufiger Workflow mit Report: 150 Credits (Performance-Audit), 200 Credits (Indexierungs-Diagnose) seo_workflow

Kontostand pruefen

Pruefe deinen Kontostand jederzeit mit dem kostenlosen get_account_info-Tool:

# Frage Claude Code im Chat: # "Wie viele Credits habe ich noch auf meinem visiblyai-Konto?" # Claude ruft automatisch get_account_info auf und zeigt dir: # - Verfuegbare Credits # - Abo-Stufe (Free / Standard / Pro / Agency) # - Kontoinformationen

Abo-Stufen

Stufe Credits / Monat Projekte
Free 0 1
Standard 2.500 3
Pro 10.000 10
Agency 50.000 50
Credits werden am Anfang jedes Abrechnungszeitraums erneuert und verfallen nicht auf die naechste Periode. Nicht verbrauchte Credits werden nicht uebertragen.
Cookie-Settings