KI-Tools per MCP mit aclipp verbinden

Der aclipp MCP-Server lässt kompatible KI-Clients direkt mit den PR-Daten arbeiten. Du kannst Coverage untersuchen, Outlets, Autor:innen und Projektkonfigurationen abrufen und die KI-Sichtbarkeit analysieren, ohne Daten vorher zu exportieren, und du kannst Projekte samt ihren Wettbewerbern einrichten sowie 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 jedem Löschen wirst du um Bestätigung gebeten. Ein Lösch-Tool nimmt bis zu 25 Datensätze auf einmal, fragt einmal für alle und meldet, welche gelöscht wurden und welche nicht. Beim Ersetzen von Report-Blöcken oder Dashboard-Charts werden weggelassene Elemente entfernt.

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, und sie unterscheiden sich in einem wichtigen Punkt: Ein API-Key gilt immer für genau eine Organisation, eine Anmeldung mit aclipp kann mehrere umfassen.

• 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

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 aclipp in einem Client verbindest, entweder über die Connector-Liste des Clients oder indem du https://api.aclipp.com/mcp als benutzerdefinierten 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:

1. Organisationen wählen: Gehörst du nur einer Organisation an, wird sie verwendet und es gibt nichts auszuwählen. Gehörst du mehreren an, wähle alle aus, für die diese Verbindung gelten soll, und aktiviere bei Bedarf Künftige Organisationen einschließen, damit eine später hinzukommende Organisation ohne neues Verbinden abgedeckt ist. Die Tools nehmen dann eine optionale organizationId entgegen; ohne sie arbeitet der Aufruf in deiner Standard-Organisation.
2. 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.
3. Erlauben: Unter Berechtigungen anzeigen siehst du die angeforderten Aktionen je Bereich. Der Client erhält genau diese Berechtigungen; Schreibrechte sind nur enthalten, wenn er sie 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)

aclipp ist ein Claude Connector, du musst also keinen Server einrichten.

1. Öffne die Einstellungen, dann Connectors, und suche nach "aclipp".
2. Klicke auf Verbinden und schließe die aclipp Anmeldung im Browserfenster ab.
3. Aktiviere den aclipp Connector im Tools-Menü eines Chats. Die aclipp Tools sind jetzt verfügbar.

Bei Team- und Enterprise-Plänen muss ein Admin Connectors gegebenenfalls zuerst freischalten.

Findest du aclipp nicht in der Liste, kannst du es weiterhin als benutzerdefinierten Connector hinzufügen: Wähle "Add custom connector" und trage https://api.aclipp.com/mcp als URL ein. Benutzerdefinierte Connectors erfordern einen bezahlten Claude Plan.

Claude Desktop

Claude Desktop verwendet dieselben Connector-Einstellungen wie Claude im Web: Suche unter Einstellungen, Connectors nach "aclipp", klicke auf Verbinden und schließe die Anmeldung im Browser ab.

ChatGPT

aclipp gibt es als ChatGPT-Plugin, du musst also keinen Server einrichten.

1. Öffne das aclipp-Plugin in ChatGPT und füge es hinzu.
2. Schließe die aclipp Anmeldung im Browserfenster ab und bestätige die Verbindung.
3. Aktiviere das aclipp-Plugin in einem Chat. Die aclipp Tools sind jetzt verfügbar.

Bei Team- und Enterprise-Plänen muss ein Admin Plugins gegebenenfalls zuerst erlauben.

Wenn du es lieber selbst einrichtest, kannst du aclipp weiterhin über den Developer Mode als benutzerdefinierten Connector hinzufügen: Öffne die Einstellungen, dann Apps & Connectors, dann Advanced, und aktiviere den Developer Mode. Erstelle dann einen Connector mit der MCP-Server-URL https://api.aclipp.com/mcp und OAuth als Authentifizierungsmethode. Dafür ist ein bezahlter Plan nötig; bei Team- und Enterprise-Plänen muss ihn ein Admin erlauben.

ChatGPT speichert beim Freigeben einer Verbindung einen Snapshot der Tool-Definitionen. Verbinde aclipp neu, sobald es neue Tools veröffentlicht, damit ChatGPT seine Liste aktualisiert.

API-Key erstellen

Öffne für Claude Code und Cursor die API-Einstellungen des 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:

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. Jedes Lösch-Tool außer delete_monitoring benötigt beide, etwa delete_prompt 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.

MCP bietet Änderungen an bestehenden Outlets und Autor:innen an. Anlegen und Löschen ist über die REST API möglich. MCP kann Reports und Dashboards erstellen, ihre Einstellungen ändern und ihre Inhalte ersetzen; zum Löschen nutzt du ebenfalls die REST API. Ein API-Key für MCP schaltet keine zusätzlichen Tools außerhalb des folgenden Katalogs frei.

alerts:write erlaubt das Anlegen, Aktualisieren und Löschen von Alerts über MCP. Um die E-Mails eines Alerts zu pausieren, ohne ihn zu löschen, setze enabled mit update_alert auf false.

Claude Code

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

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

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:

/mcp

/mcp

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

claude mcp list

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:

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

{
  "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:

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

Erste Analyse starten

Lass den Client zuerst das Projekt und seine Konfiguration ermitteln:

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.

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:

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.

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: jedes Lösch-Tool außer delete_monitoring 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.

Zu viele Anfragen

Der MCP-Server erlaubt 300 Anfragen pro Minute und 20.000 pro Tag, gezählt pro angemeldeter Person oder pro API-Key. Über dem Limit schlagen Aufrufe mit 429 und einem Retry-After-Header fehl; warte so lange, bevor du es erneut versuchst. Siehe Rate Limits.

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 bzw. das Plugin 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:

claude mcp remove aclipp --scope user

claude mcp remove aclipp --scope user

Entferne bei Cursor den Eintrag aclipp aus mcp.json. Widerrufe den API-Key in den API-Einstellungen des 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.