Ga naar de hoofdinhoud

Codex instellen voor Kanera MCP

De ChatGPT-desktopapp, Codex CLI en Codex IDE-extensie maken verbinding met Kanera via de Modelcontextprotocol. Ze delen de MCP-configuratie voor dezelfde Codex-host, dus normaal gesproken hoeft u Kanera slechts één keer toe te voegen.

Open in de ChatGPT-desktopapp Plug-ins, zoek naar Kanera door Happen Software Limiteden installeer het. Verbind uw Kanera-account via OAuth wanneer daarom wordt gevraagd, start vervolgens een nieuwe Codex-chat en vraag deze om Kanera te gebruiken. De plug-in bundelt de MCP-verbinding en vaardigheden, dus er is geen afzonderlijke installatie van vaardigheden of handmatige serverregistratie nodig.

Voer in Codex CLI in /plugins om de plug-inbrowser te openen, installeert u Kanera vanaf een beschikbare marktplaats en start u een nieuwe sessie. Account-, werkruimtebeleid en geconfigureerde marktplaatsbronnen bepalen de beschikbaarheid.

De IDE-extensie ondersteunt geen plug-ins. Gebruik de handmatige verbinding en onderstaande zelfstandige vaardigheid voor de IDE, een zelfgehoste Kanera-implementatie of een client waarbij plug-ins niet beschikbaar zijn. Vermijd het registreren van een tweede gehoste server wanneer de plug-in al is verbonden.

Als de plug-in niet beschikbaar is: handmatige verbinding met OAuth​

Als Kanera ontbreekt op uw plug-inmarktplaats of als de installatie van plug-ins niet beschikbaar is, voeg dan de MCP-server rechtstreeks toe en verbind uw Kanera-account met OAuth. Het gehoste MCP-adres is https://mcp.kanera.app/mcp. Voor zelfhosting kopieert u het MCP-adres van uw implementatie uit Profielinstellingen -> API-sleutels in plaats daarvan. U hoeft geen API-sleutel aan te maken of op te slaan.

codex mcp add kanera --url https://mcp.kanera.app/mcp
codex mcp login kanera

Met de login-opdracht wordt Kanera in uw browser geopend. Log in, bekijk de gevraagde toegang en maak een keuze Toegang toestaan. Rennen codex mcp list om te verifiëren dat de server is geregistreerd, of gebruik /mcp in de Codex CLI om de verbinding te inspecteren.

Open in de ChatGPT-desktopapp Instellingen -> MCP-servers -> Server toevoegen. Open in de IDE-extensie het tandwielmenu en selecteer MCP-servers -> Server toevoegen. Kom binnen Kanera, kies Streambare HTTPen gebruik dezelfde URL. Opslaan en opnieuw opstarten wanneer daarom wordt gevraagd, en kies vervolgens Authenticeren wanneer Kanera aanmelden vereist.

U kunt de externe server ook rechtstreeks configureren ~/.codex/config.toml:

[mcp_servers.kanera]
url = "https://mcp.kanera.app/mcp"

Ren dan codex mcp login kanera. Zie Sluit een AI-agent aan voor bereiken en het loskoppelen van een agent.

Installeer de vaardigheid voor een handmatige verbinding​

Als je de plug-in hebt geïnstalleerd, is de gebundelde vaardigheid al beschikbaar. Voor een handmatige installatie geeft de MCP-verbinding Codex toegang tot de tools van Kanera. De Kanera-agentvaardigheid leert hem hoe hij die tools betrouwbaar kan selecteren: routeer exacte kaartsleutels zoals DEV-938 rechtstreeks naar Kanera, geef de voorkeur aan MCP boven browserautomatisering voor ondersteund werk, zet namen om in stabiele ID's, lees de livestatus voordat u werk rapporteert of wijzigt, gebruik idempotentiesleutels en handel problemen met toestemming of snelheidslimieten veilig af.

Installeer de vaardigheid globaal met het open Agent Skills-installatieprogramma:

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

Voor een handmatige installatie downloadt u het volledige kanera vaardighedenlijst, inclusief SKILL.md en agents/openai.yamlen plaats deze op een van deze locaties:

  • ~/.agents/skills/kanera/ voor een persoonlijke vaardigheid die beschikbaar is in projecten.
  • .agents/skills/kanera/ in een repository om de vaardigheid met dat project te delen.

