Crawlens mit Claude & anderen KI-Tools verbinden
Crawlens enthält einen MCP-Server. Ist er verbunden, kann die KI-App, die Sie bereits nutzen, Ihre Crawls und Audits lesen, Probleme erklären, Fixes priorisieren und Tickets schreiben. Dafür nutzen Sie Ihr eigenes KI-Abo, ein API-Key ist nicht nötig.
Die Oberfläche von Crawlens gibt es derzeit nur auf Englisch. Namen von Einstellungen, Buttons, Tools und Prompts stehen hier deshalb auf Englisch, damit Sie sie in der App sofort finden.
Was er tut
MCP (Model Context Protocol) ist der Standardweg, über den KI-Apps externe Tools nutzen. Braucht Ihre KI-App Daten aus Crawlens, startet sie den MCP-Server von Crawlens auf Ihrem Computer. Der Server liest Ihre gespeicherten Crawls und Audits und liefert kompakte, seitenweise Ergebnisse zurück.
- Nur lesend. Er kann keine Crawls starten, keine Einstellungen ändern und nichts löschen.
- Lokal. Er läuft auf Ihrem Computer und öffnet keinen Netzwerk-Port. Crawlens selbst lädt nichts hoch.
- Crawlens muss nicht geöffnet sein. Die KI-App startet den Server bei Bedarf mit der Laufzeitumgebung von Crawlens. Node.js müssen Sie nicht installieren.
1. In Crawlens einschalten
Die Freigabe ist standardmäßig aus. KI-Tools sehen nichts, bis Sie sie einschalten.
- Öffnen Sie Crawlens und gehen Sie zu Settings → Integrations → AI tools (MCP).
- Schalten Sie Share audits with AI tools ein.
- Behalten Sie unter Projects AI tools can read die Option All projects bei, oder wählen Sie Only these projects.
- Optional: Schalten Sie Hide Search Console and Analytics data ein, damit Klicks, Impressionen, Sitzungen und Ergebnisse der URL-Prüfung für KI-Tools unsichtbar bleiben.
Sie brauchen mindestens ein Projekt mit einem auditierten Crawl. Wenn Sie noch nichts gecrawlt haben, holen Sie das zuerst nach. Bis dahin hat die KI nichts zu lesen.
2. KI-Tool verbinden
In derselben Einstellungskarte gibt es für jede App einen Button Copy setup for. Nutzen Sie ihn: Er setzt die genauen Pfade Ihrer Installation ein. Die folgenden Snippets zeigen, wie dieses Setup aussieht, mit Platzhalter-Pfaden.
Claude Desktop
- Klicken Sie auf Add to Claude Desktop.
- Beenden Sie Claude Desktop und öffnen Sie es neu. Das Fenster zu schließen reicht nicht: Beenden Sie die App über den Infobereich der Taskleiste.
- Öffnen Sie in einem neuen Chat das Tools-Menü. Dort sollte
crawlensaufgeführt sein.
Crawlens trägt sich in claude_desktop_config.json ein und behält Ihre anderen MCP-Server bei. Gibt es die Datei schon, legt Crawlens vorher eine datierte Sicherung daneben ab. Sowohl die normale Version von Claude Desktop als auch die aus dem Microsoft Store werden unterstützt.
Lieber die Konfiguration selbst bearbeiten?
Fügen Sie dies in %APPDATA%\Claude\claude_desktop_config.json ein und führen Sie es mit eventuell vorhandenen mcpServers zusammen:
{
"mcpServers": {
"crawlens": {
"command": "C:\\path\\to\\Crawlens.exe",
"args": ["C:\\path\\to\\resources\\mcp\\server.mjs", "--user-data", "C:\\Users\\you\\AppData\\Roaming\\Crawlens"],
"env": { "ELECTRON_RUN_AS_NODE": "1" }
}
}
}Claude Code
- Klicken Sie auf Copy setup for → Claude Code.
- Fügen Sie den Befehl in ein Terminal ein und führen Sie ihn aus.
- Starten Sie
claudeund führen Sie/mcpaus, um zu prüfen, obcrawlensverbunden ist.
Der Befehl registriert Crawlens für Ihr Benutzerkonto (--scope user), sodass es in jedem Projekt verfügbar ist:
claude mcp add crawlens --scope user --env ELECTRON_RUN_AS_NODE=1 -- "C:\path\to\Crawlens.exe" "C:\path\to\resources\mcp\server.mjs" --user-data "C:\Users\you\AppData\Roaming\Crawlens"Codex
Ein Setup deckt die Codex CLI, die IDE-Erweiterung und die App ab.
- Klicken Sie auf Copy setup for → Codex.
- Fügen Sie es am Ende von
~/.codex/config.tomlein (legen Sie die Datei an, falls es sie noch nicht gibt). - Starten Sie Codex neu.
[mcp_servers.crawlens]
command = 'C:\path\to\Crawlens.exe'
args = ['C:\path\to\resources\mcp\server.mjs', '--user-data', 'C:\Users\you\AppData\Roaming\Crawlens']
[mcp_servers.crawlens.env]
ELECTRON_RUN_AS_NODE = '1'Das kopierte Setup enthält als Kommentar auch den entsprechenden Befehl codex mcp add …, falls Sie den lieber ausführen.
Cursor
- Klicken Sie auf Copy setup for → Cursor.
- Öffnen Sie
~/.cursor/mcp.jsonund fügen Sie es ein. Enthält die Datei schon Server, ergänzen Sie den Eintragcrawlensinnerhalb der vorhandenenmcpServers. - Prüfen Sie Cursor Settings → MCP:
crawlenssollte als aktiviert angezeigt werden.
{
"mcpServers": {
"crawlens": {
"command": "C:\\path\\to\\Crawlens.exe",
"args": ["C:\\path\\to\\resources\\mcp\\server.mjs", "--user-data", "C:\\Users\\you\\AppData\\Roaming\\Crawlens"],
"env": { "ELECTRON_RUN_AS_NODE": "1" }
}
}
}VS Code
- Klicken Sie auf Copy setup for → VS Code.
- Fügen Sie es in
.vscode/mcp.jsonin Ihrem Workspace ein. Alternativ führen Sie MCP: Add Server über die Befehlspalette aus. - Öffnen Sie Copilot Chat im Agent-Modus und suchen Sie
crawlensin der Tool-Liste.
{
"servers": {
"crawlens": {
"type": "stdio",
"command": "C:\\path\\to\\Crawlens.exe",
"args": ["C:\\path\\to\\resources\\mcp\\server.mjs", "--user-data", "C:\\Users\\you\\AppData\\Roaming\\Crawlens"],
"env": { "ELECTRON_RUN_AS_NODE": "1" }
}
}
}Andere MCP-Apps: Alles, was stdio-MCP-Server unterstützt, funktioniert. Verwenden Sie denselben Befehl, dieselben Argumente und dieselbe Umgebungsvariable ELECTRON_RUN_AS_NODE=1 wie oben.
3. Verbindung testen
Klicken Sie in Crawlens auf Test connection. Crawlens startet den Server genau so, wie es Ihre KI-App tun wird, und meldet, was es gefunden hat, zum Beispiel:
Klappt das, aber Ihre KI-App zeigt Crawlens nicht an, liegt das Problem bei der App. Starten Sie die App neu und lesen Sie die Fehlerbehebung.
Was Sie fragen können
Nennen Sie Ihr Projekt beim Namen oder bei der Domain. Sie können auf Deutsch fragen. Einige Prompts, die gut funktionieren:
Fasse das letzte Crawlens-Audit von example.com zusammen und gib mir eine priorisierte Liste der Fixes.
Schreib neue Titles für die Seiten ohne Title.
Erkläre unserem Entwickler die Weiterleitungsketten.
Was ist seit dem letzten Crawl schlechter geworden?
Welche Seiten bekommen Klicks aus der Suche, liefern aber Fehler oder stehen auf noindex?
Finde indexierbare Seiten auf Position 11–20 und schlag vor, wie sie auf Seite eins kommen.
Tools & Prompts
Diese sieht Ihre KI-App. Die Ergebnisse sind seitenweise aufgeteilt (standardmäßig 50 Zeilen), damit große Websites das Gespräch nicht überfluten.
| Tool | Was es liefert |
|---|---|
list_projects | Die von Crawlens freigegebenen Projekte mit ihrem letzten Crawl. |
list_crawls | Die Crawls eines Projekts, neueste zuerst, mit Health Score und Anzahl der Probleme. |
get_overview | Zusammenfassung eines auditierten Crawls: Health Score, Probleme nach Schweregrad, Top-Probleme, Statuscodes, Indexierbarkeit, Core Web Vitals sowie Summen aus Search Console, Analytics und Server-Logs, wenn vorhanden. |
list_issues | Jeder Check mit Problemen: was er bedeutet, wie Sie ihn beheben und wie viele URLs betroffen sind (die schwersten zuerst). |
get_issue_urls | Die von einem Problem betroffenen URLs mit den Details zu jeder URL. |
query_urls | Gecrawlte URLs filtern, sortieren und durchblättern wie in der URL-Tabelle, einschließlich Spalten aus Search Console, GA4 und eigener Extraktion. |
get_url_details | Alles zu einer URL: SEO-Felder, Probleme, Links, Weiterleitungen, Header, strukturierte Daten, Roh- vs. gerendertes HTML, Core Web Vitals und Suchdaten. |
compare_crawls | Was sich zwischen zwei Crawls geändert hat: Health Score, neue und behobene Probleme pro Check und Änderungen an URLs. |
Fertige Prompts erscheinen, wo unterstützt, im Prompt- oder Slash-Befehl-Menü Ihrer KI-App:
| Prompt | Was er tut |
|---|---|
| Summarise the audit & prioritise fixes | Management-Zusammenfassung des letzten Audits und ein Plan der Fixes, geordnet nach Wirkung und Aufwand, mit Zuständigkeit und Beispiel-URLs für jeden Punkt. |
| Rewrite titles & meta descriptions | Neue Titles (30–60 Zeichen) und Descriptions (70–160) für Seiten mit Problemen bei Title oder Description, jeweils in der Sprache der Seite. |
| Explain an issue for developers | Ein Problem, erklärt mit den echten URLs und Werten dieser Website: Ursache, Prüfung, Lösung und eine Checkliste. |
Datenschutz & Sicherheit
- Aus, bis Sie es einschalten, und jederzeit wieder abschaltbar. Der Server lehnt dann jede Anfrage ab.
- Nur lesend. Der Server öffnet Ihre Daten schreibgeschützt. Er kann nicht crawlen, keine Einstellungen ändern und nichts löschen.
- Kein Netzwerk-Port. Er kommuniziert mit Ihrer KI-App nur über die Standardein- und -ausgabe auf Ihrem Computer.
- Sie entscheiden, was sichtbar ist: alle Projekte oder nur einige, mit oder ohne Daten aus Search Console und Analytics.
Crawlens lädt nichts hoch, aber Ihre KI-App sendet das Gelesene als Teil des Gesprächs an ihren eigenen KI-Dienst. Dafür gelten die Datenschutzbedingungen der KI-App. Prüfen Sie sie, bevor Sie Kundendaten freigeben.
Fehlerbehebung
- Crawlens erscheint nicht in meiner KI-App
- Starten Sie die App nach dem Einrichten vollständig neu. Claude Desktop läuft im Infobereich der Taskleiste weiter, beenden Sie es also dort. Prüfen Sie bei Cursor und VS Code, ob das JSON nach dem Einfügen noch gültig ist: Ein fehlendes Komma macht die ganze Datei unbrauchbar.
- „Sharing audits with AI tools is turned off“
- Schalten Sie Share audits with AI tools unter Settings → Integrations → AI tools (MCP) ein.
- „No shared project matches …“
- Das Projekt steht nicht in der Liste, die KI-Tools lesen dürfen, oder der Name passt nicht. Die Fehlermeldung nennt die verfügbaren Projekte. Fügen Sie das Projekt unter Projects AI tools can read hinzu, oder fragen Sie mit einem dieser Namen.
- „This project has no audited crawl yet“
- Crawlen Sie die Website zuerst in Crawlens. Die KI liest Audits und braucht deshalb mindestens einen abgeschlossenen, auditierten Crawl.
- „This data was saved by an older Crawlens“
- Öffnen Sie das Projekt einmal in Crawlens. Damit werden seine Daten aktualisiert, und die KI-App kann sie wieder lesen.
- Es funktioniert nicht mehr, seit ich Crawlens verschoben oder neu installiert habe
- Das Setup enthält den Pfad zu
Crawlens.exe. Kopieren Sie das Setup erneut aus Crawlens (oder klicken Sie noch einmal auf Add to Claude Desktop), damit die Pfade stimmen. Den Datenordner innerhalb von Crawlens zu verschieben ist dagegen kein Problem: Der Server folgt ihm automatisch. - „… is not valid JSON, so Crawlens left it untouched“
- Ihre
claude_desktop_config.jsonhatte bereits einen Syntaxfehler, deshalb hat Crawlens sie nicht verändert. Korrigieren oder entfernen Sie die Datei und klicken Sie dann erneut auf Add to Claude Desktop.
Sie haben Crawlens noch nicht?
Laden Sie es herunter, crawlen Sie eine Website und kommen Sie dann hierher zurück, um Ihre KI-Tools zu verbinden.