CrunchJunkie mit Cursor verbinden

Cursor und ein CrunchJunkie-Konto mit aktivem bezahltem Tarif. Die Dokumentation von Cursor bindet Remote-MCP-Server nicht an einen bestimmten Cursor-Tarif; Teams können Server per Allowlist einschränken, ein Admin muss die URL dann womöglich freigeben. Die Connector-URL lautet https://app.crunchjunkie.io/api/mcp/mcp. Du findest sie auch in CrunchJunkie unter Einstellungen → KI-Assistenten verbinden (MCP).

Cursor liest MCP-Server aus einer mcp.json: ~/.cursor/mcp.json für alle Projekte oder .cursor/mcp.json in einem Projekt. Trage den Server mit dem Schlüssel url ein: { "mcpServers": { "crunchjunkie": { "url": "https://app.crunchjunkie.io/api/mcp/mcp" } } } Füge weder Header noch einen auth-Block hinzu. CrunchJunkie unterstützt Dynamic Client Registration, das Cursor bei Servern mit OAuth standardmäßig verwendet. MCP-Server kannst du auch unter Customize in der Seitenleiste von Cursor verwalten.

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. Laut Dokumentation von Cursor übernimmt Cursor die Authentifizierung bei Servern mit OAuth, beschreibt die Abfrage selbst aber nicht. Startet keine Anmeldung, öffne den Server in den MCP-Einstellungen von Cursor und suche nach einem Button zum Verbinden oder Anmelden.

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. Nutze den Agent-Chat, nicht eine Inline-Bearbeitung.

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. Verbindungs- und Anmeldefehler siehst du im Output-Panel (Cmd+Shift+U auf macOS) unter „MCP Logs“. Prüfe, dass das JSON gültig ist und die Datei am richtigen Ort liegt. Andere Assistenten findest du in der Connector-Dokumentation.