Hopp til hovedinnholdet

Konfigurer Gemini CLI for Kanera MCP

Gemini CLI kobles til Kanera gjennom Modellkontekstprotokoll. Den støtter eksterne HTTP-servere, automatisk OAuth-oppdagelse, dynamisk klientregistrering og tokenoppdatering.

Legg til Kanera som en ekstern HTTP-server:

gemini mcp add --scope user --transport http kanera https://mcp.kanera.app/mcp

Start Gemini CLI, og autentiser deretter fra den interaktive prompten:

/mcp auth kanera

Gemini CLI åpner Kanera i nettleseren din. Logg inn, se gjennom den forespurte tilgangen, og velg Tillat tilgang. Løp gemini mcp list fra skallet for å bekrefte at serveren er tilkoblet, eller /mcp I tillegg til Gemini CLI, kan du se på den.

Du kan også konfigurere Kanera direkte i Gemini CLI settings.json:

{
  "mcpServers": {
    "kanera": {
      "httpUrl": "https://mcp.kanera.app/mcp"
    }
  }
}

Interaktiv OAuth krever en lokal nettleser og en localhost tilbakeringing. I et hodeløst eller eksternt miljø som ikke kan fullføre tilbakeringingen, bruk enhetsautorisasjon hvis klienten støtter enhetstilskuddet, eller faller tilbake til en API-nøkkel. Se Koble til en AI-agent for å koble fra en agent.

Installere Kanera ferdighet​

Den MCP Forbindelsen gir Gemini CLI tilgang til Kanera's verktøy. Den valgfrie Kanera agent ferdigheter lærer den å løse navn til stabile ID-er, lese live-tilstand før rapportering eller endring av arbeid, skille fullført arbeid fra opprettelsesaktivitet, bruke idempotensnøkler og håndtere 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 og plasser den på et av disse stedene:

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

Kjøring /skills list inne Gemini CLI for å verifisere ferdighetene er tilgjengelige, og /skills reload etter å ha endret det. Gemini CLI ber om bekreftelse når den aktiverer en ferdighet.

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:

  • Gemini CLI-miljøet kan ikke fullføre localhost OAuth-tilbakekallet.
  • 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.

Legge til en autorisasjon overskrift til settings.json som leser nøkkelen fra miljøet ditt:

{
  "mcpServers": {
    "kanera": {
      "httpUrl": "https://mcp.kanera.app/mcp",
      "headers": {
        "Authorization": "Bearer $KANERA_API_KEY"
      }
    }
  }
}

Opprett en personlig nøkkel i Profilinnstillinger -> API-nøkler eller en arbeidsområdenøkkel i Arbeidsområdeinnstillinger -> API. Unngå å sette nøkkelen direkte i settings.json.

Kundereferanse​