# 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: 1. **Organisation wählen:** Eine Verbindung gilt immer für genau eine Organisation. Zum Wechseln trennst du die Verbindung und verbindest dich neu. 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:** 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](https://app.aclipp.com/settings/api/connected-apps) und können jede davon sofort trennen. ### Claude (Web) 1. Öffne die Einstellungen, dann Connectors, und wähle "Add custom connector". 2. Trage `https://api.aclipp.com/mcp` als URL ein und bestätige. 3. Klicke auf Verbinden und schließe die aclipp Anmeldung im Browserfenster ab. 4. 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: 1. Ö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. 2. Erstelle einen Connector mit der MCP-Server-URL `https://api.aclipp.com/mcp` und OAuth als Authentifizierungsmethode. 3. 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](https://app.aclipp.com/settings/api) 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](https://app.aclipp.com/settings/api/connected-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](https://app.aclipp.com/settings/api), 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.