Verfolgen Sie Ihre AI-Visibility von Claude Code und Codex aus

Kurze Antwort

Wie verfolge ich AI-Visibility von Claude Code oder Codex aus?

Erstellen Sie einen Howseen API-Schlüssel, fügen Sie den Howseen MCP-Server mit einem Befehl hinzu und fragen Sie Ihren Agenten dann, bei welchen Kaufentscheidungs-Fragen ein Wettbewerber statt Ihnen genannt wird.

Der Howseen MCP-Server ist unter https://app.howseen.ai/api/mcp erreichbar und spricht Streamable HTTP, sodass sich beide Agenten wie mit jedem anderen Remote-Server verbinden. Er stellt Ihrem Agenten 26 Tools für Ihre Howseen-Daten bereit: dieselben Visibility-Prozentwerte, Wettbewerber und zitierten Quellen wie in Ihrem Dashboard, ausschließlich für Ihre eigenen Marken. Lese-Tools funktionieren mit jedem Schlüssel; Aktions-Tools laufen erst nach einer Vorschau und Ihrer Bestätigung.

"MCP (Model Context Protocol) ist ein Open-Source-Standard zur Anbindung von KI-Anwendungen an externe Systeme."

Warum das Terminal

Warum Entwickler und Agenturen diese Daten direkt neben ihrem Code haben wollen

Die Person, die eine Visibility-Lücke beheben kann (eine Seite, eine Vergleichstabelle, ein Docs-Abschnitt), arbeitet meist im Repo. Wenn die Lücke direkt im selben Terminal sichtbar ist, entfällt der Umweg über das Dashboard.

• Von der Lücke zum Pull Request. Fragen Sie, bei welcher Frage Sie verlieren, und lassen Sie denselben Agenten die Seite, die diese Frage beantwortet, direkt in Ihrer eigenen Codebasis schreiben oder aktualisieren.
• Agenturen: ein Schlüssel für alle Kunden. Das Tool list_brands liefert alle Marken in Ihrem Howseen-Konto zurück, sodass Sie alle Kunden in einer Session prüfen können. Siehe GEO für Agenturen.
• Echte Daten statt Vermutungen. Ihr Agent liest die Antworten, die Howseen tatsächlich von ChatGPT, Gemini, Perplexity, Google AI Overviews und Google AI Mode gesammelt hat, statt zu raten, was die KI über Sie sagt.

Wenn das Konzept der AI-Visibility für Sie neu ist, lesen Sie zuerst was GEO (Generative Engine Optimization) ist und wie KI entscheidet, welche Marken sie empfiehlt.

Praxisbeispiel

So sieht es bei unserer eigenen Marke aus

Am 6. Oktober 2026 haben wir Claude, verbunden über den Howseen MCP-Server, zu Howseen selbst befragt, basierend auf unserem Scan vom 5. Oktober. Die Antwort war nicht schmeichelhaft, und genau darum geht es.

Der nützliche Teil ist die letzte Zahl. Die Seite, die die KI in den verlorenen Antworten am häufigsten zitierte, war ein Listenartikel eines Drittanbieters. Die erste Maßnahme ist also, dort gelistet zu werden, nicht die eigene Startseite umzuschreiben. Verschiedene Engines vertrauen unterschiedlichen Quellen: unsere Studie zu 5.331 AI-Antworten zeigt, dass YouTube in 45 % der Google AI Overviews zitiert wurde, aber in 0 von 1.164 ChatGPT-Antworten. Wie Tools bei dieser Art von Daten abschneiden, sehen Sie unter AI-Visibility-Tools.

Einrichtung 1

Claude Code verbinden

Ein einziger claude mcp add-Befehl registriert den Howseen-Server für Ihr Benutzerkonto, sodass er in jedem Projekt verfügbar ist. Geben Sie dann /mcp in Claude Code ein, um die Verbindung zu prüfen.

1. Erstellen Sie einen Schlüssel. Öffnen Sie in Howseen Einstellungen > "API & KI-Assistenten" (app.howseen.ai/settings?tab=api). Der Schlüssel beginnt mit hs_live_ und wird nur einmal angezeigt, kopieren Sie ihn also sofort.
2. Führen Sie dies in Ihrem Terminal aus, mit Ihrem Schlüssel anstelle von hs_live_YOUR_KEY:

claude mcp add --scope user --transport http howseen https://app.howseen.ai/api/mcp \
  --header "Authorization: Bearer hs_live_YOUR_KEY"

3. Prüfen Sie es. Starten Sie Claude Code und geben Sie /mcp ein. Der Server howseen sollte als verbunden angezeigt werden. Wir haben genau diesen Befehl am 6. Oktober 2026 ausgeführt und "Connected" erhalten.

Warum --scope user: Laut Anthropics Dokumentation speichert dieser Scope den Server in ~/.claude.json und macht ihn in allen Ihren Projekten verfügbar, während er privat für Ihr Benutzerkonto bleibt. Der Projekt-Scope hingegen ist für die Weitergabe über Versionskontrolle gedacht, was der falsche Ort für einen Schlüssel ist. Quelle: Connect Claude Code to tools via MCP.

