Zum Hauptinhalt springen

Richten Sie den Cursor für Kanera MCP ein

Der Cursor stellt über das eine Verbindung zu Kanera her Modellkontextprotokoll. Cursor unterstützt Remote-Streamable-HTTP-Server mit OAuth, sodass Sie über einen Browser eine Verbindung herstellen können, ohne einen API-Schlüssel erstellen oder speichern zu müssen.

Ein-Klick-Installation​

Wenn Cursor installiert ist, öffnen Sie diesen Link, um Kanera in einem Schritt zu Cursor hinzuzufügen:

Kanera zum Cursor hinzufügen

Der Cursor zeigt den Server an, der hinzugefügt werden soll (https://mcp.kanera.app/mcp) und fordert Sie zur Bestätigung auf. Schließen Sie dann die unten beschriebene Browser-Anmeldung ab. Wenn der Link Cursor nicht öffnet oder Sie Kanera selbst hosten, fügen Sie die Konfiguration stattdessen manuell hinzu. Die MCP-Konfigurationsgenerator erstellt auch den Link für eine selbst gehostete Adresse.

Manuelle Konfiguration​

Kanera zeigt unten diese Konfiguration mit Ihrer MCP-Adresse an Profileinstellungen -> API-Schlüssel -> Oder konfigurieren Sie es von Hand -> Cursor.

Fügen Sie Kanera zu Ihrer globalen Cursor MCP-Konfiguration hinzu unter ~/.cursor/mcp.json, oder zu .cursor/mcp.json in einem Projekt, wenn die Verbindung nur dort verfügbar sein soll:

{
  "mcpServers": {
    "kanera": {
      "url": "https://mcp.kanera.app/mcp"
    }
  }
}

Cursor erkennt, dass Kanera OAuth benötigt und fordert Sie zur Authentifizierung auf. Im Cursor Agent können Sie den Browserablauf explizit starten:

cursor-agent mcp login kanera

Melden Sie sich bei Kanera an, überprüfen Sie den angeforderten Zugriff und wählen Sie Zugriff erlauben. Überprüfen Sie dann die Verbindung und die verfügbaren Tools:

cursor-agent mcp list
cursor-agent mcp list-tools kanera

Öffnen Sie im Cursor-Editor Einstellungen -> Tools & MCP den Server und seine Tools zu inspizieren. Siehe Verbinden Sie einen KI-Agenten für Bereiche und Trennen eines Agenten.

Installieren Sie den Kanera-Skill​

Über die MCP-Verbindung erhält Cursor Zugriff auf die Tools von Kanera. Das optionale Fertigkeit des Kanera-Agenten lehrt es, Namen in stabile IDs aufzulösen, den Live-Status zu lesen, bevor Arbeit gemeldet oder geändert wird, abgeschlossene Arbeit von Erstellungsaktivität zu unterscheiden, Idempotenzschlüssel zu verwenden und Berechtigungs- oder Ratenbegrenzungsfehler sicher zu behandeln.

Installieren Sie den Skill global mit dem offenen Agent Skills-Installationsprogramm:

npx -y skills add https://github.com/happendev/Kanera/tree/main/integrations/skills/kanera --yes --global

Für eine manuelle Installation laden Sie die vollständige herunter kanera Fertigkeitsverzeichnis und platzieren Sie es an einem dieser Orte:

  • ~/.agents/skills/kanera/ oder ~/.cursor/skills/kanera/ für eine persönliche Kompetenz, die projektübergreifend verfügbar ist.
  • .agents/skills/kanera/ oder .cursor/skills/kanera/ in einem Repository, um den Skill mit diesem Projekt zu teilen.

Starten Sie Cursor neu, wenn der Skill nicht angezeigt wird. Cursor kann es automatisch für relevante Anfragen laden, oder Sie können es aufrufen /kanera explizit.

Ausnahme: Verbindung mit einem API-Schlüssel herstellen​

:::Achtung: Verwenden Sie OAuth, wann immer Sie können. Ein API-Schlüssel ist ein langlebiges Geheimnis, das Sie selbst speichern und rotieren, und die mit einem persönlichen Schlüssel ausgeführte Arbeit wird als Sie selbst aufgezeichnet, ohne dass dies der Fall ist über <agent> Etikett. Verwenden Sie eine davon nur, wenn OAuth wirklich nicht funktionieren kann:

  • Ihre Cursor-Version kann den Remote-OAuth-Fluss nicht abschließen.
  • Sie benötigen einen lokalen stdio-Server und können diesen nicht verwenden Kanera CLI. kanera auth login meldet sich mit OAuth an und kanera mcp stellt stdio mit dieser Anmeldung bereit, kein Schlüssel erforderlich.
  • Der Computer verfügt über keinen Browser für die Anmeldung. Versuchen Sie es Geräteautorisierung Zuerst, wenn Ihr Kunde dies unterstützt.

Wenn Sie einen Schlüssel verwenden, erstellen Sie ihn Schreibgeschützt es sei denn, der Agent muss die Arbeit ändern und sie in einer Umgebungsvariablen statt in einer festgeschriebenen Datei aufbewahren. :::

Lesen Sie den Schlüssel aus einer Umgebungsvariablen, anstatt ihn in eine Projektkonfiguration zu übernehmen:

{
  "mcpServers": {
    "kanera": {
      "url": "https://mcp.kanera.app/mcp",
      "headers": {
        "Authorization": "Bearer ${env:KANERA_API_KEY}"
      }
    }
  }
}

Set KANERA_API_KEY in der Umgebung, die Cursor startet. Erstellen Sie einen persönlichen Schlüssel Profileinstellungen -> API-Schlüssel oder eine Arbeitsbereichstaste eingeben Arbeitsbereichseinstellungen -> API.

Kundenreferenz​