Passer au contenu principal

Configurer Gemini CLI pour Kanera MCP

Gemini CLI se connecte à Kanera via le Protocole de contexte de modèle. Il prend en charge les serveurs HTTP distants, la découverte automatique OAuth, l'enregistrement dynamique des clients et l'actualisation des jetons.

Ajoutez Kanera en tant que serveur HTTP distant :

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

Démarrez Gemini CLI, puis authentifiez-vous à partir de son invite interactive :

/mcp auth kanera

Gemini CLI ouvre Kanera dans votre navigateur. Connectez-vous, vérifiez l'accès demandé et choisissez Autoriser l'accès. Courir gemini mcp list depuis votre shell pour vérifier que le serveur est connecté, ou utilisez /mcp dans Gemini CLI pour l’inspecter.

Vous pouvez également configurer Kanera directement dans les CLI Gemini settings.json:

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

Interactive OAuth nécessite un navigateur local et un rappel localhost. Dans un environnement sans tête ou distant qui ne peut pas effectuer ce rappel, utilisez autorisation de l'appareil si votre client prend en charge l'octroi d'appareil, ou revient à une clé API. Voir Connecter un agent IA pour les étendues et la déconnexion d’un agent.

Installez la compétence Kanera​

La connexion MCP donne à Gemini CLI un accès aux outils de Kanera. L'optionnel Compétence d'agent Kanera lui apprend à résoudre les noms en identifiants stables, à lire l'état actif avant de signaler ou de modifier un travail, à distinguer le travail terminé de l'activité de création, à utiliser des clés d'idempotence et à gérer les échecs d'autorisation ou de limite de débit en toute sécurité.

Installez la compétence globalement avec le programme d'installation ouvert des compétences d'agent :

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

Pour une installation manuelle, téléchargez le fichier complet kanera répertoire de compétences et placez-le dans l'un de ces emplacements :

  • ~/.agents/skills/kanera/ ou ~/.gemini/skills/kanera/ pour une compétence personnelle disponible à travers les projets.
  • .agents/skills/kanera/ ou .gemini/skills/kanera/ dans un référentiel pour partager la compétence avec ce projet.

Exécution /skills list dans Gemini CLI pour vérifier que la compétence est disponible, et /skills reload après l'avoir changé. Gemini CLI demande une confirmation lorsqu'il active une compétence.

Exception : connectez-vous avec une clé API​

Utilisez OAuth chaque fois que vous le pouvez. Une clé API est un secret de longue durée que vous stockez et faites pivoter vous-même, et le travail effectué avec une clé personnelle est enregistré sous votre nom, sans le via <agent> étiquette. Utilisez-en un uniquement lorsque OAuth ne peut vraiment pas fonctionner :
  • Votre environnement Gemini CLI ne peut pas effectuer le rappel OAuth localhost.
  • Vous avez besoin d'un serveur stdio local et vous ne pouvez pas utiliser le Kanera CLI. kanera auth login se connecte avec OAuth, et kanera mcp sert stdio avec cette connexion, aucune clé requise.
  • La machine n'a pas de navigateur pour la connexion. Essayez autorisation de l'appareil d'abord si votre client le prend en charge.

Lorsque vous utilisez une clé, créez-la Lecture seule à moins que l'agent ne doive modifier son travail et le conserver dans une variable d'environnement plutôt que dans un fichier validé. :::

Ajouter un en-tête d'autorisation à settings.json qui lit la clé de votre environnement :

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

Créez une clé personnelle dans Paramètres du profil -> Clés API ou un espace de travail, saisissez Paramètres de l'espace de travail -> API. Évitez de mettre la clé directement dans settings.json.

Référence client​