Guide pratique · Environ 3 minutes

Comment connecter Onplana à Gemini CLI et Code Assist

Installation en une ligne. Onplana fournit un manifeste d’extension Gemini à la racine du dépôt, toute la configuration tient donc en :gemini extensions install <repo>.

Ensuite, vous pouvez demander à Gemini par exemple « résume mes tâches Onplana en retard », « crée un plan de projet pour le lancement du Q3 avec 5 jalons hebdomadaires » ou « liste les membres de mon équipe sur le projet de plateforme de données », et Gemini l’exécute directement dans Onplana.

Ouvrir Onplana → Paramètres → Agents Gemini CLI sur GitHub

En bref : trois commandes

# 1. Set your Onplana token
export ONPLANA_PAT=pat_paste-your-token-here

# 2. Install the extension
gemini extensions install https://github.com/Onplana/onplana-mcp-server

# 3. Restart and verify
gemini
> list my Onplana projects via the onplana tool

Les étapes détaillées suivent.

Les cinq étapes en détail

  1. 1

    Installer Gemini CLI (si ce n’est pas déjà fait)

    Sous macOS / Linux : npm install -g @google/gemini-cli. Sous Windows : la même commande dans un terminal avec Node. Vérifiez avec `gemini --version`. Si vous utilisez Gemini Code Assist dans VS Code ou JetBrains, vous avez déjà ce qu’il faut : Code Assist partage le fichier de configuration de la CLI.

  2. 2

    Générer un jeton de connexion Onplana

    Connectez-vous à Onplana sur app.onplana.com. Allez dans Paramètres → Agents → Connecter un agent, choisissez la tuile Gemini CLI + Code Assist, puis Jeton d’accès personnel et enfin Générer le jeton + afficher l’extrait de connexion. Copiez le jeton d’accès personnel (il commence par `pat_`). Définissez-le comme variable d’environnement : export ONPLANA_PAT=pat_your-token-here (ajoutez la ligne à ~/.bashrc ou ~/.zshrc pour la conserver).

  3. 3

    Installer l’extension Gemini d’Onplana (une commande)

    Exécutez : gemini extensions install https://github.com/Onplana/onplana-mcp-server. Le dépôt Onplana fournit à la racine un manifeste gemini-extension.json, que Gemini CLI lit pour configurer automatiquement la connexion au serveur MCP. Autre possibilité : modifier ~/.gemini/settings.json à la main ; le format est documenté sur developers.google.com/gemini-code-assist/docs.

  4. 4

    Redémarrer Gemini CLI ou recharger l’éditeur

    Pour Gemini CLI : quittez et rouvrez `gemini`. Pour Gemini Code Assist dans VS Code : Cmd/Ctrl+Maj+P → "Developer: Reload Window". Pour JetBrains : redémarrez l’IDE. Les outils Onplana apparaissent dans le sélecteur /mcp après le redémarrage.

  5. 5

    Vérifier la connexion

    Dans une nouvelle session Gemini, demandez : « list my Onplana projects via the onplana tool ». Gemini appelle l’outil list_projects d’Onplana et vous montre le résultat. En cas d’erreur, vérifiez que ONPLANA_PAT est défini dans l’environnement qu’utilise Gemini et que le manifeste de l’extension est bien installé, avec `gemini extensions list`.

Ou configurez-le à la main

Si vous préférez ne pas installer l’extension, modifiez~/.gemini/settings.json(ou .gemini/settings.json à la racine de l’espace de travail) directement :

{
  "mcpServers": {
    "onplana": {
      "httpUrl": "https://mcp.onplana.com/mcp",
      "headers": {
        "Authorization": "Bearer pat_paste-your-token-here"
      },
      "timeout": 5000
    }
  }
}

Notez que la clé est httpUrl, et non url. Gemini CLI utilise httpUrl pour les serveurs Streamable HTTP comme Onplana et réserve url aux serveurs SSE. Le jeton bearer dans headers.Authorization authentifie chaque requête.

Comment vérifier que ça fonctionne

Ouvrez une nouvelle session Gemini et essayez l’une de ces demandes :

  • « Avec l’outil onplana, liste mes projets. »
  • « Montre-moi les tâches Onplana en retard qui me sont assignées. »
  • « Crée une tâche Onplana dans le projet X appelée ‘Migrer Postgres vers Aurora’. »
  • « Cherche dans mes pages Onplana des notes sur la migration de l’API. »

