Zum Hauptinhalt springen

Richten Sie GitHub Copilot für Kanera MCP ein

GitHub Copilot in VS Code stellt über das eine Verbindung zu Kanera her Modellkontextprotokoll. Dieses Handbuch behandelt die VS Code-Desktopanwendung. Copilot CLI und der Codierungsagent von GitHub.com verwenden unterschiedliche MCP-Konfigurationsspeicherorte.

Sie benötigen Zugriff auf GitHub Copilot und VS Code 1.99 oder höher. Wenn Copilot von einem Unternehmen oder einer Unternehmensorganisation stammt, muss der Administrator dies aktivieren MCP-Server in Copilot Politik.

Für eine Remote-Verbindung fügen Sie die MCP-Adresse von Kanera hinzu und authentifizieren Sie sich in Ihrem Browser. Sie müssen keinen API-Schlüssel erstellen oder speichern.

  1. Ausführung MCP: Server hinzufügen Wählen Sie in der Befehlspalette die Option aus HTTP, eintreten https://mcp.kanera.app/mcp, nenne es kaneraund speichern Sie es in Ihrem Benutzerprofil. Alternativ können Sie auch ausführen MCP: Benutzerkonfiguration öffnen und Kanera manuell hinzufügen oder erstellen .vscode/mcp.json für den aktuellen Arbeitsbereich.

  2. Für die manuelle Konfiguration fügen Sie Kanera als Remote-HTTP-Server hinzu:

    {
      "servers": {
        "kanera": {
          "type": "http",
          "url": "https://mcp.kanera.app/mcp"
        }
      }
    }

  3. Starten Sie den Server und bestätigen Sie, dass Sie seiner Konfiguration vertrauen. VS Code erkennt die OAuth-Anforderung und öffnet den Browser-Authentifizierungsfluss; wenn die Inline-Aktionen angezeigt werden Auth, wählen Sie es aus.

  4. Melden Sie sich bei Kanera an, überprüfen Sie den angeforderten Zugriff und wählen Sie Zugriff erlauben.

  5. Ausführung MCP: Server auflisten um zu bestätigen, dass Kanera verbunden ist. Öffnen Sie den Copilot-Chat in Agent Modus und bestätigen Sie, dass die Kanera-Werkzeuge in der Werkzeugauswahl angezeigt werden.

Siehe Verbinden Sie einen KI-Agenten für Bereiche und Trennen eines Agenten.

Installieren Sie den Kanera-Skill​

Über die MCP-Verbindung erhält Copilot Zugriff auf die Tools von Kanera. Das optionale Fertigkeit des Kanera-Agenten Er lehrt, wie man diese Tools zuverlässig verwendet: Namen in stabile IDs auflösen, den Live-Status lesen, bevor Arbeit gemeldet oder geändert wird, abgeschlossene Arbeit von neu erstellter Arbeit unterscheiden, Idempotenzschlüssel verwenden und Berechtigungs- oder Ratenbegrenzungsfehler sicher 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 ~/.copilot/skills/kanera/ für eine persönliche Kompetenz, die projektübergreifend verfügbar ist.
  • .agents/skills/kanera/ oder .github/skills/kanera/ in einem Repository, um den Skill mit diesem Projekt zu teilen.

Verwenden Sie im Copilot-Chat /skills um zu bestätigen, dass der Skill verfügbar ist. Copilot kann es automatisch laden, wenn eine Anfrage Kanera betrifft, oder Sie können es aufrufen kanera Fähigkeit 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:

  • Ihr VS-Code-Setup kann den Remote-OAuth-Ablauf 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. :::

Ersetzen kanera_live_... mit persönlichem Schlüssel von Profileinstellungen -> API-Schlüssel oder ein Arbeitsbereichsschlüssel von Arbeitsbereichseinstellungen -> API, und eingestellt KANERA_PUBLIC_API_URL zu https://api.kanera.app. Für ein persönliches VS-Code-Setup ist ein persönlicher Schlüssel normalerweise die richtige Wahl, da er Ihrem eigenen Board-Zugriff in allen Arbeitsbereichen folgt.

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

VS Code-Desktop-App​

GitHub Copilot liest MCP-Server von einem .vscode/mcp.json Datei in Ihrem Arbeitsbereich. Für eine persönliche Konfiguration, die projektübergreifend verfügbar ist, führen Sie Folgendes aus MCP: Benutzerkonfiguration öffnen aus der Befehlspalette und bearbeiten Sie den Benutzer mcp.json Datei.

Führen Sie für einen lokalen stdio-Server Folgendes aus: Kanera CLI als Server (Knoten 22 oder höher). Wenn Sie bereits gelaufen sind kanera auth login, können Sie weglassen env; kanera mcp verwendet die gespeicherten Anmeldeinformationen wieder.

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

Für einen Remote-HTTP-Endpunkt mit einem statischen API-Schlüssel:

{
  "servers": {
    "kanera": {
      "type": "http",
      "url": "https://mcp.kanera.app/mcp",
      "headers": {
        "Authorization": "Bearer kanera_live_..."
      }
    }
  }
}

Benutzen Sie die Werkzeuge​

Öffnen Sie die Copilot-Chat-Ansicht und wechseln Sie zu Agent Modus, und die Kanera-Tools werden in der Tools-Auswahl angezeigt, sobald der Server gestartet wird.

Übertragen Sie keinen API-Schlüssel .vscode/mcp.json. Fügen Sie die persönliche Konfiguration in die Datei auf Benutzerebene ein oder nutzen Sie die Eingabevariablenunterstützung von VS Code, damit das Geheimnis angefordert und nicht im Repository gespeichert wird.

Kundenreferenzen​