Einrichtung 2

Codex verbinden

Codex liest den Bearer-Token aus einer Umgebungsvariable, sodass Ihr Schlüssel nicht in der Codex-Konfigurationsdatei landet. Exportieren Sie den Schlüssel und führen Sie dann einmalig codex mcp add aus.

export HOWSEEN_API_KEY=hs_live_YOUR_KEY
codex mcp add howseen --url https://app.howseen.ai/api/mcp --bearer-token-env-var HOWSEEN_API_KEY

Fügen Sie die export-Zeile zu Ihrem Shell-Profil hinzu (zum Beispiel ~/.zshrc oder ~/.bashrc), damit der Schlüssel auch in Ihrer nächsten Terminal-Sitzung verfügbar ist. Um die Einrichtung zu prüfen, führen Sie codex mcp list aus oder geben Sie /mcp in Codex ein.

Bearbeiten Sie die Datei lieber direkt? Hier derselbe Server in ~/.codex/config.toml:

[mcp_servers.howseen]
url = "https://app.howseen.ai/api/mcp"
bearer_token_env_var = "HOWSEEN_API_KEY"

Die Optionen --url und --bearer-token-env-var sowie die Schlüssel url und bearer_token_env_var stammen aus OpenAIs Codex-Dokumentation: Model Context Protocol (MCP) for Codex.

Was Sie fragen können

7 Prompts, die funktionieren

Sie müssen die Tool-Namen nicht kennen. Fragen Sie einfach in natürlicher Sprache, und Ihr Agent wählt automatisch das passende Howseen-Tool aus. Hier sind sieben, die sich bewährt haben.

Agenturen können außerdem den client_report-Prompt (Visibility, Wettbewerber und ein Share-Link) für jede Kundenmarke nutzen. Die vollständige Liste der 26 Tools finden Sie auf der Howseen MCP-Seite.

Berechtigungen

Standardmäßig nur Lesezugriff, Aktionen erst nach Ihrer Bestätigung

Ein Standard-Schlüssel kann nur lesen. Damit Ihr Agent Änderungen vornehmen kann, erstellen Sie einen Schlüssel mit aktivierten Aktionen; auch dann wird jede Änderung zunächst als Vorschau angezeigt und erst nach Ihrer Bestätigung ausgeführt.

Die Grenzen Ihres Plans gelten genau wie in der App, und jede durchgeführte Änderung wird in den Einstellungen unter „Von Ihrer KI durchgeführte Aktionen“ aufgelistet.

Sicherheit

Halten Sie Ihren Schlüssel aus Ihrem Repo heraus

Behandeln Sie einen Howseen Schlüssel wie ein Passwort. Bewahren Sie ihn in einer Umgebungsvariable oder Ihrer Benutzerkonfiguration auf, niemals in einer committeten Datei, und widerrufen Sie ihn sofort in den Einstellungen, sobald er durchsickert.

• Niemals committen. Fügen Sie den Schlüssel nicht in eine Projekt-.mcp.json, ein README oder ein Skript ein, das zu Git geht. Verwenden Sie bei Claude Code --scope user, bei Codex --bearer-token-env-var.
• Achten Sie auf Ihre Dotfiles. Wenn Sie ~/.zshrc oder ~/.claude.json mit einem öffentlichen Repo synchronisieren, verschieben Sie den Schlüssel in eine Datei, die nicht synchronisiert wird.
• Vermeiden Sie hier die URL-Form. Die Option ?key= existiert für Clients, die keine Header senden können. Claude Code und Codex können das beide, verwenden Sie also den Header oder die Umgebungsvariable.
• Mit einem Klick widerrufen. Jeder Schlüssel kann jederzeit in den Einstellungen > „API & KI-Assistenten“ widerrufen werden. Howseen speichert nur einen Hash Ihres Schlüssels, niemals den Schlüssel selbst.
• Rate-Limits. 120 Anfragen pro Minute und 5.000 pro Tag, pro Schlüssel.

Automatisierung

In CI oder Skripten verwenden

Für einen nächtlichen Job, einen CI-Check oder ein Kunden-Dashboard überspringen Sie den Agenten und rufen die schreibgeschützte REST-API direkt auf, mit demselben Schlüssel und denselben Daten.

Die REST-API liefert JSON mit Datumsbereich- und Engine-Filtern sowie Pagination. Speichern Sie den Schlüssel als CI-Secret, niemals in der Workflow-Datei. Endpunkte und ein curl-Beispiel finden Sie im REST-API-Abschnitt der MCP-Seite.

Preise

Was es kostet

Der MCP-Server ist in Pro (79 € pro Website und Monat) und Business enthalten, sowie während der 3-tägigen kostenlosen Testphase, siehe Preise für Marken.

Noch nicht bereit für eine Testphase? Holen Sie sich zuerst einen kostenlosen KI-Bericht: keine Kreditkarte, etwa 2 Minuten.