Zum Hauptinhalt springen

MCP-Integration

Finseo stellt einen Model-Context-Protocol-Server (MCP) bereit, über den KI-Assistenten deine Sichtbarkeitsdaten direkt abfragen können.

Was ist MCP?

MCP (Model Context Protocol) ist ein Standard, um KI-Modelle mit externen Datenquellen zu verbinden. Mit dem Finseo MCP-Server stellst du Claude, ChatGPT oder Cursor natürliche Fragen zu deiner KI-Sichtbarkeit — ganz ohne Code. Beispiel: Öffne Claude und frag:
„Wie hat sich meine Markensichtbarkeit in den letzten 30 Tagen verändert? Welche Wettbewerber liegen vor mir?”
Claude fragt automatisch deine Finseo-Daten ab und liefert die Analyse.

Setup-Guides

Authentifizierung

Der MCP-Server unterstützt zwei Authentifizierungsmethoden:

Verfügbare Tools

Alle Tools sind read-only — sie rufen Daten ab und ändern nie etwas. Die Analytics-Tools akzeptieren optionale Filter für model (z. B. chatgpt, perplexity, ai_overview, gemini, grok) und tags — dieselben Filter wie im Dashboard.

Metrik-Definitionen

Die Tools liefern dieselben Zahlen wie das Finseo Dashboard und benennen sie explizit:
  • visibilityRatePercent — Anteil der analysierten KI-Antworten, die deine Marke erwähnen (der „Visibility”-KPI im Dashboard)
  • promptCoveragePercent — Anteil der getrackten Prompts mit mindestens einer Mention (eine andere, meist höhere Zahl)
  • ownDomainCitations.total — KI-Antworten, die deine eigene Domain als Quelle zitieren (der „Citations”-KPI im Dashboard)

Endpoint

Der Server implementiert JSON-RPC 2.0 über Streamable HTTP und unterstützt initialize, tools/list und tools/call. Nicht authentifizierte Requests erhalten eine 401 mit OAuth-Discovery-Metadaten gemäß der MCP-Authorization-Spec (RFC 9728).