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 lässt kompatible KI-Clients direkt mit deinen PR-Daten arbeiten. Du kannst Coverage untersuchen, Outlets und Projektkonfigurationen abrufen und deine KI-Sichtbarkeit analysieren, ohne Daten vorher zu exportieren, und du kannst Coverage anlegen und pflegen, ohne den Client zu verlassen.

Lesen ist der Standard. Schreiben ist optional: Ein Client erhält es nur, wenn er eine Schreibberechtigung wie clippings:write oder prompts:write anfordert und du sie auf dem Bestätigungsbildschirm freigibst. Vor dem Löschen wirst du immer um Bestätigung gebeten.

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 genau die auf dem Bestätigungsbildschirm angezeigten Berechtigungen. Schreibrechte sind dort hervorgehoben und niemals enthalten, wenn der Client sie nicht angefordert hat.

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 und Projektkonfiguration.
`projects:write`	Projekt-Tags und Metriken anlegen und bearbeiten.
`prompts:read`	KI-Sichtbarkeits-Prompts und Prompt-Themen.
`prompts:write`	Prompts erstellen und bearbeiten.
`clippings:read`	Gefilterte Clipping-Listen und vollständige Clipping-Details.
`clippings:write`	Clippings erstellen und bearbeiten.
`outlets:read`	Outlet-Listen und vollständige Outlet-Details.
`reports:read`	Report-Listen und vollständige Report-Details.
`reports:write`	Reports erstellen, bearbeiten und löschen.
`dashboards:read`	Dashboard-Listen und vollständige Dashboard-Details.
`dashboards:write`	Dashboards erstellen, bearbeiten und löschen.
`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.

Manche Tools benötigen für ihre Ressource sowohl den Schreib- als auch den Lese-Scope, weil sie den Datensatz für ihre Arbeit lesen. delete_prompt benötigt prompts:write und prompts:read, und die Update- und Replace-Tools für Reports und Dashboards benötigen den Lese-Scope, um die Änderung auf der aktuellen Version des Dokuments aufzusetzen.

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`
`create_tag` — Tags anlegen	Legt einen oder mehrere Tags in einem Projekt an (bis zu 25 pro Aufruf).	`projects:write`
`update_tag` — Tag aktualisieren	Ändert Name, Beschreibung oder Tag-Gruppe eines bestehenden Tags.	`projects:write`
`create_custom_metric` — Metriken anlegen	Legt eine oder mehrere projektdefinierte Clipping-Metriken an (bis zu 25 pro Aufruf).	`projects:write`
`update_custom_metric` — Metrik aktualisieren	Ändert eine bestehende projektdefinierte Clipping-Metrik.	`projects:write`
`list_prompts` — KI-Sichtbarkeits-Prompts auflisten	Listet beobachtete Prompts mit Standort, Status und Thema auf.	`prompts:read`
`list_prompt_topics` — Prompt-Themen auflisten	Listet Prompt-Themen zum Filtern und Gruppieren von KI-Sichtbarkeitsdaten auf.	`prompts:read`
`create_prompt` — Prompts anlegen	Fügt einem Projekt einen oder mehrere KI-Sichtbarkeits-Prompts hinzu (bis zu 25 pro Aufruf). Ergebnisse erscheinen über die folgenden Läufe, nicht sofort.	`prompts:write`
`update_prompt` — Prompt aktualisieren	Ändert einen bestehenden Prompt. Neuer Wortlaut gilt ab dem nächsten Lauf und ändert bereits erhobene Ergebnisse nicht.	`prompts:write`
`delete_prompt` — Prompt löschen	Beendet nach deiner Bestätigung die Abfrage eines Prompts. Erhobene Ergebnisse bleiben erhalten.	`prompts:write`, `prompts:read`
`list_clippings` — Clippings auflisten	Listet kompakte Clipping-Datensätze, gefiltert über einen booleschen Filterausdruck für Datum, Kanal, Tags, Outlet, Land, Sentiment und mehr.	`clippings:read`
`get_clipping` — Clipping abrufen	Gibt die vollständigen Details eines Clippings zurück.	`clippings:read`
`clip_url` — URL clippen	Legt Coverage aus einem Link an und lässt die Verarbeitung Titel, Veröffentlichungsdatum, Outlet, Sentiment und Metriken selbst ermitteln. Der bevorzugte Weg, Coverage anzulegen.	`clippings:write`
`create_clipping` — Clipping anlegen	Erfasst Coverage ohne abrufbaren Link, etwa Print oder Rundfunk. Speichert genau die übergebenen Felder und leitet nichts ab.	`clippings:write`
`update_clipping` — Clipping aktualisieren	Ändert Felder eines bestehenden Clippings. Ein nicht existierendes Outlet wird abgelehnt.	`clippings:write`
`get_report` — Report abrufen	Gibt einen Report mit seinen vollständigen, geordneten Inhaltsblöcken zurück.	`reports:read`
`create_report` — Reports anlegen	Legt einen oder mehrere Reports in einem Projekt an (bis zu 25 pro Aufruf), auf Wunsch direkt mit Inhaltsblöcken. Immer privat.	`reports:write`
`update_report` — Report-Einstellungen ändern	Ändert Name, Farbe, Freigabestufe, Filter oder Sortierung eines Reports. Die Inhaltsblöcke bleiben unberührt.	`reports:write`, `reports:read`
`replace_report_blocks` — Report-Blöcke ersetzen	Setzt den vollständigen, geordneten Inhalt eines Reports. Ersetzt die gesamte Sammlung, weggelassene Blöcke werden entfernt.	`reports:write`, `reports:read`
`get_dashboard` — Dashboard abrufen	Gibt ein Dashboard mit seinen vollständigen, geordneten Charts zurück.	`dashboards:read`
`create_dashboard` — Dashboards anlegen	Legt ein oder mehrere Dashboards in einem Projekt an (bis zu 25 pro Aufruf), auf Wunsch direkt mit Charts. Immer privat.	`dashboards:write`
`update_dashboard` — Dashboard-Einstellungen ändern	Ändert Name, Freigabestufe, Filter, Vergleichszeitraum oder die Filterbarkeit für Betrachtende eines Dashboards. Die Charts bleiben unberührt.	`dashboards:write`, `dashboards:read`
`replace_dashboard_charts` — Charts ersetzen	Setzt die vollständige, geordnete Chart-Liste eines Dashboards. Ersetzt die gesamte Sammlung, weggelassene Charts werden entfernt.	`dashboards:write`, `dashboards: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`
`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_scalar` — Einzelwert abfragen	Gibt einen einzelnen Gesamtwert für eine Metrik zurück, optional gegen einen Vergleichszeitraum.	`analytics:read`
`query_analytics_scalars` — Mehrere Werte abfragen	Gibt mehrere unabhängige Gesamtwerte in einem Aufruf zurück, einen je angeforderter Metrik.	`analytics:read`
`query_analytics_series` — Zeitreihe abfragen	Gibt Tageswerte für eine oder mehrere Metriken über einen Zeitraum zurück.	`analytics:read`
`query_analytics_breakdown` — Aufschlüsselung abfragen	Schlüsselt eine Metrik nach einer Dimension auf (Marke, Anbieter, Thema, Prompt, Land, Kanal, Outlet, Tag, Sentiment) und sortiert die Gruppen.	`analytics:read`
`query_analytics_table` — Tabelle abfragen	Schlüsselt mehrere Metriken nach einer Dimension auf, mit einer Zeile je Gruppe und einer Spalte je Metrik.	`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, und ein Tool erscheint nur, wenn die Verbindung alle Scopes besitzt, die es benötigt. Manche brauchen mehr als einen: delete_prompt liest zusätzlich den Datensatz, um ihn in der Bestätigung zu beschreiben, und die Update- und Replace-Tools für Reports und Dashboards lesen das Dokument, um die Änderung auf dessen aktueller Version aufzusetzen.

OAuth-Verbindungen erhalten die vom Client angeforderten unterstützten Scopes; fordert der Client keine Scopes an, gewährt aclipp alle unterstützten Lese-Scopes und keinen Schreibzugriff. Aktualisiere oder ersetze bei API-Keys den Key mit den benötigten Scopes und verbinde den Server anschließend neu, damit der Client seine Tool-Liste aktualisiert.

Ein Tool kann außerdem erscheinen und trotzdem abgelehnt werden. Tools werden allein anhand der Scopes angeboten, eine OAuth-Verbindung handelt aber mit deiner Rolle im Workspace, und diese Rolle wird bei jedem Aufruf neu geprüft. Eine Editor-Rolle darf zum Beispiel Dashboards anlegen, aber nicht ändern: update_dashboard wird angeboten und antwortet dann, dass die Änderung nicht erlaubt ist. API-Keys sind nicht an eine Rolle gebunden.

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