Zum Hauptinhalt springen

Richten Sie Claude für Kanera MCP ein

Claude im Web, Claude Desktop und Claude Code können über das eine Verbindung zu Kanera herstellen Modellkontextprotokoll.

Claude und Claude Desktop: Mit OAuth verbinden​

Kanera ist ein veröffentlichter Claude-Anschluss. Suchen nach Kanera unter Anpassen -> Anschlüsse und auswählen Verbinden. Claude öffnet einen Browser-Anmelde- und Einwilligungsbildschirm. Sie erstellen oder fügen keinen API-Schlüssel ein. Es funktioniert mit jedem gehosteten Kanera-Plan, einschließlich Free.

Wenn der veröffentlichte Connector für das aktuelle Konto oder den aktuellen Arbeitsbereich nicht sichtbar ist, fügen Sie denselben Produktionsendpunkt als benutzerdefinierten Connector hinzu:

  1. Offen Anpassen -> Anschlüsse.

  2. Auswählen + -> Benutzerdefinierten Connector hinzufügen.

  3. Geben Sie die MCP-Adresse von Kanera ein:

    https://mcp.kanera.app/mcp

  4. Auswählen Hinzufügen, dann Verbinden.

Für eine Team- oder Unternehmensorganisation, die Konnektoren einschränkt, muss ein Eigentümer oder Haupteigentümer möglicherweise Kanera unten aktivieren Organisationseinstellungen -> Konnektoren bevor Mitglieder es verbinden können.

Claude öffnet einen Kanera-Tab. Melden Sie sich an, überprüfen Sie, was der Agent tun kann, und wählen Sie aus Zugriff erlauben. Aktivieren Sie Kanera für ein Gespräch aus dem + -> Anschlüsse Menü neben dem Komponisten.

Verwalten oder trennen Sie den Agenten später von Profileinstellungen -> API-Schlüssel. Siehe Verbinden Sie einen KI-Agenten für Einzelheiten. Wenn OAuth keine Option ist, lesen Sie die API-Schlüsselausnahme unten.

Claude Code: Mit OAuth verbinden​

Wenn Claude Code mit demselben Claude-Konto angemeldet ist, führen Sie es zuerst aus claude mcp list. Wenn der veröffentlichte Kanera-Connector bereits vorhanden ist, starten Sie Claude Code und geben Sie ein /mcp, und verbinden oder authentifizieren Sie es dort. Fügen Sie keinen doppelten Server hinzu.

Wenn Kanera nicht vorhanden ist, fügen Sie den gehosteten Server für Ihren Benutzer hinzu, damit er projektübergreifend verfügbar ist:

claude mcp add --transport http kanera --scope user https://mcp.kanera.app/mcp

Starten Sie Claude Code und geben Sie ein /mcp. Wählen Sie Kanera aus und schließen Sie den Browser-Authentifizierungsvorgang ab. Lauf claude mcp list um es zu bestätigen meldet Verbunden.

Nur-Shell-Fallback​

Wenn ein Agent Shell-Befehle ausführen, aber kein MCP verwenden kann, installieren Sie die Kanera-CLI, anstatt die Webschnittstelle zu automatisieren:

npx -y @kanera/cli commands          # inspect it without a global install
npm install --global @kanera/cli     # persistent command; requires Node 22+
kanera auth login
kanera setup claude --global
kanera whoami --json

Die CLI stellt dieselbe Kanera-Tool-Ebene bereit. kanera auth login meldet sich über Ihren Browser mit OAuth an, genau wie der Connector, sodass kein Schlüssel erstellt werden muss; verwenden --with-api-key für einen unbeaufsichtigten Agenten. Bevorzugen Sie den veröffentlichten Connector, wenn er verfügbar ist, da keine Installation erforderlich ist.

Installieren Sie den Kanera-Skill​

Durch die MCP-Verbindung erhält Claude Zugriff auf die Tools von Kanera. Das optionale Fertigkeit des Kanera-Agenten lehrt es, Namen in stabile IDs aufzulösen, den aktuellen Status zu lesen, bevor Arbeit gemeldet oder geändert wird, Idempotenzschlüssel zu verwenden und Fehler sicher zu behandeln.

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

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

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:

  • Ihr Claude-Setup kann den veröffentlichten Connector oder einen benutzerdefinierten Connector nicht mit OAuth verwenden.
  • 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. :::

Ersetzen kanera_live_... mit persönlichem Schlüssel von Profileinstellungen -> API-Schlüssel oder ein Arbeitsbereichsschlüssel von Arbeitsbereichseinstellungen -> API. Für ein persönliches Claude-Setup eignet sich in der Regel ein persönlicher Schlüssel, da er Ihren eigenen Board-Zugriff über alle Arbeitsbereiche hinweg überwacht.

Workspace-API-Einstellungen, in denen ein Workspace-API-Schlüssel für Kanera MCP erstellt werden kann.

Claude Code​

Für den gehosteten HTTP-Endpunkt mit einem statischen Schlüssel:

claude mcp add --transport http kanera --scope user https://mcp.kanera.app/mcp \
  --header "Authorization: Bearer kanera_live_..."

Führen Sie für einen lokalen stdio-Server Folgendes aus: Kanera CLI als Server:

claude mcp add kanera --scope user \
  --env KANERA_API_KEY=kanera_live_... \
  --env KANERA_PUBLIC_API_URL=https://api.kanera.app \
  -- npx -y @kanera/cli mcp

Wenn Sie bereits gelaufen sind kanera auth login, lass beides fallen --env Fahnen; kanera mcp verwendet die gespeicherten Anmeldeinformationen wieder. Lauf claude mcp list um zu bestätigen, dass der Server verbunden ist.

Claude Desktop​

Offen Einstellungen -> Entwickler -> Konfiguration bearbeiten, das sich öffnet claude_desktop_config.json, und fügen Sie den Server darunter hinzu mcpServers:

{
  "mcpServers": {
    "kanera": {
      "command": "npx",
      "args": ["-y", "@kanera/cli", "mcp"],
      "env": {
        "KANERA_API_KEY": "kanera_live_...",
        "KANERA_PUBLIC_API_URL": "https://api.kanera.app"
      }
    }
  }
}

Starten Sie Claude Desktop nach dem Speichern neu, öffnen Sie dann eine neue Konversation und bestätigen Sie, dass die Kanera-Tools verfügbar sind. Diese Konfiguration führt den Server lokal über stdio aus und erfordert Knoten 22 oder höher.

Wenn Sie Kanera bereits in Claude Desktop konfiguriert haben und später Claude Code installieren, kann Claude Code die Desktop-Konfiguration importieren mit:

claude mcp add-from-claude-desktop

Dieser Importbefehl ist auf macOS und dem Windows-Subsystem für Linux (WSL) verfügbar.

Kundenreferenzen​