Zum Hauptinhalt springen

Richten Sie OpenCode für Kanera MCP ein

OpenCode stellt über das eine Verbindung zu Kanera her Modellkontextprotokoll. Es unterstützt die automatische OAuth-Erkennung und die dynamische Client-Registrierung für Remote-MCP-Server, sodass kein vorregistrierter Client oder API-Schlüssel erforderlich ist.

Fügen Sie Kanera zu Ihrer OpenCode-Konfiguration hinzu:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "kanera": {
      "type": "remote",
      "url": "https://mcp.kanera.app/mcp",
      "enabled": true
    }
  }
}

OpenCode startet OAuth automatisch, wenn Kanera zum ersten Mal eine Authentifizierung benötigt. Sie können den Browser-Flow auch explizit starten:

opencode mcp auth kanera

Melden Sie sich bei Kanera an, überprüfen Sie den angeforderten Zugriff und wählen Sie Zugriff erlauben. Lauf opencode mcp list um die Verbindung zu überprüfen. Wenn die Erkennung oder Authentifizierung fehlschlägt, verwenden Sie opencode mcp debug kanera um den Durchfluss zu prüfen.

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

Installieren Sie den Kanera-Skill​

Die MCP-Verbindung ermöglicht OpenCode 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 ~/.config/opencode/skills/kanera/ für eine persönliche Kompetenz, die projektübergreifend verfügbar ist.
  • .agents/skills/kanera/ oder .opencode/skills/kanera/ in einem Repository, um den Skill mit diesem Projekt zu teilen.

OpenCode listet den Skill seinen Agenten auf und lädt bei Bedarf die vollständigen Anweisungen. Wenn Sie Tools oder Fähigkeiten durch OpenCode-Berechtigungen einschränken, stellen Sie sicher, dass dies der Fall ist skill Werkzeug und die kanera_* MCP-Tools werden nicht abgelehnt.

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 OpenCode-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. :::

Referenzieren Sie eine Umgebungsvariable, anstatt den Schlüssel in der Konfiguration zu speichern:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "kanera": {
      "type": "remote",
      "url": "https://mcp.kanera.app/mcp",
      "oauth": false,
      "headers": {
        "Authorization": "Bearer {env:KANERA_API_KEY}"
      }
    }
  }
}

Erstellen Sie einen persönlichen Schlüssel Profileinstellungen -> API-Schlüssel oder eine Arbeitsbereichstaste eingeben Arbeitsbereichseinstellungen -> API.

Kundenreferenz​