Codex detecteert normaal gesproken automatisch vaardigheidsveranderingen. Als dit niet verschijnt, start Codex dan opnieuw op. Noemen $kanera expliciet in een prompt om het laden te forceren, of laat Codex het automatisch selecteren zodat Kanera werkt.

Gebruik /apps om de Kanera-app te koppelen, /plugins om te inspecteren of de Kanera-plug-in en de gebundelde vaardigheid beschikbaar zijn, en /mcp verbose om de gereedschapsaansluiting te bevestigen. Bijvoorbeeld:

$kanera Update DEV-938 with the investigation findings and agreed implementation plan.

Codex zou die kaart moeten doorlezen cards.get en pas de gevraagde wijziging door cards.update. Het zou de Kanera-webinterface alleen moeten openen voor een expliciet visuele taak of een beheerbewerking die MCP niet openbaar maakt.

Uitzondering: verbinden met een API-sleutel​

:::let op Gebruik OAuth wanneer u maar kunt Een API-sleutel is een langlevend geheim dat u zelf opslaat en roteert, en werk dat met een persoonlijke sleutel wordt gedaan, wordt geregistreerd als u, zonder de via <agent> etiket. Gebruik er alleen een als OAuth echt niet kan werken:

  • Uw Codex-versie kan de externe OAuth-stroom niet voltooien.
  • Je hebt een lokale stdio-server nodig en kunt de Kanera CLI. kanera auth login meldt zich aan met OAuth, en kanera mcp bedient stdio met die aanmelding, geen sleutel vereist.
  • De machine heeft geen browser voor aanmelding. Probeer autorisatie van het apparaat eerst als uw klant dit ondersteunt.

Wanneer u een sleutel gebruikt, maakt u deze aan Alleen-lezen tenzij de agent het werk moet veranderen en het in een omgevingsvariabele moet bewaren in plaats van in een vastgelegd bestand. :::

Vervangen kanera_live_... met een persoonlijke sleutel van Profielinstellingen -> API-sleutels of een werkruimtesleutel van Werkruimte-instellingen -> API, en instellen KANERA_PUBLIC_API_URL naar https://api.kanera.app. Voor een persoonlijke Codex-installatie is een persoonlijke sleutel meestal de juiste oplossing, omdat deze uw eigen boardtoegang tot alle werkruimten volgt.

Werkruimte API-instellingen waar een werkruimte API-sleutel kan worden gemaakt voor Kanera MCP.

ChatGPT desktop-app​

Openen Instellingen -> MCP-serversen selecteer vervolgens Server toevoegen. U kunt daar de lokale stdio-server toevoegen of bewerken config.toml met behulp van de onderstaande configuratie. Sla de server op en selecteer Opnieuw opstarten.

Nadat je Kanera hebt toegevoegd, start je een nieuw gesprek en bevestig je dat de tools beschikbaar zijn.

Configuratiebestand (app-, CLI- en IDE-extensie)​

Codex slaat MCP-servers op gebruikersniveau op ~/.codex/config.toml. Voeg een toe [mcp_servers.kanera] tabel voor een lokale stdio-server, waarop de Kanera CLI als server (knooppunt 22 of hoger). Als je al hebt gerend kanera auth login, je kunt het weglaten env; kanera mcp hergebruikt de opgeslagen referentie.

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

Voor de gehoste HTTP-server met een statische API-sleutel bewaart u de sleutel in een omgevingsvariabele in plaats van deze in het bestand te schrijven:

[mcp_servers.kanera]
url = "https://mcp.kanera.app/mcp"
bearer_token_env_var = "KANERA_API_KEY"

Instellen KANERA_API_KEY in de omgeving waarin Codex wordt gestart en start vervolgens de app, CLI of IDE-extensie opnieuw op.

Commandoregel​

Of voeg het toe vanaf de opdrachtregel:

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

Ga in de desktop-app terug naar Instellingen -> MCP-servers om de verbinding te controleren. Gebruik in de IDE-extensie het tandwielmenu en selecteer MCP-servers.

Klantreferentie​