Exécutez gemini extensions list pour confirmer que l’extension Onplana est installée. Après une installation réussie, le sélecteur /mcp devrait afficher la liste complète des outils Onplana.

Questions fréquentes

Est-ce que ça fonctionne avec Gemini Code Assist dans VS Code ?

Oui. Gemini CLI et Gemini Code Assist partagent le même fichier de configuration (~/.gemini/settings.json pour tout l’utilisateur, ou .gemini/settings.json dans un espace de travail). Une installation avec `gemini extensions install` couvre les deux. Ensuite, rechargez la fenêtre VS Code (Cmd/Ctrl+Maj+P → "Developer: Reload Window") pour que Code Assist prenne la nouvelle configuration.

Et l’application Gemini sur gemini.google.com ?

gemini.google.com ne prend pas encore en charge les serveurs MCP personnalisés en mai 2026. Google oriente ceux qui veulent se connecter à des serveurs MCP tiers vers Gemini CLI ou Gemini Code Assist. Nous suivons le sujet ; si l’application ajoute MCP, l’installation se fera en un clic via une interface de connecteurs comparable à celle de Claude.ai.

Et Gemini Enterprise / Vertex AI Agent Builder ?

Gemini Enterprise se configure autrement que Gemini CLI : un administrateur ajoute Onplana dans la console Google Cloud comme magasin de données Custom MCP Server, avec un ID client OAuth et un secret. C’est en accès anticipé et géré par l’administrateur, pas en libre-service : Onplana délivre le client à votre organisation sur demande. Le guide sur docs.onplana.com/ai-agents/connect-onplana-to-gemini-enterprise/ donne les réglages, les 20 actions à activer d’abord et le lien pour demander l’accès.

Quel forfait Onplana inclut MCP ?

MCP est inclus sur tous les forfaits, y compris le forfait gratuit. Le nombre de connexions d’agents simultanées augmente avec le forfait (Free 2, Professional 3, Business 5, Enterprise 10, Enterprise+ illimité), et votre solde de jetons IA (une allocation mensuelle sur les forfaits payants, un bonus unique sur Free, plus le crédit acheté) est ce qui borne l’usage réel de l’IA. Vous changez de forfait à tout moment sur app.onplana.com/billing.

Quelle différence entre l’installation par gemini-extension.json et la modification directe de settings.json ?

Fonctionnellement, aucune. L’installation de l’extension tient en une commande et s’appuie sur un manifeste à la racine du dépôt, elle est donc reproductible. Modifier settings.json à la main sert quand vous voulez placer Onplana à côté de plusieurs serveurs MCP (par exemple un pour Onplana, un pour Linear, un pour une API interne) dans le même objet `mcpServers`. Les deux fonctionnent et partagent la même configuration.

Pourquoi la clé s’appelle-t-elle httpUrl et non url ?

Gemini CLI distingue les serveurs MCP en stdio (clé : command), en SSE (clé : url) et en Streamable HTTP (clé : httpUrl). Le serveur MCP d’Onplana utilise Streamable HTTP, le standard de transport plus récent, qui gère requête et réponse en HTTPS simple sans SSE. La clé `url` des configurations de Claude Desktop, Cursor et ChatGPT en est l’équivalent.

Puis-je révoquer la connexion ?

Oui, de deux façons : (1) Onplana → Paramètres → Agents → Connexions → Révoquer sur la ligne du jeton. (2) Retirez ONPLANA_PAT de votre environnement ET exécutez `gemini extensions uninstall onplana`. Les deux sont immédiats ; le prochain appel d’outil de Gemini renvoie 401.

À quels outils Gemini a-t-il accès ?

346 outils, les mêmes que pour Claude Desktop, Cursor et ChatGPT : lecture (list_projects, list_my_tasks, get_task, search_org_knowledge, etc.) et écriture (create_task, update_task, assign_task, create_milestone, etc.), plus les domaines gouvernance, maîtrise des changements, conformité, documents et workflows. Le catalogue d’outils est le même quel que soit le client connecté. Le forfait ouvre certains outils ; le catalogue complet est sur onplana.com/mcp.

À lire aussi