AutoSEO mit Claude und Claude Code verbinden: MCP-Anleitung

Was brauchen Sie, bevor Sie verbinden?

• Die MCP-URL. Öffnen Sie in AutoSEO Settings → API & MCP; das Panel „MCP Server“ zeigt die URL Ihrer Instanz plus /api/mcp. Bei AutoSEO Cloud kopieren Sie die URL aus Ihrem Workspace, bei einer selbst gehosteten Instanz ist es Ihre eigene Domain.
• Öffentliches HTTPS. Claude ruft eigene Konnektoren aus der Infrastruktur von Anthropic auf, in claude.ai, Claude Desktop, Cowork und den Mobil-Apps. Server hinter einem VPN oder in einem privaten Netz sind daher nicht erreichbar (Claude Help Center).
• Die passende AutoSEO-Rolle. Um eine App freizugeben, brauchen Sie im Workspace die Berechtigung Integrations, API keys, model settings, dieselbe wie für API-Schlüssel.
• Ein Claude-Tarif mit eigenen Konnektoren. Anthropic nennt Free (ein eigener Konnektor), Pro, Max, Team und Enterprise. In Team und Enterprise fügen Owner eigene Konnektoren hinzu, Mitglieder verbinden sich dann einzeln.

Wie funktioniert die Verbindung technisch?

Der MCP-Server von AutoSEO ist ein zustandsloser Streamable-HTTP-Endpunkt: Jede JSON-RPC-Nachricht ist ein POST an /api/mcp, wird mit reinem JSON beantwortet und einzeln authentifiziert. Es gibt keinen SSE-Stream und keine Session-ID, was die MCP-Transportspezifikation ausdrücklich zulässt. Unterstützt werden die Protokollversionen 2024-11-05, 2025-03-26, 2025-06-18 und 2025-11-25.

Eine Anfrage ohne Token erhält eine 401-Antwort, deren WWW-Authenticate-Header auf die Protected Resource Metadata verweist (RFC 9728). Darüber findet Claude den Autorisierungsserver, weist sich per Client ID Metadata Document aus oder registriert sich per Dynamic Client Registration (RFC 7591), was AutoSEO beides akzeptiert, und durchläuft einen Authorization-Code-Flow mit PKCE, bei dem AutoSEO nur S256 akzeptiert.

Wie fügen Sie AutoSEO in claude.ai und Claude Desktop hinzu?

Einen eigenen Konnektor richten Sie einmal ein; danach steht er im Web, in der Desktop-App und mobil zur Verfügung. Stand September 2026 heißt die Seite bei Anthropic Customize → Connectors; in der Desktop-App finden Sie Customize in der Seitenleiste (Claude docs). Ältere Anleitungen nennen sie Settings → Connectors.

1. Öffnen Sie in Claude Customize → Connectors und wählen Sie Add custom connector.
2. Vergeben Sie den Namen AutoSEO und fügen Sie die MCP-URL ein. Lassen Sie Advanced settings (OAuth-Client-ID und -Secret) leer. Fragt Ihr Dialog nach einer Option unter OAuth client, behalten Sie Use Claude's published identity bei, die von Anthropic empfohlene Variante: AutoSEO akzeptiert Client ID Metadata Documents ebenso wie die dynamische Registrierung, Register automatically funktioniert also auch (Claude docs).
3. Klicken Sie auf Add und dann auf Connect. Die Zustimmungsseite von AutoSEO öffnet sich im Browser.
4. Prüfen Sie, dass unter Redirects to claude.ai steht, wählen Sie Workspace, Projekte (All my projects oder eine Auswahl) und Berechtigungen und klicken Sie auf Allow access.
5. Klicken Sie in einem Chat auf +, öffnen Sie Connectors und schalten Sie AutoSEO ein.

In Team und Enterprise fügt ein Owner den Konnektor unter Organization settings → Connectors hinzu (Add, Custom, Web). Jedes Mitglied klickt anschließend auf Connect und autorisiert mit dem eigenen AutoSEO-Konto, sodass Rollen und Projektzugriffe pro Person erhalten bleiben.

Wie verbinden Sie Claude Code?

Claude Code verbindet sich von Ihrem Rechner aus und führt OAuth mit einer Loopback-Weiterleitung aus (Claude Code docs). Ersetzen Sie die Beispieldomain durch Ihre eigene:

