Ahrefs MCP Server

Der Ahrefs MCP Server holt die Daten aus Ihrem Ahrefs-Konto direkt in Ihren KI-Assistenten. Statt im Site Explorer zu klicken, Tabellen zu exportieren und in eine Tabellenkalkulation zu kopieren, fragen Sie Claude, ChatGPT oder Cursor einfach nach den verweisenden Domains eines Wettbewerbers oder nach Keywords mit hohem Potenzial, und der Assistent ruft die passenden Ahrefs-Berichte ab. MCP, das Model Context Protocol, ist ein offener Standard, über den solche Assistenten externe Werkzeuge nutzen. Ahrefs betreibt den Server selbst und stellt ihn unter https://api.ahrefs.com/mcp/mcp bereit. Eine lokale Installation ist nicht nötig.

Gehostet statt lokal

Früher gab es einen lokalen Ahrefs-Server als npm-Paket. Dieses Repository ist inzwischen archiviert, und Ahrefs rät ausdrücklich von seiner Nutzung ab. Der aktuelle Server läuft ausschließlich gehostet über Streamable HTTP. Laut Dokumentation ist Ihre Verbindung nach der Einrichtung auf allen Geräten verfügbar, die mit Ihrem persönlichen oder Firmenkonto verknüpft sind. Ahrefs liefert Schritt-für-Schritt-Anleitungen für Claude im Browser und auf dem Desktop, Claude Mobile, Claude Code, ChatGPT, Microsoft Copilot Studio, Lovable, n8n, Manus, Le Chat von Mistral und OpenClaw.

Welche Daten stehen zur Verfügung?

Die Werkzeuge sind in Gruppen organisiert. Laut Dokumentation gehören dazu Übersichten und detaillierte Berichte aus dem Site Explorer (Domain Rating, Backlinks, verweisende Domains, Ankertexte, organische Keywords, Top-Seiten, Wettbewerber), der Keywords Explorer mit Suchvolumen, Verlauf und verwandten Begriffen, SERP-Übersichten, Rank Tracker, Site Audit mit Projekten und gefundenen Problemen, Brand Radar, Web Analytics, Google-Search-Console-Daten, Social-Media-Kennzahlen, der Content Helper, Batch-Analysen und die Kontoverwaltung. Weil manche Clients die Zahl der Werkzeuge begrenzen, können Sie über den URL-Parameter tools gezielt nur einzelne Gruppen laden oder mit tools=essentials eine kuratierte Auswahl der wichtigsten Werkzeuge nutzen.

API-Units und Limits

Der MCP-Server ist laut Ahrefs ab dem kostenpflichtigen Lite-Plan verfügbar. Jede Abfrage verbraucht API-Units aus dem monatlichen Kontingent Ihres Plans, genauso wie bei direkter API-Nutzung. Höhere Pläne enthalten mehr Units, und jeder Plan begrenzt die Zahl der Zeilen pro Anfrage. Laut Dokumentation kostet eine abrechenbare Anfrage mindestens 50 Units; einige Bereiche wie Rank Tracker, Verwaltung und öffentliche Endpunkte sind kostenlos. Keys, die beim Verbinden per OAuth entstehen, haben standardmäßig ein eigenes Monatslimit, das Workspace-Admins im Bericht zu den API-Keys anpassen können. Den aktuellen Verbrauch sehen Sie in den Kontoeinstellungen unter Limits und Nutzung.

Nutzungsbedingungen

Ahrefs stellt klar, dass der MCP-Endpunkt nur mit unterstützten KI-Werkzeugen genutzt werden darf. Eigene Skripte, Brücken oder selbst gebaute HTTP-Clients, die den Endpunkt direkt ansprechen, sind laut Dokumentation nicht erlaubt. Für programmatischen Zugriff ist die reguläre Ahrefs-API gedacht.

Kosten

Für den Server selbst fallen keine Extrakosten an, er setzt aber ein bezahltes Ahrefs-Abo ab Lite voraus. Wie viele API-Units und Zeilen pro Anfrage enthalten sind, hängt vom Plan ab. Aktuelle Konditionen finden Sie auf der offiziellen Preisseite von Ahrefs.

Für wen lohnt sich der Ahrefs MCP Server?

Er lohnt sich für SEO-Teams und Agenturen, die Ahrefs ohnehin nutzen und Analysen schneller erledigen möchten: Wettbewerbsvergleiche, Linkaufbau-Recherchen, Keyword-Cluster oder Berichte für Kunden. Weil der Assistent mehrere Berichte kombinieren und das Ergebnis direkt kommentieren kann, entstehen in Minuten Auswertungen, für die man sonst mehrere Exporte braucht. Behalten Sie dabei den Unit-Verbrauch im Blick und beschränken Sie die Werkzeuggruppen auf das, was Sie wirklich brauchen.

Ein bezahltes Ahrefs-Abo ab dem Lite-Plan und ein MCP-Client mit HTTP-Transport und OAuth, etwa Claude Code, Claude im Browser oder auf dem Desktop, ChatGPT oder Cursor. Für die Variante mit MCP-Key zusätzlich Node.js (für npx und mcp-remote).

