Passer au contenu principal

Mettre en place Claude pour Kanera MCP

Claude sur le Web, Claude Desktop et Claude Code peuvent se connecter à Kanera via le Protocole de contexte de modèle.

Claude et Claude Desktop : connectez-vous avec OAuth​

Kanera est un connecteur Claude publié. Rechercher Kanéra sous Personnaliser -> Connecteurs et sélectionnez Se connecter. Claude ouvre un écran de connexion et de consentement dans le navigateur ; vous ne créez ni ne collez de clé API. Il fonctionne sur tous les forfaits Kanera hébergés, y compris Free.

Si le connecteur publié n'est pas visible pour le compte ou l'espace de travail actuel, ajoutez le même point de terminaison de production en tant que connecteur personnalisé :

  1. Ouvert Personnaliser -> Connecteurs.

  2. Sélectionnez + -> Ajouter un connecteur personnalisé.

  3. Entrez l'adresse MCP de Kanera :

    https://mcp.kanera.app/mcp

  4. Sélectionnez Ajouter, alors Se connecter.

Pour une organisation d'équipe ou d'entreprise qui restreint les connecteurs, un propriétaire ou un propriétaire principal devra peut-être activer Kanera sous Paramètres de l'organisation -> Connecteurs avant que les membres puissent le connecter.

Claude ouvre un onglet Kanera. Connectez-vous, examinez ce que l'agent peut faire et choisissez Autoriser l'accès. Activez Kanera pour une conversation depuis le + -> Connecteurs menu à côté du compositeur.

Gérer ou déconnecter l'agent ultérieurement de Paramètres du profil -> Clés API. Voir Connecter un agent IA pour plus de détails. Si OAuth n'est pas une option, consultez l'exception de la clé API ci-dessous.

Claude Code : connectez-vous avec OAuth​

Lorsque Claude Code est connecté avec le même compte Claude, exécutez d'abord claude mcp list. Si le connecteur Kanera publié est déjà présent, démarrez Claude Code, saisissez /mcp, et connectez-le ou authentifiez-le ici. N'ajoutez pas de serveur en double.

Si Kanera n'est pas présent, ajoutez le serveur hébergé pour votre utilisateur afin qu'il soit disponible dans tous les projets :

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

Démarrez Claude Code et entrez /mcp. Sélectionnez Kanera et terminez le flux d'authentification du navigateur. Courir claude mcp list pour le confirmer, rapporte Connecté.

Solution de repli uniquement Shell​

Si un agent peut exécuter des commandes shell mais ne peut pas utiliser MCP, installez la CLI Kanera plutôt que d'automatiser l'interface Web :

npx -y @kanera/cli commands          # inspect it without a global install
npm install --global @kanera/cli     # persistent command; requires Node 22+
kanera auth login
kanera setup claude --global
kanera whoami --json

La CLI expose la même couche d’outils Kanera. kanera auth login se connecte via votre navigateur avec OAuth, de la même manière que le connecteur, il n'y a donc pas de clé à créer ; utiliser --with-api-key pour un agent sans surveillance. Préférez le connecteur publié lorsqu'il est disponible, car il ne nécessite aucune installation.

Installez la compétence Kanera​

La connexion MCP donne à Claude 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 actuel avant de signaler ou de modifier le travail, à utiliser des clés d'idempotence et à gérer les échecs en toute sécurité.

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

Redémarrez Claude si la compétence n'apparaît pas. Claude peut le charger automatiquement pour un travail pertinent, ou vous pouvez l'invoquer 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 Claude ne peut pas utiliser le connecteur publié ou un connecteur personnalisé avec OAuth.
  • 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. Pour une configuration Claude personnelle, une clé personnelle est généralement la solution idéale car elle suit votre propre accès au tableau dans tous 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.

Claude Code​

Pour le point de terminaison HTTP hébergé avec une clé statique :

claude mcp add --transport http kanera --scope user https://mcp.kanera.app/mcp \
  --header "Authorization: Bearer kanera_live_..."

Pour un serveur stdio local, exécutez le Kanera CLI en tant que serveur :

claude mcp add kanera --scope user \
  --env KANERA_API_KEY=kanera_live_... \
  --env KANERA_PUBLIC_API_URL=https://api.kanera.app \
  -- npx -y @kanera/cli mcp

Si tu as déjà couru kanera auth login, laisse tomber les deux --env drapeaux; kanera mcp réutilise les informations d'identification stockées. Courir claude mcp list pour confirmer que le serveur est connecté.

Bureau Claude​

Ouvert Paramètres -> Développeur -> Modifier la configuration, qui ouvre claude_desktop_config.json, et ajoutez le serveur sous mcpServers:

{
  "mcpServers": {
    "kanera": {
      "command": "npx",
      "args": ["-y", "@kanera/cli", "mcp"],
      "env": {
        "KANERA_API_KEY": "kanera_live_...",
        "KANERA_PUBLIC_API_URL": "https://api.kanera.app"
      }
    }
  }
}

Redémarrez Claude Desktop après avoir enregistré, puis ouvrez une nouvelle conversation et confirmez que les outils Kanera sont disponibles. Cette configuration exécute le serveur localement via stdio et nécessite Node 22 ou version ultérieure.

Si vous avez déjà configuré Kanera dans Claude Desktop et que vous installez ultérieurement Claude Code, Claude Code peut importer la configuration du bureau avec :

claude mcp add-from-claude-desktop

Cette commande d'importation est disponible sur macOS et le sous-système Windows pour Linux (WSL).

Références clients​