KI-Tools per MCP mit aclipp verbinden

Verbinde Claude, ChatGPT und Entwickler-Tools mit dem gehosteten aclipp MCP-Server und entdecke alle verfügbaren Tools.

Der aclipp MCP-Server gibt kompatiblen KI-Clients lesenden Zugriff auf deine PR-Daten. Du kannst Coverage untersuchen, Outlets und Projektkonfigurationen abrufen und deine KI-Sichtbarkeit analysieren, ohne Daten vorher zu exportieren.

Alle Clients verbinden sich mit dem gehosteten Endpunkt unter https://api.aclipp.com/mcp. Du musst keinen eigenen aclipp Server und keinen lokalen Entwicklungsprozess starten. Es gibt zwei Wege der Authentifizierung:

Mit aclipp anmelden (OAuth): für interaktive Clients wie Claude und ChatGPT. Kein API-Key nötig; du bestätigst die Verbindung im Browser.
API-Key: für Entwickler-Tools wie Claude Code und Cursor oder überall dort, wo du einen langlebigen Zugang bevorzugst.

Unterstützte Clients

Client	Status	Authentifizierung
Claude (Web)	Verfügbar	Mit aclipp anmelden
Claude Desktop	Verfügbar	Mit aclipp anmelden
ChatGPT	Verfügbar (Developer Mode)	Mit aclipp anmelden
Claude Code	Verfügbar	aclipp API-Key in einem HTTP-Header
Cursor	Verfügbar	aclipp API-Key in `mcp.json`

Voraussetzungen

Du brauchst einen aclipp Workspace mit aktiviertem API-Zugriff. Für Claude und ChatGPT genügt dein normaler aclipp Login. Für Claude Code und Cursor brauchst du zusätzlich einen aclipp API-Key mit den Leserechten, die dein KI-Client verwenden soll.

Mit aclipp anmelden (OAuth)

Wenn du https://api.aclipp.com/mcp als Connector hinzufügst, erkennt der Client den aclipp Login-Ablauf automatisch und öffnet deinen Browser. Du meldest dich mit deinem aclipp Account an und bestätigst die Verbindung:

Organisation wählen: Eine Verbindung gilt immer für genau eine Organisation. Zum Wechseln trennst du die Verbindung und verbindest dich neu.
Projekte wählen: Standardmäßig sind alle Projekte enthalten, auch später erstellte. Schränke die Auswahl ein, wenn der Client nur bestimmte Projekte sehen soll.
Erlauben: Der Client erhält lesenden Zugriff entsprechend der auf dem Bestätigungsbildschirm angezeigten Berechtigungen.

Verbindungen sind persönlich: Sie handeln in deinem Namen und enden, wenn du die Organisation verlässt. Workspace-Admins sehen alle Verbindungen unter Einstellungen, Entwickler, Verbundene Apps und können jede davon sofort trennen.

Claude (Web)

Öffne die Einstellungen, dann Connectors, und wähle "Add custom connector".
Trage https://api.aclipp.com/mcp als URL ein und bestätige.
Klicke auf Verbinden und schließe die aclipp Anmeldung im Browserfenster ab.
Aktiviere den aclipp Connector im Tools-Menü eines Chats. Die aclipp Tools sind jetzt verfügbar.

Benutzerdefinierte Connectors erfordern einen bezahlten Claude Plan. Bei Team- und Enterprise-Plänen muss sie gegebenenfalls zuerst ein Admin freischalten.

Claude Desktop

Claude Desktop verwendet dieselben Connector-Einstellungen wie Claude im Web: Füge https://api.aclipp.com/mcp unter Einstellungen, Connectors hinzu und schließe die Anmeldung im Browser ab.

ChatGPT

ChatGPT verbindet sich über den Developer Mode:

Öffne die Einstellungen, dann Apps & Connectors, dann Advanced, und aktiviere den Developer Mode. Dafür ist ein bezahlter Plan nötig; bei Team- und Enterprise-Plänen muss ihn ein Admin erlauben.
Erstelle einen Connector mit der MCP-Server-URL https://api.aclipp.com/mcp und OAuth als Authentifizierungsmethode.
Schließe die aclipp Anmeldung ab und aktiviere den Connector in einem Chat.

ChatGPT speichert beim Freigeben eines Connectors einen Snapshot der Tool-Definitionen. Verbinde den Connector neu, sobald aclipp neue Tools veröffentlicht, damit ChatGPT seine Liste aktualisiert.

API-Key erstellen

Öffne für Claude Code und Cursor die API-Einstellungen deines Workspaces und erstelle einen Key für deinen KI-Client. Der vollständige Key wird nur einmal angezeigt. Kopiere ihn deshalb, bevor du den Dialog schließt.

Vergib nur die benötigten Scopes:

