Passer au contenu principal

Configurer GitHub Copilot pour Kanera MCP

GitHub Copilot dans VS Code se connecte à Kanera via le Protocole de contexte de modèle. Ce guide couvre l'application de bureau VS Code ; Copilot CLI et l'agent de codage GitHub.com utilisent des emplacements de configuration MCP différents.

Vous devez accéder à GitHub Copilot et VS Code 1.99 ou version ultérieure. Si Copilot provient d'une organisation Business ou Enterprise, son administrateur doit activer le Serveurs MCP dans Copilot politique.

Pour une connexion à distance, ajoutez l'adresse MCP de Kanera et authentifiez-vous dans votre navigateur. Vous n'avez pas besoin de créer ou de stocker une clé API.

  1. Exécution MCP : ajouter un serveur dans la palette de commandes, choisissez HTTP, entrez https://mcp.kanera.app/mcp, nomme-le kaneraet enregistrez-le dans votre profil utilisateur. Alternativement, exécutez MCP : ouvrir la configuration utilisateur et ajoutez Kanera manuellement, ou créez .vscode/mcp.json pour l'espace de travail actuel.

  2. Pour une configuration manuelle, ajoutez Kanera en tant que serveur HTTP distant :

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

  3. Démarrez le serveur et confirmez que vous faites confiance à sa configuration. VS Code détecte l'exigence OAuth et ouvre le flux d'authentification du navigateur ; si les actions en ligne montrent Authentification, sélectionnez-le.

  4. Connectez-vous à Kanera, vérifiez l'accès demandé et choisissez Autoriser l'accès.

  5. Exécution MCP : lister les serveurs pour confirmer que Kanera est connecté. Ouvrez le chat copilote dans Agent et confirmez que les outils Kanera apparaissent dans le sélecteur d'outils.

Voir Connecter un agent IA pour les étendues et la déconnexion d’un agent.

Installez la compétence Kanera​

La connexion MCP donne à Copilot un accès aux outils de Kanera. L'optionnel Compétence d'agent Kanera lui apprend à utiliser ces outils de manière fiable : résoudre les noms en identifiants stables, lire l'état actuel avant de signaler ou de modifier un travail, distinguer le travail terminé du travail nouvellement créé, 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 ~/.copilot/skills/kanera/ pour une compétence personnelle disponible à travers les projets.
  • .agents/skills/kanera/ ou .github/skills/kanera/ dans un référentiel pour partager la compétence avec ce projet.

Dans Copilot Chat, utilisez /skills pour confirmer que la compétence est disponible. Copilot peut le charger automatiquement lorsqu'une requête implique Kanera, ou vous pouvez invoquer le kanera compétence explicitement.

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 configuration VS Code ne peut pas terminer le flux OAuth distant.
  • 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é. :::

Remplacer kanera_live_... avec une clé personnelle de Paramètres du profil -> Clés API ou une clé d'espace de travail de Paramètres de l'espace de travail -> API, et définissez KANERA_PUBLIC_API_URL à https://api.kanera.app. Pour une configuration VS Code personnelle, une clé personnelle est généralement la bonne solution car elle suit votre propre accès au tableau dans les espaces de travail.

Paramètres de l'API de l'espace de travail dans lesquels une clé API de l'espace de travail peut être créée pour Kanera MCP.

Application de bureau VS Code​

GitHub Copilot lit les serveurs MCP à partir d'un .vscode/mcp.json fichier dans votre espace de travail. Pour une configuration personnelle disponible dans tous les projets, exécutez MCP : ouvrir la configuration utilisateur à partir de la palette de commandes et modifiez l'utilisateur mcp.json fichier.

Pour un serveur stdio local, exécutez le Kanera CLI en tant que serveur (nœud 22 ou version ultérieure). Si tu as déjà couru kanera auth login, vous pouvez omettre env; kanera mcp réutilise les informations d'identification stockées.

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

Pour un point de terminaison HTTP distant avec une clé API statique :

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

Utiliser les outils​

Ouvrez la vue Copilot Chat, passez à Agent mode, et les outils Kanera apparaissent dans le sélecteur d'outils une fois le serveur démarré.

Ne validez pas de clé API dans .vscode/mcp.json. Placez la configuration personnelle dans le fichier au niveau de l'utilisateur ou utilisez la prise en charge des variables d'entrée de VS Code pour que le secret soit demandé au lieu d'être stocké dans le référentiel.

Références clients​