Outils IA externes

Claude Code, Codex, Cursor, VS Code, Gemini CLI, Windsurf ou Claude Desktop peuvent piloter Runeya même quand vous les lancez vous-même, hors de l'application : lister et démarrer des services, lire des logs, régler des variables, travailler sur le kanban. Ils passent par le serveur MCP de Runeya, la commande runeya mcp.

Avant de commencer

Il faut une version de Runeya qui connaît cette commande, installée dans le PATH :

runeya --help

La liste des commandes doit contenir mcp. Sinon, mettez Runeya à jour :

npm i -g @runeya/runeya

Runeya doit aussi être lancé quand l'outil IA s'en sert.

Brancher un outil

Depuis les réglages

Réglages → Clients IA liste les outils IA trouvés sur la machine. Brancher ajoute Runeya à la configuration de l'outil, Retirer l'enlève. Seule l'entrée runeya est touchée : vos autres serveurs MCP restent tels quels.

Relancez ensuite l'outil : il lit sa configuration au démarrage.

À la main

L'entrée appelle la commande runeya mcp. Elle ne contient aucun secret : l'accès se donne à la première utilisation (voir plus bas).

Outil	Commande ou fichier
Claude Code	claude mcp add --scope user runeya -- runeya mcp
Claude Code, sous Windows	claude mcp add --scope user runeya -- cmd /c runeya mcp
Codex	codex mcp add runeya -- runeya mcp
Codex, sous Windows	codex mcp add runeya -- cmd /c runeya mcp
Cursor	~/.cursor/mcp.json
Gemini CLI	~/.gemini/settings.json
Windsurf	~/.codeium/windsurf/mcp_config.json
Claude Desktop	claude_desktop_config.json, dans le dossier de réglages de Claude

Dans ces fichiers JSON :

{
  "mcpServers": {
    "runeya": { "command": "runeya", "args": ["mcp"] }
  }
}

VS Code range ses serveurs sous servers, dans le mcp.json de ses réglages utilisateur :

{
  "servers": {
    "runeya": { "type": "stdio", "command": "runeya", "args": ["mcp"] }
  }
}

Sous Windows, dans ces fichiers JSON, remplacez "command": "runeya", "args": ["mcp"] par "command": "cmd", "args": ["/c", "runeya", "mcp"] : la plupart des outils ne trouvent pas la commande runeya sans passer par cmd. Les commandes de Claude Code et de Codex ont leur variante Windows dans le tableau ci-dessus.

Donner l'accès

La première fois qu'un outil appelle Runeya, il demande l'accès. Runeya affiche alors une fenêtre avec le nom de l'outil, le dossier d'où il a été lancé et un code à quatre chiffres. L'outil affiche le même code de son côté.

Vérifiez que les deux codes sont identiques, puis acceptez. Si vous n'avez rien lancé, refusez. Une demande sans réponse expire au bout de deux minutes.

Chaque outil fait sa propre demande : accepter Claude Code ne donne pas accès à Cursor.

Retirer un accès

Réglages → Clients IA → Accès accordés liste les outils qui ont reçu l'accès. Révoquer le coupe tout de suite. L'outil devra redemander l'accès pour continuer.

Quel projet, quelle instance

Lancé dans le dossier d'un projet, l'outil travaille sur ce projet par défaut : quand vous lui demandez la liste des services, il ne montre que ceux du projet. Il peut toujours en consulter un autre en le nommant. Lancé hors de tout projet, il voit tous les projets de la machine.

Si plusieurs Runeya tournent sur la machine, l'outil vous demande laquelle utiliser.

Ce que l'outil peut faire

• Services : les lister, voir leur état, leurs logs et leur consommation, les démarrer, les arrêter, les redémarrer. Il peut aussi créer un service ou modifier sa configuration, y compris pour le passer en Docker.
• Variables d'environnement : les lire, en ajouter, les modifier, les supprimer, dans un environnement global ou dans celui d'un service.
• Projets et git : lire les projets, leurs dossiers, l'état git (statut, historique, branches, différences). Il ne fait aucune opération git.
• Kanban : lire les tableaux, les cartes, les commentaires et les pièces jointes, créer et modifier des cartes, les déplacer, les commenter, les archiver, poser une carte sur un autre tableau. Il lit aussi les conversations de support liées à une carte (Intercom, HubSpot…).

Il ne peut supprimer ni un service, ni un projet, ni un environnement.

Vos secrets

L'outil ne lit pas la valeur d'un secret, sauf si vous l'avez partagé avec les IA (case Lecture IA ou Injection IA de la variable). Il voit que la variable existe, mais sa valeur est remplacée par ***.

Il peut remplacer la valeur d'un secret sans la lire, et créer une variable secrète. Il ne peut pas rendre un secret public, ni le partager avec les IA : ces deux choix restent les vôtres.

Travailler sur une carte

Pour qu'un outil externe travaille sur une carte du kanban, chargez son contexte avec la commande work_on_card de Runeya, en donnant l'identifiant du tableau et celui de la carte :

Outil	Commande
Claude Code	/mcp__runeya__work_on_card
VS Code	/mcp.runeya.work_on_card

L'outil reçoit la carte, les colonnes du tableau, les consignes de l'équipe et la fin attendue (déplacer la carte si besoin, puis la commenter). Un outil qui n'affiche pas les commandes MCP peut appeler l'outil kanban_get_card_context, qui rend le même contexte.

Ce contexte arrive comme un message ordinaire, et non comme une consigne système. L'outil le suit en général, mais moins sûrement qu'une session lancée depuis la carte dans Runeya.

Ce qui reste réservé aux sessions lancées depuis Runeya

Un outil externe a accès aux outils de Runeya. Il n'a pas accès à ce que Runeya ajoute aux conversations lancées depuis l'application :

• le contexte de la carte fourni automatiquement, avec les consignes de l'équipe en consignes système ;
• les lancements automatiques depuis une colonne du kanban ;
• le compagnon qui relit le travail ;
• la conversation enregistrée dans Runeya et liée à la carte ;
• le lancement et le suivi des scénarios.

Pour travailler sur une carte avec tout cela, lancez l'IA depuis la carte dans Runeya.