Hopp til hovedinnholdet

Sett opp Codex for Kanera MCP

ChatGPT-skrivebordsappen, Codex CLI og Codex IDE-utvidelsen kobler til Kanera gjennom Modellkontekstprotokoll. De deler MCP-konfigurasjon for samme Codex-vert, så du trenger normalt bare å legge til Kanera en gang.

I ChatGPT-skrivebordsappen åpner du Programtillegg, søk etter Kanera av Happen Software Limited, og installer det. Koble Kanera-kontoen din via OAuth når du blir bedt om det, start deretter en ny Codex-chat og be den om å bruke Kanera. Plugin-modulen pakker MCP-tilkoblingen og ferdighetene, slik at ingen separat ferdighetsinstallasjon eller manuell serverregistrering er nødvendig.

I Codex CLI, skriv inn /plugins for å åpne plugin-nettleseren, installere Kanera fra en tilgjengelig markedsplass og starte en ny økt. Konto, arbeidsområdepolicyer og konfigurerte markedsplasskilder bestemmer tilgjengeligheten.

IDE-utvidelsen støtter ikke plugins. Bruk manuell tilkobling og frittstående ferdigheter nedenfor for IDE, en selvdrevet Kanera-distribusjon eller en klient der plugins ikke er tilgjengelige. Unngå å registrere en annen vertsserver når plugin-modulen allerede er tilkoblet.

Hvis programtillegget ikke er tilgjengelig: manuell tilkobling med OAuth​

Hvis Kanera mangler fra plugin-markedet eller plugin-installasjonen er utilgjengelig, legg til MCP-serveren direkte og koble Kanera-kontoen din til OAuth. Den vertsbaserte MCP-adressen er https://mcp.kanera.app/mcp. For selvhosting kopierer du distribusjonens MCP-adresse fra Profilinnstillinger -> API-nøkler i stedet. Du trenger ikke å opprette eller lagre en API-nøkkel.

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

Logg inn-kommandoen åpner Kanera i nettleseren din. Logg inn, se gjennom ønsket tilgang, og velg Tillat tilgang. Løp codex mcp list for å verifisere at serveren er registrert, eller bruke /mcp i Codex CLI for å inspisere tilkoblingen.

I ChatGPT-skrivebordsappen åpner du Innstillinger -> MCP-servere -> Legg til server. I IDE-utvidelsen åpner du girmenyen og velger MCP-servere -> Legg til server. Enter Kanera, velg Strømbar HTTP, og bruk samme URL. Lagre og start på nytt når du blir bedt om det, og velg deretter Autentiser når Kanera krever pålogging.

Du kan også konfigurere den eksterne serveren direkte i ~/.codex/config.toml:

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

Løp deretter codex mcp login kanera. Se Koble til en AI-agent for å koble fra en agent.

Installere ferdigheten for en manuell tilkobling​

Hvis du har installert programtillegget, er den medfølgende ferdigheten allerede tilgjengelig. Ved manuelt oppsett gir MCP-tilkoblingen Codex tilgang til verktøyene i Kanera. Den Kanera agent ferdigheter lærer det hvordan du velger disse verktøyene på en pålitelig måte: rute nøyaktige kortnøkler som DEV-938 direkte til Kanera, foretrekker MCP over nettleserautomatisering for støttet arbeid, løser navn til stabile ID-er, leser live-tilstand før du rapporterer eller endrer arbeid, bruker idempotensnøkler og håndterer tillatelses- eller hastighetsgrensefeil trygt.

Installer ferdigheten globalt med den åpne Agent Skills-installatøren:

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

For en manuell installasjon, last ned hele kanera ferdighetskatalog, inkludert SKILL.md og agents/openai.yamlog plassere den på et av disse stedene:

  • ~/.agents/skills/kanera/ for en personlig ferdighet tilgjengelig på tvers av prosjekter.
  • .agents/skills/kanera/ i et depot for å dele ferdighetene med det prosjektet.

Codex oppdager vanligvis ferdighetsendringer automatisk. Hvis det ikke vises, start Codex på nytt. Nevn $kanera eksplisitt i en melding for å tvinge den til å laste, eller la Codex velge den automatisk for Kanera-arbeid.

Bruk /apps for å legge ved Kanera-appen, /plugins for å undersøke om Kanera-plugin og medfølgende ferdigheter er tilgjengelige, og /mcp verbose for å bekrefte verktøytilkoblingen. For eksempel:

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

Codex bør lese det kortet gjennom cards.get og gjennomføre den ønskede endringen gjennom cards.update. Det bør åpne Kanera webgrensesnitt bare for en eksplisitt visuell oppgave eller en administrasjonsoperasjon som MCP ikke utsetter.

Unntak: koble til med en API-nøkkel​

:::forsiktighet Bruk OAuth når du kan En API-nøkkel er en langlivet hemmelighet som du lagrer og roterer deg selv, og arbeid gjort med en personlig nøkkel registreres som du, uten cialis <sekretær> etikett. Bruk bare en når OAuth virkelig ikke kan fungere:

  • Codex-versjonen kan ikke fullføre den eksterne OAuth-flyten.
  • Du trenger en lokal standardserver og kan ikke bruke Kanera CLI. kanera auth login Innlegg med OAuth kanera mcp tjener stdio med den påloggingen, ingen nøkkel kreves.
  • Maskinen har ingen nettleser for pålogging. Prøv enhetsautorisasjon Først og fremst hvis kunden støtter det.

Når du bruker en nøkkel, oppretter du den Skrivebeskyttet med mindre agenten må endre arbeidet, og holde det i et miljø variabel i stedet for en engasjert fil.

Erstatt kanera_live_... med en personlig nøkkel fra Profilinnstillinger -> API-nøkler eller en arbeidsområdenøkkel fra Arbeidsområdeinnstillinger -> APIog sett KANERA_PUBLIC_API_URL til https://api.kanera.app. For et personlig Codex-oppsett er en personlig nøkkel vanligvis riktig passform fordi den følger din egen bretttilgang på tvers av arbeidsområder.

Arbeidsområde API-innstillinger der en arbeidsområde API-nøkkel kan opprettes for Kanera MCP.

ChatGPT skrivebordsapp​

Åpne Innstillinger -> MCP-servere, og velg deretter Legg til tjener. Du kan legge til den lokale stdio-serveren der, eller redigere config.toml ved å bruke konfigurasjonen nedenfor. Lagre serveren og velg Start på nytt.

Etter å ha lagt til Kanera, start en ny samtale og bekreft at verktøyene er tilgjengelige.

Konfigurasjonsfil (app, CLI og IDE-utvidelse)​

Codex lagrer MCP-servere på brukernivå i ~/.codex/config.toml. Legg til en [mcp_servers.kanera] tabell for en lokal stdio-server, som kjører Kanera CLI som serveren (Node 22 eller senere). Hvis du allerede har kjørt kanera auth loginDu kan utelate env; kanera mcp Gjenbruker lagret legitimasjon.

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

For verts HTTP-serveren med en statisk API-nøkkel, holde nøkkelen i et miljø variabel i stedet for å skrive den inn i filen:

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

Sett KANERA_API_KEY i miljøet som starter Codex, og start deretter appen, CLI eller IDE-utvidelsen på nytt.

Kommandolinje​

Eller legg til fra kommandolinjen:

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

I skrivebordsappen går du tilbake til Innstillinger -> MCP-servere I IDE-utvidelsen bruker du girmenyen og velger MCP-tjenere.

Kundereferanse​