Cursor mit deinem Studio verbinden

Was ist das

Cursor ist ein Editor mit integrierter KI. Mit dem KI-Konnektor kann der Chat in Cursor die Daten deines Studios (Umsätze, Kunden, Kalender, Finanzen) abrufen, wenn du eine Frage stellst. Dabei gelten die Berechtigungen des Nutzers, dem der API-Schlüssel gehört. Der Konnektor ruft Daten nur ab und ändert nichts im System.

Wann verwenden

Du entwickelst eine Integration oder eine Website und möchtest die echten Daten deines Studios prüfen, ohne den Editor zu verlassen.
Du nutzt den Cursor-Chat im Alltag und möchtest Fragen zum Betrieb deines Studios stellen.

Bevor Sie beginnen

Halte die Adresse des Konnektors und einen API-Schlüssel mit aktivierter Option „KI-Konnektor verwenden erlauben“ bereit. Erstelle beides wie im Artikel KI-Konnektor beschrieben.

Schritt für Schritt

Schritt 1 — Konnektor hinzufügen

Öffne (oder erstelle) die Datei ~/.cursor/mcp.json und füge den folgenden Abschnitt hinzu. Ersetze dabei die Adresse durch die Adresse, die du über Adresse kopieren kopiert hast, und hk_... durch deinen API-Schlüssel:

{
  "mcpServers": {
    "heya": {
      "url": "https://seu-dominio/mcp",
      "headers": { "Authorization": "Bearer hk_..." }
    }
  }
}

Schritt 2 — Verbindung prüfen

Öffne in den Cursor-Einstellungen den Bereich MCP. Der Konnektor heya sollte als aktiv angezeigt werden und die Tools listar_areas, buscar_ferramentas und executar_consulta enthalten.

Schritt 3 — Eine Frage stellen

Stelle im Cursor-Chat zum Beispiel die Frage: „Welche Kunden wurden heute im Studio bedient?“

Was danach passiert

Cursor findet die passende Abfrage für deine Frage, führt sie aus und antwortet mit den Zahlen aus dem System.
Der API-Schlüssel wird im Tab API Key angezeigt. Der Wert unter Zuletzt verwendet wird aktualisiert.
Um den Zugriff zu beenden, widerrufe den Schlüssel im Tab API Key. Cursor verliert den Zugriff innerhalb von 30 Sekunden.

Häufige Fehler und Fragen

F: Der Konnektor wird in den Cursor-Einstellungen mit einem Fehler angezeigt. Was kann ich tun?
A: Prüfe, ob die Adresse mit /mcp endet und ob du den vollständigen Schlüssel eingefügt hast, einschließlich Bearer und dem Leerzeichen danach. Schalte den Konnektor in den Cursor-Einstellungen aus und wieder ein, nachdem du mcp.json bearbeitet hast.

F: Kann ich anstelle des Schlüssels eine Umgebungsvariable verwenden?
A: Bei einigen Cursor-Versionen wird die Variable im Header nicht durch ihren Wert ersetzt, sondern als Klartext gesendet. Wenn sich der Konnektor mit der Variable nicht verbinden lässt, füge den Schlüssel direkt in die Datei deines Benutzerkontos ein.

F: Kann ich die Konfiguration in der Projektdatei .cursor/mcp.json speichern?
A: Besser nicht: Diese Datei wird oft in die Versionsverwaltung übernommen, sodass der Schlüssel offengelegt würde. Verwende die Datei deines Benutzerkontos (~/.cursor/mcp.json).

F: Cursor meldet, dass der Schlüssel die Option „KI-Konnektor verwenden erlauben“ benötigt. Warum?
A: Der Schlüssel wurde ohne diese Option erstellt. Bearbeite den Schlüssel im Tab API Key und aktiviere Verwendung als KI-Konnektor erlauben.

F: Cursor hat statt der Verwendung des Schlüssels eine Anmeldeseite geöffnet. Was kann ich tun?
A: Prüfe, ob der Abschnitt headers mit dem Schlüssel in mcp.json steht. Mit dem richtigen Schlüssel antwortet das System direkt, eine Anmeldung ist nicht erforderlich. Wenn Cursor trotzdem auf einer Anmeldung besteht und diese fehlschlägt, verwende den Schlüssel mit Claude Code oder Gemini CLI oder wende dich an den Support.

F: Kann Cursor über den Konnektor Systemdaten ändern?
A: Nein. Der Konnektor ruft Daten nur ab. Änderungen werden im System vorgenommen.