Hopp til hovedinnholdet

Sett opp GitHub Copilot for Kanera MCP

GitHub Copilot i VS Code kobler til Kanera gjennom Modellkontekstprotokoll. Denne veiledningen dekker VS Code desktop-applikasjonen; Copilot CLI og GitHub.com-kodingsagenten bruker forskjellige MCP-konfigurasjonssteder.

Du trenger tilgang til GitHub Copilot og VS Code 1.99 eller nyere. Hvis Copilot kommer fra en bedrift eller bedrift organisasjon, må administratoren aktivere MCP-servere i Copilot politikk.

For en ekstern tilkobling, legg til Kanera's MCP adresse og autentisere i nettleseren din. Du trenger ikke å opprette eller lagre en API nøkkel.

  1. Kjøring MCP: Legg til tjener fra kommandopaletten, velg HTTP, skriv inn https://mcp.kanera.app/mcp, navngi den kanera, og lagre den i brukerprofilen. Alternativt, kjøre MCP: Åpne brukerkonfigurasjon og legge til Kanera manuelt, eller opprette .vscode/mcp.json for det aktuelle arbeidsområdet.

  2. For manuell konfigurasjon, legg til Kanera som en ekstern HTTP-server:

    {
      "servers": {
        "kanera": {
          "type": "http",
          "url": "https://mcp.kanera.app/mcp"
        }
      }
    }

  3. Start serveren og bekreft at du stoler på konfigurasjonen. VS Code oppdager OAuth-kravet og åpner nettleserautentiseringsflyten. Hvis de innebygde handlingene vises Auth, velg den.

  4. Logg på Kanera, se den forespurte tilgangen, og velg Tillat tilgang.

  5. Kjøring MCP: Listeservere for å bekrefte at Kanera er tilkoblet. Åpne Agent modus og bekrefte at Kanera verktøy vises i verktøy plukkeren.

Se Koble til en AI-agent for å koble fra en agent.

Installere Kanera ferdighet​

Den MCP tilkobling gir Copilot tilgang til Kanera's verktøy. Den valgfrie Kanera agent ferdigheter lærer det hvordan du bruker disse verktøyene på en pålitelig måte: løse navn til stabile ID-er, lese live-tilstand før rapportering eller endring av arbeid, skille fullført arbeid fra nyopprettet arbeid, bruke idempotensnøkler og håndtere tillatelse 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 ~/.copilot/skills/kanera/ for en personlig ferdighet tilgjengelig på tvers av prosjekter.
  • .agents/skills/kanera/ eller .github/skills/kanera/ i et depot for å dele ferdighetene med det prosjektet.

I Copilot Chat, bruk /skills for å bekrefte at ferdighetene er tilgjengelige. Copilot kan laste dem inn automatisk når en forespørsel involverer Kanera, eller du kan påberope kanera dyktighet eksplisitt.

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:

  • Oppsettet VS-kode 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 VS-kodeoppsett 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.

VS Code skrivebordsapp​

GitHub Copilot leser MCP-servere fra en .vscode/mcp.json Hvis du vil ha en personlig konfigurasjon som er tilgjengelig på tvers av prosjekter, kan du kjøre MCP: Åpne brukerkonfigurasjon fra Kommandopaletten og rediger brukeren mcp.json fil.

For en lokal stdio-server, kjør 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.

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

For et eksternt HTTP-endepunkt med en statisk API-nøkkel:

{
  "servers": {
    "kanera": {
      "type": "http",
      "url": "https://mcp.kanera.app/mcp",
      "headers": {
        "Authorization": "Bearer kanera_live_..."
      }
    }
  }
}

Bruk verktøyene​

Åpne chat-visningen for andrepilot, og bytt til Agent modus, og Kanera-verktøyene vises i verktøyvelgeren når serveren starter.

Ikke bruk en API-nøkkel i .vscode/mcp.json. Sett personlig konfigurasjon i brukernivåfilen, eller bruk VS Codes inndatavariable støtte, slik at hemmeligheten blir forespurt i stedet for lagret i depotet.

Kundereferanser​