Passer au contenu principal

Configurer le Codex pour Kanera MCP

L'application de bureau ChatGPT, la CLI Codex et l'extension Codex IDE se connectent à Kanera via le Protocole de contexte de modèle. Ils partagent la configuration MCP pour le même hôte Codex, vous n'avez donc normalement besoin d'ajouter Kanera qu'une seule fois.

Dans l'application de bureau ChatGPT, ouvrez Plugins, recherchez Kanéra par Happen Software Limitée, et installez-le. Connectez votre compte Kanera via OAuth lorsque vous y êtes invité, puis démarrez une nouvelle discussion Codex et demandez-lui d'utiliser Kanera. Le plugin regroupe la connexion et la compétence MCP, donc aucune installation de compétence distincte ni enregistrement manuel du serveur n'est nécessaire.

Dans Codex CLI, entrez /plugins pour ouvrir le navigateur de plugins, installez Kanera à partir d'un marché disponible et démarrez une nouvelle session. Les politiques de compte, d’espace de travail et les sources de place de marché configurées déterminent la disponibilité.

L'extension IDE ne prend pas en charge les plugins. Utilisez le connexion manuelle et compétence autonome ci-dessous pour l'IDE, un déploiement Kanera auto-hébergé ou un client sur lequel les plugins ne sont pas disponibles. Évitez d'enregistrer un deuxième serveur hébergé lorsque le plugin est déjà connecté.

Si le plugin est indisponible : connexion manuelle avec OAuth​

Si Kanera est absent de votre marché de plugins ou si l'installation du plugin n'est pas disponible, ajoutez directement le serveur MCP et connectez votre compte Kanera avec OAuth. L'adresse MCP hébergée est https://mcp.kanera.app/mcp. Pour l'auto-hébergement, copiez l'adresse MCP de votre déploiement depuis Paramètres du profil -> Clés API à la place. Vous n'avez pas besoin de créer ou de stocker une clé API.

codex mcp add kanera --url https://mcp.kanera.app/mcp
codex mcp login kanera

La commande de connexion ouvre Kanera dans votre navigateur. Connectez-vous, vérifiez l'accès demandé et choisissez Autoriser l'accès. Courir codex mcp list pour vérifier que le serveur est enregistré, ou utilisez /mcp dans la CLI Codex pour inspecter la connexion.

Dans l'application de bureau ChatGPT, ouvrez Paramètres -> Serveurs MCP -> Ajouter un serveur. Dans l'extension IDE, ouvrez le menu d'engrenage et sélectionnez Serveurs MCP -> Ajouter un serveur. Entrez Kanera, choisissez HTTP diffusable, et utilisez la même URL. Enregistrez et redémarrez lorsque vous y êtes invité, puis choisissez Authentifier lorsque Kanera nécessite une connexion.

Vous pouvez également configurer le serveur distant directement dans ~/.codex/config.toml:

[mcp_servers.kanera]
url = "https://mcp.kanera.app/mcp"

Puis cours codex mcp login kanera. Voir Connecter un agent IA pour les étendues et la déconnexion d’un agent.

Installer la compétence pour une connexion manuelle​

Si vous avez installé le plugin, sa compétence groupée est déjà disponible. Pour une configuration manuelle, la connexion MCP donne au Codex l'accès aux outils de Kanera. Le Compétence d'agent Kanera lui apprend à sélectionner ces outils de manière fiable : acheminer les clés de carte exactes telles que DEV-938 directement à Kanera, préférez MCP à l'automatisation du navigateur pour le travail pris en charge, résolvez les noms en identifiants stables, lisez l'état en direct avant de signaler ou de modifier le travail, utilisez des clés d'idempotence et gérez 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, y compris SKILL.md et agents/openai.yaml, et placez-le à l'un de ces emplacements :

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

Le Codex détecte normalement automatiquement les changements de compétences. S'il n'apparaît pas, redémarrez Codex. Mention $kanera explicitement dans une invite pour forcer son chargement, ou laisser le Codex le sélectionner automatiquement pour le travail de Kanera.

Utiliser /apps pour joindre l'application Kanera, /plugins pour vérifier si le plugin Kanera et les compétences groupées sont disponibles, et /mcp verbose pour confirmer la connexion de l'outil. Par exemple :

$kanera Update DEV-938 with the investigation findings and agreed implementation plan.

Le Codex devrait lire cette carte jusqu'au bout cards.get et appliquez la modification demandée via cards.update. Il doit ouvrir l'interface Web de Kanera uniquement pour une tâche explicitement visuelle ou une opération d'administration que MCP n'expose pas.

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 Codex 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 Codex 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.

Application de bureau ChatGPT​

Ouvert Paramètres -> Serveurs MCP, puis sélectionnez Ajouter un serveur. Vous pouvez y ajouter le serveur stdio local, ou modifier config.toml en utilisant la configuration ci-dessous. Enregistrez le serveur et sélectionnez Redémarrer.

Après avoir ajouté Kanera, démarrez une nouvelle conversation et confirmez que ses outils sont disponibles.

Fichier de configuration (application, CLI et extension IDE)​

Le Codex stocke les serveurs MCP au niveau utilisateur dans ~/.codex/config.toml. Ajouter un [mcp_servers.kanera] table pour un serveur stdio local, qui exécute 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.

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

Pour le serveur HTTP hébergé avec une clé API statique, conservez la clé dans une variable d'environnement plutôt que de l'écrire dans le fichier :

[mcp_servers.kanera]
url = "https://mcp.kanera.app/mcp"
bearer_token_env_var = "KANERA_API_KEY"

Ensemble KANERA_API_KEY dans l'environnement qui lance Codex, puis redémarrez l'application, la CLI ou l'extension IDE.

Ligne de commande​

Ou ajoutez-le depuis la ligne de commande :

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

Dans l'application de bureau, revenez à Paramètres -> Serveurs MCP pour vérifier la connexion. Dans l'extension IDE, utilisez le menu d'engrenage et sélectionnez Serveurs MCP.

Référence client​