Ga naar de hoofdinhoud

Stel Gemini CLI in voor Kanera MCP

Gemini CLI maakt verbinding met Kanera via de Modelcontextprotocol. Het ondersteunt externe HTTP-servers, automatische OAuth-detectie, dynamische clientregistratie en tokenvernieuwing.

Voeg Kanera toe als een externe HTTP-server:

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

Start Gemini CLI en authenticeer vervolgens via de interactieve prompt:

/mcp auth kanera

Gemini CLI opent Kanera in uw browser. Log in, bekijk de gevraagde toegang en maak een keuze Toegang toestaan. Rennen gemini mcp list vanuit uw shell om te verifiëren dat de server is verbonden, of gebruik /mcp binnen Gemini CLI om het te inspecteren.

U kunt Kanera ook rechtstreeks in Gemini CLI's configureren settings.json:

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

Interactieve OAuth vereist een lokale browser en een localhost-callback. In een headless of externe omgeving die het terugbellen niet kan voltooien, gebruikt u autorisatie van het apparaat als uw klant de apparaatsubsidie ondersteunt, of hierop terugvalt een API-sleutel. Zie Sluit een AI-agent aan voor bereiken en het loskoppelen van een agent.

Installeer de Kanera-vaardigheid​

De MCP-verbinding geeft Gemini CLI toegang tot de tools van Kanera. De optionele Kanera-agentvaardigheid leert het om namen om te zetten in stabiele ID's, de live-status te lezen voordat werk wordt gerapporteerd of gewijzigd, voltooid werk te onderscheiden van creatie-activiteit, idempotentiesleutels te gebruiken en veilig om te gaan 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 ~/.gemini/skills/kanera/ voor een persoonlijke vaardigheid die beschikbaar is in projecten.
  • .agents/skills/kanera/ of .gemini/skills/kanera/ in een repository om de vaardigheid met dat project te delen.

Uitvoering /skills list in Gemini CLI om te verifiëren dat de vaardigheid beschikbaar is, en /skills reload nadat u deze hebt gewijzigd. Gemini CLI vraagt ​​om bevestiging wanneer een vaardigheid wordt geactiveerd.

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 Gemini CLI-omgeving kan de localhost OAuth-callback 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. :::

Voeg een autorisatieheader toe aan settings.json die de sleutel uit uw omgeving leest:

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

Maak een persoonlijke sleutel aan Profielinstellingen -> API-sleutels of een werkruimte die wordt ingetoetst Werkruimte-instellingen -> API. Vermijd dat u de sleutel er rechtstreeks insteekt settings.json.

Klantreferentie​