Scope	Freigeschaltete Daten
`projects:read`	Projekte, Projektkonfiguration, Prompts und Prompt-Themen.
`clippings:read`	Gefilterte Clipping-Listen und vollständige Clipping-Details.
`outlets:read`	Outlet-Listen und vollständige Outlet-Details.
`analytics:read`	Aggregierte Clipping- und KI-Sichtbarkeitsanalysen.
`ai-visibility:read`	KI-Sichtbarkeits-Chats, Metriken, zitierte Domains und URLs.

Die Scopes bestimmen, welche Tools der Client sieht. Du kannst den Key zusätzlich auf bestimmte Projekte beschränken.

Claude Code

Führe diesen Befehl im Terminal aus und ersetze den Beispiel-Key durch deinen neuen Key:

bash

claude mcp add \
  --transport http \
  --scope user \
  --header "Authorization: Bearer aclipp_live_..." \
  aclipp https://api.aclipp.com/mcp

Mit dem Scope user ist die Verbindung in allen Claude-Code-Projekten auf deinem Computer verfügbar.

Starte Claude Code und gib Folgendes ein:

text

/mcp

Der Server aclipp sollte verbunden sein und seine verfügbaren Tools anzeigen. Du kannst die Verbindung auch im Terminal prüfen:

bash

claude mcp list

Cursor

Öffne die globale MCP-Konfiguration unter ~/.cursor/mcp.json. Erstelle alternativ .cursor/mcp.json, wenn die Verbindung nur in einem Projekt verfügbar sein soll. Füge Folgendes ein:

json

{
  "mcpServers": {
    "aclipp": {
      "url": "https://api.aclipp.com/mcp",
      "headers": {
        "Authorization": "Bearer aclipp_live_..."
      }
    }
  }
}

Ersetze den Beispiel-Key, speichere die Datei und öffne die MCP-Einstellungen in Cursor. Der Server aclipp sollte mit den freigegebenen Tools verfügbar sein. Starte Cursor neu oder deaktiviere und aktiviere den Server, wenn die Verbindung nicht sofort hergestellt wird.

Committe niemals eine projektbezogene .cursor/mcp.json, die einen API-Key enthält. Nutze für eine persönliche Verbindung bevorzugt die globale Konfiguration.

Verfügbare MCP-Tools

Der Server registriert nur die Tools, die durch die Scopes der Verbindung freigegeben sind. Das ist der vollständige aktuelle Tool-Katalog:

Tool	Funktion	Benötigter Scope
`list_projects` — Projekte auflisten	Listet die für die Verbindung sichtbaren Projekte und ihre IDs auf.	`projects:read`
`get_project_config` — Projektkonfiguration abrufen	Gibt Tags, Tag-Gruppen und benutzerdefinierte Metriken eines Projekts zurück.	`projects:read`
`list_prompts` — KI-Sichtbarkeits-Prompts auflisten	Listet beobachtete Prompts mit Standort, Status und Thema auf.	`projects:read`
`list_prompt_topics` — Prompt-Themen auflisten	Listet Prompt-Themen zum Filtern und Gruppieren von KI-Sichtbarkeitsdaten auf.	`projects:read`
`list_clippings` — Clippings auflisten	Listet kompakte Clipping-Datensätze mit Filtern für Datum, Kanal, Tags, Outlet, Land, Sentiment und Suche auf.	`clippings:read`
`get_clipping` — Clipping abrufen	Gibt die vollständigen Details eines Clippings zurück.	`clippings:read`
`list_outlets` — Outlets auflisten	Listet Medien-Outlets mit Suche, Kanal, Projekt und Clipping-Anzahl auf.	`outlets:read`
`get_outlet` — Outlet abrufen	Gibt ein Outlet mit vollständigem kanalspezifischem Profil und Reichweitendaten zurück.	`outlets:read`
`list_geo_chats` — KI-Sichtbarkeits-Chats auflisten	Listet KI-Sichtbarkeitsläufe nach Projekt, Zeitraum, Anbieter, Land, Prompt oder Thema auf.	`ai-visibility:read`
`get_geo_chat` — KI-Sichtbarkeits-Chat abrufen	Gibt die vollständigen Details eines KI-Sichtbarkeitslaufs zurück.	`ai-visibility:read`
`get_geo_metrics` — KI-Sichtbarkeitsmetriken abfragen	Gibt Sichtbarkeit, Share of Voice, Position, Sentiment und Erwähnungen mit optionaler Gruppierung und Zeitintervallen zurück.	`ai-visibility:read`
`search_geo_sources` — KI-Sichtbarkeitsquellen durchsuchen	Durchsucht in KI-Sichtbarkeitsläufen zitierte Domains und URLs.	`ai-visibility:read`
`get_geo_source` — KI-Sichtbarkeitsquelle abrufen	Gibt die Details einer zitierten Domain oder URL zurück.	`ai-visibility:read`
`get_analytics_catalog` — Analyse-Katalog abrufen	Listet die für ein Projekt verfügbaren Metriken, Formen, Dimensionen, Formate und Aggregationen auf.	`analytics:read`
`query_analytics` — Analysen abfragen	Gibt Skalar-, Zeitreihen-, Aufschlüsselungs- oder Tabellenanalysen für Clipping- und KI-Sichtbarkeitsdaten zurück, einschließlich Clipping-Sentiment.	`analytics:read`