Schritt 1: Ahrefs-Plan prüfen

Melden Sie sich bei app.ahrefs.com an und prüfen Sie, ob Ihr Konto mindestens den Lite-Plan hat. Mit einem kostenlosen Konto funktioniert der MCP-Server nicht. Ihren monatlichen Verbrauch an API-Units sehen Sie später unter Kontoeinstellungen, Limits und Nutzung.

Schritt 2: In Claude Code einbinden

Öffnen Sie ein Terminal und führen Sie diesen Befehl aus:

claude mcp add ahrefs https://api.ahrefs.com/mcp/mcp -t http

Starten Sie Claude Code und geben Sie ein:

/mcp

Wählen Sie ahrefs und dann Authenticate. Im Browser melden Sie sich bei Ahrefs an, wählen Ihren Workspace und klicken auf Allow. Danach zeigt /mcp den Server als verbunden an.

Schritt 3: Alternativ in Claude im Browser oder auf dem Desktop

Öffnen Sie claude.ai, gehen Sie auf Anpassen (Customize) und dann auf Konnektoren. Klicken Sie auf das Plus-Zeichen, suchen Sie nach Ahrefs und klicken Sie auf Verbinden. Wählen Sie Ihren Ahrefs-Workspace und bestätigen Sie mit Allow. Aktivieren Sie den Konnektor anschließend im Chat über das Werkzeug-Menü.

Schritt 4: Alternativ in Cursor

Öffnen Sie in Cursor die Datei ~/.cursor/mcp.json und fügen Sie diesen Eintrag ein:

{
  "mcpServers": {
    "ahrefs": {
      "url": "https://api.ahrefs.com/mcp/mcp"
    }
  }
}

Speichern Sie, starten Sie Cursor neu und melden Sie sich beim ersten Aufruf per OAuth im Browser an.

Schritt 5: Alternativ mit MCP-Key statt OAuth

Wenn Ihr Client kein OAuth beherrscht, erzeugen Sie einen MCP-Key: In Ahrefs unter Kontoeinstellungen, API Keys auf Generate MCP key klicken und den Schlüssel kopieren. Tragen Sie dann in die Konfigurationsdatei Ihres Clients (zum Beispiel claude_desktop_config.json) diesen Eintrag ein und ersetzen Sie IHR_MCP_KEY durch den kopierten Schlüssel:

{
  "mcpServers": {
    "ahrefs": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.ahrefs.com/mcp/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer IHR_MCP_KEY"
      }
    }
  }
}

Starten Sie den Client danach komplett neu.

Schritt 6: Werkzeuge begrenzen (empfohlen)

Ahrefs bietet sehr viele Werkzeuge an. Manche Clients kappen die Liste, dann fehlen plötzlich wichtige Berichte. Laden Sie deshalb nur die Gruppen, die Sie brauchen, indem Sie den Parameter tools an die Adresse hängen. In Claude Code entfernen Sie dazu den alten Eintrag und legen ihn neu an:

claude mcp remove ahrefs
claude mcp add ahrefs "https://api.ahrefs.com/mcp/mcp?tools=site-explorer-overview,site-explorer-reports,keywords-explorer" -t http

Für eine fertige Auswahl der wichtigsten Werkzeuge verwenden Sie stattdessen:

claude mcp add ahrefs "https://api.ahrefs.com/mcp/mcp?tools=essentials" -t http

Schritt 7: Verbindung testen

Fragen Sie Ihren Assistenten zum Beispiel:

Zeige mir mit Ahrefs in einer Tabelle die zehn stärksten verweisenden Domains von beispiel.de.

Erscheint eine Tabelle, ist alles eingerichtet. Prüfen Sie danach unter Limits und Nutzung, wie viele Units die Anfrage verbraucht hat.

OAuth mit Zustimmungsdialog; dabei entsteht im Ahrefs-Konto ein eigener API-Key mit MCP-Scope. Alternativ ein manuell erzeugter MCP-Key als Bearer-Token im Authorization-Header; Enterprise-Kunden können auch reguläre API-Keys nutzen.

Lesender Zugriff auf Site Explorer, Keywords Explorer, SERP-Übersichten, Rank Tracker, Site Audit, Brand Radar, Web Analytics, Google-Search-Console-Daten und Social-Media-Kennzahlen; die Gruppe management erlaubt zusätzlich die Verwaltung von Projekten, Keyword-Listen und Brand-Radar-Einstellungen.

Anfragen laufen über api.ahrefs.com. Abgerufene Berichte, darunter auch Daten Ihrer eigenen Projekte aus Web Analytics und Google Search Console, gelangen in den Kontext des KI-Clients und damit zum Modellanbieter.

Ein Assistent kann ohne Rückfrage viele Abfragen auslösen und das Monatskontingent an API-Units aufbrauchen. Mit der Gruppe management lassen sich Projekteinstellungen ändern. Ein MCP-Key in einer Konfigurationsdatei gewährt Zugriff auf Ihr Konto.