claude mcp add --transport http autoseo https://seo.example.com/api/mcp

Führen Sie danach in Claude Code /mcp aus, wählen Sie autoseo und authentifizieren Sie sich, oder nutzen Sie in der Shell claude mcp login autoseo. Die Zustimmungsseite zeigt diesmal localhost als Weiterleitungsziel. claude mcp list bestätigt die Verbindung.

Standard ist der Scope local (nur Sie, nur dieses Projekt, gespeichert in ~/.claude.json). Mit --scope user steht AutoSEO in allen Projekten bereit; --scope project schreibt eine .mcp.json, die Ihr Team eincheckt, und jede Person meldet sich mit dem eigenen Konto an. Die Tool-Suche von Claude Code lädt beim Start nur Tool-Namen und Server-Anweisungen, sodass auch ein Server mit über 100 Tools den Kontext kaum belastet.

Wann ist ein API-Schlüssel die bessere Wahl?

Für CI-Jobs, Server und Läufe ohne Browser sowie als Ausweichlösung, falls OAuth gegen eine lokale Testinstanz hakt. Erstellen Sie einen Schlüssel unter Settings → API & MCP → Create key; AutoSEO zeigt ihn einmal an und speichert nur seinen SHA-256-Hash.

claude mcp add --transport http autoseo https://seo.example.com/api/mcp \  --header "Authorization: Bearer <YOUR_API_KEY>"

In einer geteilten .mcp.json verweisen Sie auf eine Umgebungsvariable statt auf den Schlüssel selbst. Meiden Sie reservierte Namen wie ANTHROPIC_API_KEY, die Claude Code nie an einen entfernten Server sendet.

{  "mcpServers": {    "autoseo": {      "type": "http",      "url": "https://seo.example.com/api/mcp",      "headers": { "Authorization": "Bearer ${AUTOSEO_API_KEY}" }    }  }}

Was bringt das AutoSEO-Plugin zusätzlich?

Das Plugin bündelt den MCP-Server, vorkonfiguriert für Ihre Instanz, mit 17 Skills wie seo-audit, ai-visibility-report und competitor-gap. Bei öffentlichem HTTPS fügen Sie die gehostete marketplace.json Ihrer Instanz hinzu (Claude Code docs):

claude plugin marketplace add https://seo.example.com/api/plugin/marketplace.jsonclaude plugin install autoseo@autoseo

Starten Sie eine neue Sitzung, authentifizieren Sie sich über /mcp und rufen Sie Skills mit dem Plugin-Namespace auf, etwa /autoseo:seo-audit (Claude Code docs). Bei localhost oder reinem HTTP laden Sie stattdessen das Bundle im Tab Agent setup unter Settings → API & MCP herunter und fügen es als lokalen Marketplace hinzu. Einen bereits in claude.ai angelegten Konnektor zeigt /mcp ebenfalls an, wenn Claude Code dasselbe claude.ai-Konto nutzt.

Kann AutoSEO umgekehrt Ihr Claude Code nutzen?

Ja, als eigene Funktion. Unter Settings → Local Agents installieren Sie einen kleinen Hintergrunddienst auf einem Rechner mit Claude Code oder Codex. Der Agent-Modus und weitere KI-Funktionen von AutoSEO laufen dann dort über Ihr Abonnement, API-Schlüssel dienen nur als Rückfallebene. Der Agent stellt ausschließlich ausgehende HTTPS-Verbindungen her, und Agent-Chats erreichen dieselben MCP-Tools über einen Schlüssel, der nach spätestens sechs Stunden abläuft.

Welche Berechtigungen sollten Sie vergeben?

AutoSEO bietet über 100 MCP-Tools (die aktuelle Zahl zeigt das Panel „MCP Server“ unter Settings → API & MCP); etwa ein Drittel davon kann Kosten verursachen. AutoSEO blendet diese ohne Spend-Scope aus, und die Server-Anweisungen halten Claude an, kostenlose Tools zu bevorzugen und größere bezahlte Serien mit Ihnen abzustimmen. Tools, die Daten ändern oder bezahlte Läufe starten, prüfen zudem bei jedem Aufruf Ihre Rolle.

