Passer au contenu principal

Configurer le curseur pour Kanera MCP

Le curseur se connecte à Kanera via le Protocole de contexte de modèle. Cursor prend en charge les serveurs HTTP Streamable distants avec OAuth, afin que vous puissiez vous connecter via un navigateur sans créer ni stocker de clé API.

Installation en un clic​

Une fois Cursor installé, ouvrez ce lien pour ajouter Kanera à Cursor en une seule étape :

Ajouter Kanera au curseur

Le curseur montre le serveur qu'il est sur le point d'ajouter (https://mcp.kanera.app/mcp) et vous demande de le confirmer. Terminez ensuite la connexion au navigateur décrite ci-dessous. Si le lien n'ouvre pas le curseur ou si vous hébergez vous-même Kanera, ajoutez plutôt la configuration manuellement. Le Générateur de configuration MCP crée également le lien pour une adresse auto-hébergée.

Configuration manuelle​

Kanera affiche cette configuration, avec votre adresse MCP renseignée, sous Paramètres du profil -> Clés API -> Ou configurez-le à la main -> Curseur.

Ajoutez Kanera à votre configuration globale Cursor MCP à ~/.cursor/mcp.json, ou à .cursor/mcp.json dans un projet alors que la connexion ne doit être disponible que là :

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

Le curseur détecte que Kanera nécessite OAuth et vous demande de vous authentifier. Dans Cursor Agent, vous pouvez démarrer explicitement le flux du navigateur :

cursor-agent mcp login kanera

Connectez-vous à Kanera, vérifiez l'accès demandé et choisissez Autoriser l'accès. Vérifiez ensuite la connexion et les outils disponibles :

cursor-agent mcp list
cursor-agent mcp list-tools kanera

Dans l'éditeur de curseur, ouvrez Paramètres -> Outils et MCP pour inspecter le serveur et ses 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 à Cursor l'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 ~/.cursor/skills/kanera/ pour une compétence personnelle disponible à travers les projets.
  • .agents/skills/kanera/ ou .cursor/skills/kanera/ dans un référentiel pour partager la compétence avec ce projet.

Redémarrez le curseur si la compétence n'apparaît pas. Le curseur peut le charger automatiquement pour les demandes pertinentes, ou vous pouvez invoquer /kanera 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 version de Cursor 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é. :::

Lisez la clé à partir d'une variable d'environnement plutôt que de la valider dans une configuration de projet :

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

Ensemble KANERA_API_KEY dans l'environnement qui lance Cursor. 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.

Référence client​