CrunchJunkie mit Claude Code verbinden

Claude Code, installiert und angemeldet, und ein CrunchJunkie-Konto mit aktivem bezahltem Tarif. Die Connector-URL lautet https://app.crunchjunkie.io/api/mcp/mcp. Du findest sie auch in CrunchJunkie unter Einstellungen → KI-Assistenten verbinden (MCP).

Führe im Terminal aus: claude mcp add --transport http crunchjunkie https://app.crunchjunkie.io/api/mcp/mcp Den Namen (crunchjunkie) kannst du frei wählen. Standardmäßig wird der Server nur für dich und das aktuelle Projekt gespeichert. Mit --scope user gilt er in allen deinen Projekten, mit --scope project wird er in die .mcp.json des Projekts geschrieben, sodass dein Team ihn teilt (Claude Code lässt jede Person einen Projekt-Server erst freigeben, bevor er genutzt wird).

Führe in Claude Code /mcp aus und folge den Schritten im Browser. In der Shell geht stattdessen claude mcp login crunchjunkie. Per SSH, wo es keinen lokalen Browser gibt (verbinde dich mit ssh -t, damit der Einfügeschritt funktioniert), gibt der Befehl die Autorisierungs-URL aus: Öffne sie auf deinem eigenen Rechner und füge dann die vollständige Weiterleitungs-URL aus der Adressleiste des Browsers an der Eingabeaufforderung ein. Mit --no-browser erzwingst du diesen Modus. Sobald der Assistent den Connector zum ersten Mal nutzt, schickt er dich auf eine CrunchJunkie-Anmeldeseite. Du meldest dich mit deinem CrunchJunkie-Konto an, genau wie in der App (E-Mail und Passwort, Google oder das SSO deines Unternehmens), und gibst den Zugriff frei. Einen API-Schlüssel musst du weder kopieren noch aufbewahren. Die Anmeldung läuft über OAuth 2.1 mit WorkOS AuthKit; der Assistent registriert sich per Dynamic Client Registration oder per Client ID Metadata Document selbst, du trägst also keine Client-ID und kein Secret ein. Die Verbindung handelt als du und sieht nur, was dein Konto sehen darf, jeweils in einem Workspace. Solange du nichts auswählst, ist das der Workspace, dem du zuerst beigetreten bist. Zum Wechseln öffnest du Einstellungen → KI-Assistenten verbinden (MCP) oder bittest den Assistenten, deine Workspaces aufzulisten und zu wechseln. Verlangt dein Unternehmen SSO, verbinde dich, nachdem du dich per SSO angemeldet hast. Claude Code speichert die Tokens und erneuert sie automatisch. Zum Abmelden nutzt du „Clear authentication“ im /mcp-Menü oder claude mcp logout crunchjunkie.

Starte einen neuen Chat mit eingeschaltetem Connector und frage: „Liste meine Kunden auf.“ Du solltest deine CrunchJunkie-Kunden zurückbekommen. Probiere dann eine echte Frage: „Wie sichtbar war <Marke> in den letzten 30 Tagen in KI-Antworten, mit Stichprobengrößen?“ Ersetze <Marke> durch einen deiner Kunden. Die Antwort stammt aus deinen Live-Daten und nennt, auf wie vielen KI-Antworten jeder Prozentwert beruht. Antwortet der Assistent stattdessen aus allgemeinem Wissen, ohne ein CrunchJunkie-Tool aufzurufen, sag ihm, er soll den CrunchJunkie-Connector verwenden. Mit /mcp siehst du, ob der Server als verbunden angezeigt wird.

Lesen ändert nie etwas. Schreibaktionen (einen Bericht anlegen, ein Widget hinzufügen, einen Prompt tracken und Ähnliches) sind aus, bis ein Inhaber oder Admin des Workspace unter Einstellungen → KI-Assistenten verbinden (MCP) „Schreibaktionen erlauben“ einschaltet. Auch dann gibt jedes Schreib-Tool zuerst eine Vorschau zurück und ändert nichts, bis du bestätigst, und ein Mitglied mit der Rolle „Nur Lesen“ kann gar nichts ändern. Die vollständigen Regeln stehen in der Connector-Dokumentation.

Die CrunchJunkie-Anmeldeseite öffnet sich nicht, oder der Assistent meldet, er sei nicht angemeldet: Entferne den Connector und füge ihn neu hinzu, und prüfe, dass die URL genau https://app.crunchjunkie.io/api/mcp/mcp lautet. Ein Tool antwortet „missing scope“ oder „forbidden“: Das Konto, mit dem du dich angemeldet hast, hat keinen aktiven bezahlten Tarif oder gehört nicht zu dem Workspace, dem die Daten gehören. Melde dich mit einem Konto an, das Zugriff hat. Gehört dein Konto zu mehreren Workspaces, arbeitet der Assistent womöglich in einem anderen; bitte ihn, deine Workspaces aufzulisten. Schreib-Tools werden abgelehnt: Schreibaktionen sind standardmäßig aus. Ein Inhaber oder Admin des Workspace schaltet sie unter Einstellungen → KI-Assistenten verbinden (MCP) ein. Öffnet sich der Browser nicht, kopiere die URL aus dem Terminal und öffne sie selbst. Schlägt die Weiterleitung nach der Anmeldung mit einem Verbindungsfehler fehl, füge die vollständige Callback-URL aus der Adressleiste an der Eingabeaufforderung in Claude Code ein. Läufe im nicht interaktiven Modus (claude -p) und Agent-SDK-Läufe können die Anmeldung nicht abschließen, melde dich also zuerst in einer interaktiven Sitzung an. Zum Neustart führst du claude mcp remove crunchjunkie aus, was auch die gespeicherten Tokens und die Client-Registrierung löscht, und fügst den Server erneut hinzu. Andere Assistenten findest du in der Connector-Dokumentation.