• Tokens: Access-Tokens laufen nach einer Stunde ab und werden automatisch erneuert; Refresh-Tokens gelten rollierend 30 Tage.
• Widerruf: Settings → API & MCP → Connected apps → Disconnect widerruft sofort alle Tokens einer App. Prüfen Sie diese Liste auch nach dem Trennen in Claude, denn eine neue Verbindung kann als eigener Eintrag erscheinen.
• Sorgfalt bei der Zustimmung: Die Zustimmungsseite zeigt Published by mit der herausgebenden Domain, wenn sich der Client über ein Metadata Document ausweist, und Unverified app, wenn er sich selbst registriert hat. Fahren Sie nur fort, wenn Sie die Verbindung gerade gestartet haben und das Weiterleitungsziel claude.ai oder localhost lautet.
• Tool-Freigaben: Stellen Sie AutoSEO-Tools in Claude auf Always allow, Needs approval oder Blocked (Claude docs); schreibende und kostenpflichtige Tools bleiben am besten auf Freigabe.

Was können Sie Claude nach der Verbindung fragen?

Sie fragen in normaler Sprache, Claude wählt die Tools. Meist beginnt es mit list_projects und get_project_context, wie es die Server-Anweisungen von AutoSEO nahelegen.

Die Antworten sind nur so gut wie die Daten dahinter: getrackte Prompts für das KI-Sichtbarkeits-Tracking, der Check hinter KI-Crawlbarkeit, Umfrage- oder CRM-Daten für die Attribution. Die Seiten zum MCP-Server und zur REST-API beschreiben dieselben Daten für Skripte. Zu messen, wie Claude selbst über Ihre Marke antwortet, ist eine andere Funktion: Claude-Sichtbarkeits-Tracking.

Wie sieht eine erste Sitzung aus?

Beispiel: Lena, fiktive Marketingleiterin eines SaaS-Anbieters für Projektmanagement, möchte in Claude einen wöchentlichen Sichtbarkeits-Check. Alle Zahlen sind illustrativ.

1. Sie fügt AutoSEO in ihrem Pro-Tarif als eigenen Konnektor hinzu. Auf der Zustimmungsseite wählt sie nur das Produktprojekt und entfernt Write, Spend credits und Export, sodass Claude nur kostenlose Lese-Tools sieht.
2. Sie fragt, wie sichtbar die Marke in den letzten 30 Tagen war. Claude ruft get_visibility_metrics auf und meldet etwa 21 % Sichtbarkeit nach 18 % im Vorzeitraum (illustrativ).
3. „Wo tauchen Wettbewerber auf und wir nicht?“ get_competitor_gap_analysis liefert beispielsweise 12 solcher Prompts (illustrativ), get_top_sources zeigt, welche Vergleichsseiten den Wettbewerber zitieren.
4. Aus den Fan-out-Unterabfragen dieser Prompts (get_query_fanouts) lässt sie Claude ein Content-Briefing entwerfen.
5. Für einen Check der KI-Crawler braucht sie run_crawlability_check. Das Tool fehlt, weil Write und Spend credits nicht freigegeben sind. Sie verbindet sich für diesen einen Check mit beiden neu und danach wieder nur mit Read.

Das Muster: standardmäßig nur lesen, für eine konkrete Aufgabe erweitern, danach wieder einschränken. In Claude Code bündelt der Skill ai-visibility-report einen ähnlichen Ablauf.

Warum funktioniert die Verbindung nicht?

Was bedeutet das für Sie?

• Verbinden Sie zunächst nur lesend; Write oder Spend credits vergeben Sie pro Aufgabe, nicht dauerhaft.
• Nutzen Sie OAuth für Menschen und API-Schlüssel für Maschinen, abgelegt in Umgebungsvariablen.
• Wählen Sie Projektzugriffe bewusst, gerade in Agentur-Workspaces.
• Prüfen Sie Connected apps regelmäßig und trennen Sie unbekannte Einträge.
• Im Terminal lohnt das Plugin wegen der Skills; soll AutoSEO seine eigene KI über Ihr Claude-Abonnement ausführen, richten Sie einen lokalen Agenten ein.

Die ChatGPT-Anleitung beschreibt denselben Server in ChatGPT. Noch ohne Instanz? Hosten Sie AutoSEO selbst oder nutzen Sie AutoSEO Cloud; in beiden Fällen finden Sie die MCP-URL unter Settings → API & MCP.