Codex für Kanera MCP einrichten
Die ChatGPT-Desktop-App, die Codex-CLI und die Codex-IDE-Erweiterung stellen über das eine Verbindung zu Kanera her Modellkontextprotokoll. Sie teilen sich die MCP-Konfiguration für denselben Codex-Host, sodass Sie Kanera normalerweise nur einmal hinzufügen müssen.
Installieren Sie das Kanera-Plugin (empfohlen)
Öffnen Sie die ChatGPT-Desktop-App Plugins, suchen nach Kanera von Happen Software Limited, und installieren Sie es. Verbinden Sie Ihr Kanera-Konto über OAuth, wenn Sie dazu aufgefordert werden, starten Sie dann einen neuen Codex-Chat und bitten Sie ihn, Kanera zu verwenden. Das Plugin bündelt die MCP-Verbindung und den Skill, sodass keine separate Skill-Installation oder manuelle Serverregistrierung erforderlich ist.
Geben Sie in der Codex-CLI Folgendes ein: /plugins Um den Plugin-Browser zu öffnen, Kanera von einem verfügbaren Marktplatz zu installieren und eine neue Sitzung zu starten. Konto-, Arbeitsbereichsrichtlinien und konfigurierte Marktplatzquellen bestimmen die Verfügbarkeit.
Die IDE-Erweiterung unterstützt keine Plugins. Benutzen Sie die manuelle Verbindung und Standalone-Skill unten für die IDE, eine selbstgehostete Kanera-Bereitstellung oder einen Client, auf dem keine Plugins verfügbar sind. Vermeiden Sie die Registrierung eines zweiten gehosteten Servers, wenn das Plugin bereits verbunden ist.
Wenn das Plugin nicht verfügbar ist: manuelle Verbindung mit OAuth
Wenn Kanera auf Ihrem Plugin-Marktplatz fehlt oder die Plugin-Installation nicht verfügbar ist, fügen Sie den MCP-Server direkt hinzu und verbinden Sie Ihr Kanera-Konto mit OAuth. Die gehostete MCP-Adresse lautet https://mcp.kanera.app/mcp. Kopieren Sie für das Selbsthosting die MCP-Adresse Ihrer Bereitstellung von Profileinstellungen -> API-Schlüssel stattdessen. Sie müssen keinen API-Schlüssel erstellen oder speichern.
codex mcp add kanera --url https://mcp.kanera.app/mcp
codex mcp login kanera
Der Anmeldebefehl öffnet Kanera in Ihrem Browser. Melden Sie sich an, überprüfen Sie den angeforderten Zugriff und wählen Sie aus Zugriff erlauben. Lauf codex mcp list um zu überprüfen, ob der Server registriert ist, oder verwenden /mcp in der Codex-CLI, um die Verbindung zu überprüfen.
Öffnen Sie die ChatGPT-Desktop-App Einstellungen -> MCP-Server -> Server hinzufügen. Öffnen Sie in der IDE-Erweiterung das Zahnradmenü und wählen Sie MCP-Server -> Server hinzufügen. Treten Sie ein Kanera, wählen Streambares HTTP, und verwenden Sie dieselbe URL. Speichern Sie und starten Sie neu, wenn Sie dazu aufgefordert werden. Wählen Sie dann „ Authentifizieren wenn Kanera eine Anmeldung erfordert.
Sie können den Remote-Server auch direkt in konfigurieren ~/.codex/config.toml:
[mcp_servers.kanera]
url = "https://mcp.kanera.app/mcp"
Dann lauf codex mcp login kanera. Siehe Verbinden Sie einen KI-Agenten für Bereiche und Trennen eines Agenten.
Installieren Sie den Skill für eine manuelle Verbindung
Wenn Sie das Plugin installiert haben, ist der gebündelte Skill bereits verfügbar. Für eine manuelle Einrichtung ermöglicht die MCP-Verbindung Codex Zugriff auf die Tools von Kanera. Die Fertigkeit des Kanera-Agenten Bringt ihm bei, wie man diese Tools zuverlässig auswählt: Route genaue Kartenschlüssel wie DEV-938 direkt zu Kanera, bevorzugen Sie MCP gegenüber der Browser-Automatisierung für unterstützte Arbeiten, lösen Sie Namen in stabile IDs auf, lesen Sie den Live-Status, bevor Sie Arbeiten melden oder ändern, verwenden Sie Idempotenzschlüssel und gehen Sie sicher mit Berechtigungs- oder Ratenbegrenzungsfehlern um.
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 Kompetenzverzeichnis, einschließlich SKILL.md und agents/openai.yaml, und platzieren Sie es an einem dieser Orte:
~/.agents/skills/kanera/für eine persönliche Kompetenz, die projektübergreifend verfügbar ist..agents/skills/kanera/in einem Repository, um den Skill mit diesem Projekt zu teilen.
Codex erkennt Fertigkeitsänderungen normalerweise automatisch. Wenn es nicht angezeigt wird, starten Sie Codex neu. Erwähnen $kanera explizit in einer Eingabeaufforderung, um das Laden zu erzwingen, oder Codex es automatisch für die Kanera-Arbeit auswählen zu lassen.
Benutzen /apps um die Kanera-App anzuhängen, /plugins um zu überprüfen, ob das Kanera-Plugin und der gebündelte Skill verfügbar sind, und /mcp verbose um die Werkzeugverbindung zu bestätigen. Zum Beispiel:
$kanera Update DEV-938 with the investigation findings and agreed implementation plan.
Codex sollte diese Karte durchlesen cards.get und wenden Sie die angeforderte Änderung an
cards.update. Es sollte die Kanera-Weboberfläche nur für eine explizit visuelle Aufgabe oder einen Verwaltungsvorgang öffnen, den MCP nicht offenlegt.
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 Codex-Version 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 loginmeldet sich mit OAuth an undkanera mcpstellt 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 Codex-Setup eignet sich in der Regel ein persönlicher Schlüssel, da er Ihren eigenen Board-Zugriff über alle Arbeitsbereiche hinweg verfolgt.
ChatGPT-Desktop-App
Offen Einstellungen -> MCP-Server, dann auswählen Server hinzufügen. Sie können dort den lokalen stdio-Server hinzufügen oder bearbeiten config.toml unter Verwendung der folgenden Konfiguration. Speichern Sie den Server und wählen Sie ihn aus Neustart.
Starten Sie nach dem Hinzufügen von Kanera eine neue Konversation und bestätigen Sie, dass die Tools verfügbar sind.
Konfigurationsdatei (App, CLI und IDE-Erweiterung)
Codex speichert MCP-Server auf Benutzerebene in ~/.codex/config.toml. Fügen Sie ein hinzu [mcp_servers.kanera] Tabelle für einen lokalen stdio-Server, auf dem die ausgeführt wird 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.
[mcp_servers.kanera]
command = "npx"
args = ["-y", "@kanera/cli", "mcp"]
env = { KANERA_API_KEY = "kanera_live_...", KANERA_PUBLIC_API_URL = "https://api.kanera.app" }
Behalten Sie für den gehosteten HTTP-Server mit einem statischen API-Schlüssel den Schlüssel in einer Umgebungsvariablen, anstatt ihn in die Datei zu schreiben:
[mcp_servers.kanera]
url = "https://mcp.kanera.app/mcp"
bearer_token_env_var = "KANERA_API_KEY"
Set KANERA_API_KEY in der Umgebung, die Codex startet, und starten Sie dann die App, CLI oder IDE-Erweiterung neu.
Befehlszeile
Oder fügen Sie es über die Befehlszeile hinzu:
codex mcp add kanera \
--env KANERA_API_KEY=kanera_live_... \
--env KANERA_PUBLIC_API_URL=https://api.kanera.app \
-- npx -y @kanera/cli mcp
Kehren Sie in der Desktop-App zu zurück Einstellungen -> MCP-Server um die Verbindung zu überprüfen. Verwenden Sie in der IDE-Erweiterung das Zahnradmenü und wählen Sie aus MCP-Server.