Ga naar de hoofdinhoud

Stel GitHub Copilot in voor Kanera MCP

GitHub Copilot in VS Code maakt verbinding met Kanera via de Modelcontextprotocol. Deze handleiding behandelt de VS Code-desktoptoepassing; Copilot CLI en de codeeragent GitHub.com gebruiken verschillende MCP-configuratielocaties.

U hebt toegang nodig tot GitHub Copilot en VS Code 1.99 of hoger. Als Copilot afkomstig is van een Business- of Enterprise-organisatie, moet de beheerder de MCP-servers in Copilot beleid.

Voor een externe verbinding voegt u het MCP-adres van Kanera toe en authenticeert u in uw browser. U hoeft geen API-sleutel aan te maken of op te slaan.

  1. Uitvoering MCP: Server toevoegen uit het opdrachtenpalet, kies HTTP, voer in https://mcp.kanera.app/mcp, noem het maar kaneraen sla het op in uw gebruikersprofiel. Of rennen MCP: Open Gebruikersconfiguratie en voeg Kanera handmatig toe, of maak een .vscode/mcp.json voor de huidige werkruimte.

  2. Voor handmatige configuratie voegt u Kanera toe als een externe HTTP-server:

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

  3. Start de server en bevestig dat u de configuratie vertrouwt. VS Code detecteert de OAuth-vereiste en opent de browserauthenticatiestroom; als de inline-acties worden weergegeven Aut, selecteer het.

  4. Meld u aan bij Kanera, bekijk de gevraagde toegang en kies Toegang toestaan.

  5. Uitvoering MCP: lijstservers om te bevestigen dat Kanera is verbonden. Open Copilot Chat in Agent modus en bevestig dat de Kanera-gereedschappen verschijnen in de gereedschapskiezer.

Zie Sluit een AI-agent aan voor bereiken en het loskoppelen van een agent.

Installeer de Kanera-vaardigheid​

De MCP-verbinding geeft Copilot toegang tot de tools van Kanera. De optionele Kanera-agentvaardigheid leert hem hoe hij deze tools op betrouwbare wijze kan gebruiken: namen omzetten in stabiele ID's, de livestatus lezen voordat werk wordt gerapporteerd of gewijzigd, voltooid werk onderscheiden van nieuw gemaakt werk, idempotentiesleutels gebruiken en veilig omgaan met toestemmings- of snelheidslimietfouten.

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 vaardighedenmap en plaats deze op een van deze locaties:

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

Gebruik in Copilot Chat /skills om te bevestigen dat de vaardigheid beschikbaar is. Copilot kan het automatisch laden wanneer een verzoek betrekking heeft op Kanera, of u kunt het kanera vaardigheid expliciet.

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 VS Code-installatie 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 VS Code-configuratie is een persoonlijke sleutel meestal de juiste keuze, omdat deze uw eigen boardtoegang tot alle werkruimten volgt.

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

VS Code desktop-app​

GitHub Copilot leest MCP-servers uit een .vscode/mcp.json bestand in uw werkruimte. Voor een persoonlijke configuratie die beschikbaar is voor alle projecten, voer run MCP: Open Gebruikersconfiguratie vanuit het opdrachtenpalet en bewerk de gebruiker mcp.json bestand.

Voor een lokale stdio-server voert u 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.

{
  "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"
      }
    }
  }
}

Voor een extern HTTP-eindpunt met een statische API-sleutel:

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

Gebruik de hulpmiddelen​

Open de Copilot Chat-weergave, schakel over naar Agent modus en de Kanera-tools verschijnen in de toolskiezer zodra de server start.

Voer geen API-sleutel in .vscode/mcp.json. Plaats persoonlijke configuratie in het bestand op gebruikersniveau, of gebruik de ondersteuning voor invoervariabelen van VS Code, zodat het geheim wordt opgevraagd in plaats van opgeslagen in de repository.

Referenties van klanten​