Halte diese Tabelle aktuell, wenn sich MCP-Tools oder ihre benötigten Scopes ändern.

Erste Analyse starten

Lass den Client zuerst dein Projekt und seine Konfiguration ermitteln:

text

Nutze aclipp, um meine Projekte aufzulisten. Rufe für das relevante Projekt
die Konfiguration ab und fasse die Berichterstattung dieses Jahres nach Kanal,
Land, Sentiment und Outlet zusammen. Zeige die stärkste Coverage und auffällige
Lücken.

Der Client kann Tag-IDs über die Projektkonfiguration auflösen und sollte den Analyse-Katalog für gültige Kombinationen aus Metrik, Form, Dimension und Aggregation verwenden. Zeitreihen, Aufschlüsselungen und Tabellen benötigen einen Zeitraum von höchstens 366 Tagen. Abfragen mit Ergebniszeilen sind begrenzt und teilen dem Client mit, wenn Ergebnisse gekürzt wurden.

Zum Beispiel:

text

Vergleiche unsere Berichterstattung in Deutschland und Österreich im letzten
Quartal. Gliedere sie nach Kanal und Sentiment, nenne die wichtigsten Outlets
und belege relevante Aussagen mit den zugrunde liegenden Clippings.

Fehlerbehebung

Verbindung fehlgeschlagen

Prüfe, ob die URL https://api.aclipp.com/mcp konfiguriert ist. Führe in Claude Code claude mcp list aus. Öffne in Cursor die MCP-Einstellungen und prüfe den Serverstatus.

Authentifizierung fehlgeschlagen

Trenne bei OAuth-Verbindungen den Connector im Client und verbinde dich neu; die Anmeldung im Browser erstellt eine frische Verbindung. Das ist auch nötig, nachdem ein Admin die Verbindung getrennt hat oder du die Organisation verlassen hast. Erstelle bei API-Keys einen neuen Key, wenn der konfigurierte Key widerrufen, falsch kopiert oder nicht mehr verfügbar ist. aclipp API-Keys haben das Format aclipp_live_..., und der Header-Wert muss mit Bearer beginnen.

Ein Tool fehlt

Tools werden anhand der Scopes der Verbindung registriert. OAuth-Verbindungen erhalten automatisch alle Lese-Scopes. Aktualisiere oder ersetze bei API-Keys den Key mit dem benötigten Lese-Scope und verbinde den Server anschließend neu, damit der Client seine Tool-Liste aktualisiert.

Der Client zeigt eine veraltete Tool-Liste

Verbinde den Server aclipp neu oder starte eine neue Client-Sitzung. ChatGPT speichert beim Freigeben eines Connectors einen Snapshot der Tool-Definitionen; verbinde ihn dort ebenfalls neu.

Verbindung entfernen

Trenne bei Claude und ChatGPT den Connector in den Einstellungen des Clients. Workspace-Admins können jede OAuth-Verbindung zusätzlich unter Einstellungen, Entwickler, Verbundene Apps trennen; der Zugriff endet dann innerhalb einer Minute.

Entferne den benutzerweiten Claude-Code-Server mit:

bash

claude mcp remove aclipp --scope user

Entferne bei Cursor den Eintrag aclipp aus mcp.json. Widerrufe den API-Key in den API-Einstellungen deines Workspaces, sobald du ihn nicht mehr benötigst.

API-Key sicher aufbewahren

Der API-Key wird in der privaten Konfiguration deines Clients gespeichert. Committe ihn niemals und füge ihn nicht in Chats, Issues, Screenshots oder geteilte Terminalausgaben ein. Verwende für jeden Client einen separaten, minimal berechtigten Key, damit du eine Verbindung widerrufen kannst, ohne andere zu beeinflussen.

KI-Tools per MCP mit aclipp verbinden

Unterstützte Clients

Voraussetzungen

Mit aclipp anmelden (OAuth)

Claude (Web)

Claude Desktop

ChatGPT

API-Key erstellen

Claude Code

Cursor

Verfügbare MCP-Tools

Erste Analyse starten

Fehlerbehebung

Verbindung fehlgeschlagen

Authentifizierung fehlgeschlagen

Ein Tool fehlt

Der Client zeigt eine veraltete Tool-Liste

Verbindung entfernen

API-Key sicher aufbewahren

API-Referenz durchsuchen