Passer au contenu principal

Configurer OpenCode pour Kanera MCP

OpenCode se connecte à Kanera via le Protocole de contexte de modèle. Il prend en charge la découverte OAuth automatique et l'enregistrement dynamique des clients pour les serveurs MCP distants, donc aucun client ou clé API pré-enregistré n'est requis.

Ajoutez Kanera à votre configuration OpenCode :

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "kanera": {
      "type": "remote",
      "url": "https://mcp.kanera.app/mcp",
      "enabled": true
    }
  }
}

OpenCode démarre automatiquement OAuth lorsque Kanera a besoin d'une authentification pour la première fois. Vous pouvez également démarrer explicitement le flux du navigateur :

opencode mcp auth kanera

Connectez-vous à Kanera, vérifiez l'accès demandé et choisissez Autoriser l'accès. Courir opencode mcp list pour vérifier la connexion. Si la découverte ou l'authentification échoue, utilisez opencode mcp debug kanera pour inspecter le flux.

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

Installez la compétence Kanera​

La connexion MCP donne accès à OpenCode 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 ~/.config/opencode/skills/kanera/ pour une compétence personnelle disponible à travers les projets.
  • .agents/skills/kanera/ ou .opencode/skills/kanera/ dans un référentiel pour partager la compétence avec ce projet.

OpenCode répertorie la compétence à ses agents et charge ses instructions complètes le cas échéant. Si vous restreignez des outils ou des compétences via les autorisations OpenCode, assurez-vous que skill l'outil et le kanera_* Les outils MCP ne sont pas refusés.

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 OpenCode 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é. :::

Référencez une variable d'environnement au lieu de stocker la clé dans la configuration :

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "kanera": {
      "type": "remote",
      "url": "https://mcp.kanera.app/mcp",
      "oauth": false,
      "headers": {
        "Authorization": "Bearer {env: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.

Référence client​