Doku

Mit Claude, ChatGPT & anderen KI-Assistenten verbinden (MCP)

Lass KI-Assistenten deine CrunchJunkie-Daten sicher über das Model Context Protocol lesen – und, wenn du es freischaltest, auch etwas anlegen.

Was der MCP-Connector macht

CrunchJunkie bringt einen Connector für das Model Context Protocol (MCP) mit. KI-Assistenten können damit deine Workspace-Daten direkt im Chat lesen – deine Kunden, verbundenen Datenquellen, Berichte samt Berichtsdaten und die Metriken zur KI-Sichtbarkeit. Du fragst zum Beispiel „Fass den Google-Ads-Bericht von Acme für den letzten Monat zusammen“ oder „Bei welchen Prompts ist Acme in ChatGPT unsichtbar?“ – und der Assistent holt die Antwort aus deinen Live-Daten in CrunchJunkie, statt dass du irgendetwas exportierst. Das ist ein einziger Server, keine Sammlung von Integrationen pro Anbieter. Dieselbe Connector-URL funktioniert mit claude.ai, mit ChatGPT (inklusive Deep Research – genau dafür gibt es die eingebauten Such- und Abruf-Tools des Connectors) und mit jedem anderen MCP-fähigen Client. Überall dieselben Tools, dieselben Scopes, dieselben Schutzmechanismen. Zwei Dinge sind bewusst so gebaut. Der Zugriff ist auf dein Team begrenzt: Ein Assistent sieht immer nur den Workspace des Kontos, das sich angemeldet hat. Und Lesen verändert nie etwas – die lesenden Tools holen und durchsuchen Daten, mehr nicht. Der Connector kann außerdem etwas für dich anlegen – einen Bericht entwerfen, ein Widget ergänzen, einen Versand planen, einen Prompt zur KI-Sichtbarkeit tracken –, aber erst, wenn ein Workspace-Inhaber das freischaltet, und auch dann gilt: erst Vorschau, dann Bestätigung (siehe „Einen Assistenten handeln lassen“ weiter unten). Gelöscht wird nie etwas, und Abrechnung, Tarif und Kontoeinstellungen sind komplett außer Reichweite. Der Connector ist in allen bezahlten Tarifen enthalten.

Einen Assistenten verbinden

Öffne Einstellungen → KI-Assistenten verbinden (MCP), um deine Connector-URL zu finden (sie sieht aus wie https://app.crunchjunkie.io/api/mcp/mcp). Füge diese URL in deinem Client als Remote-MCP-Server hinzu: • Claude (claude.ai oder Desktop) – Settings → Connectors → Add custom connector → URL einfügen. • ChatGPT – Settings → Connectors → Add (verfügbar in Pro/Team/Enterprise), oder als Quelle in Deep Research hinzufügen → URL einfügen. • Alles andere, das MCP spricht – dort eintragen, wo der Client eine Remote-MCP-Server-URL entgegennimmt. Es gibt nichts anbieterspezifisch einzustellen. Beim Hinzufügen schickt dich der Client auf einen CrunchJunkie-Anmeldebildschirm, auf dem du den Zugriff freigibst – überall derselbe OAuth-Ablauf. Du meldest dich genauso an wie in der App, bestätigst den Zugriff, und fertig – keine API-Schlüssel zum Kopieren oder Verwalten. Weil die Freigabe an deinem normalen Login hängt, handelt der Assistent als du und sieht nur, was dein Konto sehen kann. Den Zugriff kannst du jederzeit in den Connector-Einstellungen deines Clients widerrufen. Fünf Scopes können angefragt werden; auf dem Zustimmungsbildschirm siehst du, welche erteilt wurden: • read:reports – Berichte auflisten, öffnen und ihre Daten abrufen • read:visibility – Metriken zur KI-Sichtbarkeit und zur Shopping-Sichtbarkeit lesen • read:clients – deine Kunden und deren verbundene Datenquellen auflisten • write:reports – Bericht anlegen, Widget ergänzen, Versand planen • write:visibility – einen Prompt zur KI-Sichtbarkeit ins Tracking aufnehmen Wenn du dich verbunden hast, bevor es die Write-Scopes gab, läuft deine Verbindung einfach weiter: Tokens werden nur beim Neuverbinden neu ausgestellt, nicht bei einem Deploy – deshalb akzeptiert ein schreibendes Tool weiterhin den Lese-Scope, den es ursprünglich verlangt hat. Verbinde bei Gelegenheit neu, dann trägt dein Token die korrekten Scope-Namen. So oder so ändert ein Scope allein nie etwas – siehe die drei Sperren weiter unten.

Was der Assistent lesen kann

Die lesenden Tools sind: deine Kunden auflisten, die verbundenen Datenquellen eines Kunden auflisten, Berichte auflisten und öffnen, die Daten eines Berichts abrufen, Metriken zur KI-Sichtbarkeit lesen, die Shopping-Sichtbarkeit auf Produktebene lesen (Empfehlungsrate, Gewinnrate im Direktvergleich und Wettbewerbsprodukte) sowie eine allgemeine Suche und Abfrage über deinen Workspace. Lesen steht in jedem bezahlten Tarif zur Verfügung und verändert deine Daten nie – es gibt keinen Zugriff auf die Abrechnung und keine Möglichkeit, Tarif, Team oder Einstellungen aus dem Chat heraus zu ändern. Wenn ein Tool „missing scope“ oder „forbidden“ zurückgibt, heißt das meist: Das angemeldete Konto ist in keinem bezahlten Tarif oder nicht Mitglied des Teams, dem die Daten gehören. Melde dich dann mit einem Konto an, das Zugriff auf den Workspace hat, nach dem du fragst.

Einen Assistenten handeln lassen (optional)

Deine Daten zu lesen ist nur die halbe Miete. Wenn der Assistent auch etwas für dich ändern soll – „Entwirf einen Google-Ads-Bericht für Acme“, „Schick den Bericht von Acme jeden Montag um 9 Uhr“, „Track ab jetzt den Prompt ‚bestes CRM für Agenturen‘ für Acme“ oder „Füg dem Bericht eine Tabelle mit Conversions nach Gerät hinzu“ –, gibt es dafür vier Aktions-Tools: create_report, add_widget und schedule_report (abgedeckt durch write:reports) sowie add_tracking_prompt (abgedeckt durch write:visibility). Jedes davon ist dreifach gesperrt, und alle drei Bedingungen müssen erfüllt sein: 1. Scope – das Token muss den passenden Write-Scope tragen (oder, bei Verbindungen aus der Zeit vor diesen Scopes, den Lese-Scope, den das Tool früher verlangt hat). 2. Workspace-Einstellung – „Schreibaktionen erlauben“ muss unter Einstellungen → KI-Assistenten verbinden (MCP) eingeschaltet sein. Standardmäßig ist sie aus, und nur Inhaber oder Admins können sie ändern. Solange sie aus ist, liest der Connector und sonst nichts – egal welche Scopes ein Token hat. 3. Bestätigung – das Tool muss mit confirm: true aufgerufen werden. Ohne das liefert es nur eine Vorschau dessen, was es anlegen würde – die Widgets des Berichts, Rhythmus und Empfänger des Versands, den Prompt-Text – und ändert nichts. Inhalte, die der Connector erstellt, folgen der Sprache deines Workspace. Steht dein Konto auf Deutsch, bekommt ein über den Connector entworfener Bericht deutsche Abschnittstitel statt englischer. (Das betrifft den Text, den CrunchJunkie selbst schreibt; dein Assistent hat ohnehin schon in der Sprache geantwortet, in der du gefragt hast.) Jede Aktion wird in ein Audit-Log geschrieben, bleibt auf dein Team begrenzt und rührt weder Abrechnung noch Kontoeinstellungen an. Du kannst Aktionen jederzeit wieder ausschalten, die lesenden Tools laufen unabhängig davon weiter. Dahinter steckt dieselbe geerdete, gegen den Katalog geprüfte Logik wie bei „Mit KI entwerfen“ und „Ask Crunch ein Widget bauen lassen“ in der App – ein Assistent kann also nur Dinge bauen, die CrunchJunkie tatsächlich unterstützt, und niemals eine Metrik oder eine Datenquelle erfinden.