Plane MCP Server MCP — Cas d'usage, Installer & Démo en direct

Pourquoi l'utiliser

Fonctionnalités clés

Plus de 55 outils répartis dans 8 catégories : projets, éléments de travail, cycles, modules, initiatives, apports, propriétés, utilisateurs
Avion propriétaire/officiel – suit son API REST
Transports : stdio via uvx, plus HTTP distant (OAuth ou PAT)
Cycle de vie complet des éléments de travail : création, mise à jour, recherche, archivage, transferts de cycles/modules
Initiatives au niveau de l'espace de travail pour la planification inter-projets

Démo en direct

Aperçu en pratique

plane-mcp-server.replay ▶ prêt

0/0

Installer

Choisissez votre client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "plane-mcp-server": {
      "command": "uvx",
      "args": [
        "plane-mcp-server",
        "stdio"
      ],
      "env": {
        "PLANE_API_KEY": "<from Plane → Settings → API tokens>",
        "PLANE_WORKSPACE_SLUG": "your-workspace-slug",
        "PLANE_BASE_URL": "https://api.plane.so"
      }
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "plane-mcp-server": {
      "command": "uvx",
      "args": [
        "plane-mcp-server",
        "stdio"
      ],
      "env": {
        "PLANE_API_KEY": "<from Plane → Settings → API tokens>",
        "PLANE_WORKSPACE_SLUG": "your-workspace-slug",
        "PLANE_BASE_URL": "https://api.plane.so"
      }
    }
  }
}

Cursor utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la globale.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "plane-mcp-server": {
      "command": "uvx",
      "args": [
        "plane-mcp-server",
        "stdio"
      ],
      "env": {
        "PLANE_API_KEY": "<from Plane → Settings → API tokens>",
        "PLANE_WORKSPACE_SLUG": "your-workspace-slug",
        "PLANE_BASE_URL": "https://api.plane.so"
      }
    }
  }
}

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "plane-mcp-server": {
      "command": "uvx",
      "args": [
        "plane-mcp-server",
        "stdio"
      ],
      "env": {
        "PLANE_API_KEY": "<from Plane → Settings → API tokens>",
        "PLANE_WORKSPACE_SLUG": "your-workspace-slug",
        "PLANE_BASE_URL": "https://api.plane.so"
      }
    }
  }
}

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "plane-mcp-server",
      "command": "uvx",
      "args": [
        "plane-mcp-server",
        "stdio"
      ]
    }
  ]
}

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json

{
  "context_servers": {
    "plane-mcp-server": {
      "command": {
        "path": "uvx",
        "args": [
          "plane-mcp-server",
          "stdio"
        ]
      }
    }
  }
}

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

claude mcp add plane-mcp-server -- uvx plane-mcp-server stdio

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : Plane MCP Server

Trier la file d'attente d'admission de l'avion à partir du chat

👤 Chefs d'équipe et PM répondant aux demandes entrantes ⏱ ~15 min beginner

Quand l'utiliser : De nouvelles demandes arrivent; vous souhaitez les classer en masse et les acheminer.

Prérequis

Clé API de l'avion — Plan → Paramètres → Jetons API → Créer
Limace d'espace de travail — Regardez le segment d'URL après /app/

Déroulement

Répertorier les éléments d'admission

Énumérez les 20 derniers éléments de travail d'admission ; Je vais les trier.✓ Copié

→ Lignes avec identifiant, titre, émetteur, âge
Classer + déplacer

Pour chacun : proposer un projet cible et un label ; après avoir confirmé, acceptez le projet.✓ Copié

→ Accepte d'acheminer les éléments vers le bon projet ; reste reste en admission

Résultat : Moins d'éléments d'admission, mieux acheminés, sans ouvrir l'interface utilisateur.

Pièges

Acceptation groupée sans examen — Exiger toujours une confirmation humaine entre la classification et l’acceptation

Combiner avec : github · linear

Planifiez un sprint en déplaçant les éléments dans le cycle suivant

👤 Équipes d'ingénierie exécutant des cycles d'avion ⏱ ~30 min intermediate

Quand l'utiliser : Temps de planification du cycle ; vous devez extraire les bons éléments et définir des estimations.

Déroulement

Proposer la liste des cycles

Éléments candidats pour le Sprint 24 dans le projet « acme-api » : tout ce qui est étiqueté « prêt » avec une estimation ≤ 5.✓ Copié

→ Liste classée et plafonnée par estimation
Déplacez-les dans le cycle

Après avoir confirmé, ajoutez ces éléments de travail à Sprint 24.✓ Copié

→ Le cycle contient désormais l'ensemble approuvé
Définir le lien de l'initiative

Associez le cycle à l'initiative 'Billing retries'.✓ Copié

→ L'initiative montre le cycle comme contributeur

Résultat : Sprint organisé en un seul passage, avec capture de la lignée d'initiative.

Pièges

Dérive de l'estimation car Claude a deviné les valeurs — Demandez des articles avec des estimations existantes ; ne laissez pas l'agent inventer des points

Combiner avec : github

Créer une initiative qui s'étend sur plusieurs projets

👤 Personnel et ingénieurs ou PM assurant la coordination entre les équipes ⏱ ~25 min intermediate

Quand l'utiliser : Un effort stratégique dépasse les limites du projet et vous souhaitez une vue au niveau de l'espace de travail.

Déroulement

Créer l'initiative

Créer l'initiative « Ship SOC 2 Type II » pour les troisième et quatrième trimestres 2026.✓ Copié

→ ID d'initiative renvoyé
Lier les projets et les éléments contributeurs

Lier les projets « plateforme » et « facturation » ; extrayez 6 éléments étiquetés de conformité de chacun.✓ Copié

→ Articles marqués avec l'initiative

Résultat : Tableau de bord d'initiative rempli de travail réel, pas d'un conteneur vide.

Combiner avec : notion

Ajouter une propriété « risque » personnalisée à un projet

👤 Les équipes enrichissent les éléments de travail au-delà des champs par défaut ⏱ ~15 min intermediate

Quand l'utiliser : Vous avez besoin d'un champ que Plane ne fournit pas directement.

Déroulement

Créer la propriété

Ajoutez une propriété personnalisée « risque » (énumération : faible/moyen/élevé) au projet « acme-api ».✓ Copié

→ Propriété configurée ; visible dans l'interface utilisateur
Valeurs de remplissage

Définissez Risk=med pour tous les éléments non soldés étiquetés « portée inconnue ».✓ Copié

→ Articles mis à jour en masse

Résultat : Modèle de données plus riche sans ouvrir manuellement les paramètres du plan.

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

plane-mcp-server + github

Lier les PR fusionnés à l'élément de travail Plan qu'ils ont fermé

Lorsque le PR #412 fusionne, ajoutez le lien de fusion à l'élément de travail « ACME-221 » et définissez le statut sur Terminé.✓ Copié

plane-mcp-server + linear

Travail en miroir : créez des éléments Plan à partir de problèmes linéaires, ou vice versa

Pour chaque problème linéaire intitulé « plan-miroir », créez un élément de travail Plan correspondant avec le même titre et la même description.✓ Copié

plane-mcp-server + notion

Transférez les résumés de cycle dans Notion pour les lectures des parties prenantes

À la fin du sprint, résumez le Sprint 24 dans Plane et publiez-le sur la page Notion « Eng Updates ».✓ Copié

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler	Coût
projects.*	varies	Lister/créer/mettre à jour les projets et les membres	1 API call
work_items.*	varies	CRUD complet + recherche sur les éléments de travail	1 API call
cycles.*	varies	Gérer les sprints/cycles et leurs éléments	1 API call
modules.*	varies	Gérer les modules et les transferts	1 API call
initiatives.*	varies	Planification stratégique au niveau de l'espace de travail	1 API call
intake.*	varies	Accepter, rejeter ou acheminer l'admission	1 API call
properties.*	project_id + schema	Configuration des propriétés personnalisées	1 API call

Coût et limites

Coût d'exécution

Quota d'API: Lié aux limites de l'API de votre forfait Plane
Tokens par appel: Petit pour la plupart des opérations ; grand lors de la récupération des descriptions d'articles avec des pièces jointes
Monétaire: Gratuit — inclus avec votre forfait Avion
Astuce: Liste avec des filtres étroits (étiquettes, état, cycle) plutôt que de tout récupérer et filtrer dans Claude.

Sécurité

Permissions, secrets, portée

Stockage des identifiants : PLANE_API_KEY appartient aux variables d'environnement - ne validez jamais. Faites pivoter depuis l'interface utilisateur de l'avion en cas de fuite.

Sortie de données : Le trafic est dirigé uniquement vers votre PLANE_BASE_URL configurée (Plane Cloud ou votre instance auto-hébergée).

Un PAT dispose des autorisations de l'utilisateur qui l'a créé. Créez un utilisateur agent dédié pour l'accès aux agents plutôt que d'utiliser votre PAT personnel.
Les transports distants (HTTP OAuth) transfèrent la confiance vers l'hôte MCP : vérifiez les autorisations que vous accordez au client OAuth.

Dépannage

Erreurs courantes et correctifs

401 Non autorisé

PLANE_API_KEY manquant/expiré ou espace de travail incorrect. Régénérez le jeton.

Vérifier : curl -H 'X-API-Key: $PLANE_API_KEY' $PLANE_BASE_URL/api/v1/workspaces/

Incompatibilité des slugs de l'espace de travail

PLANE_WORKSPACE_SLUG doit correspondre exactement au segment d'URL dans /app/<slug>/.

Vérifier : Open Plane in the browser; copy the slug from the URL

Limite de taux

Ajoutez des pauses entre les opérations groupées ; Limites de débit de l'API Plane par espace de travail.

Vérifier : Inspect response headers for rate-limit fields

Alternatives

Plane MCP Server vs autres

Alternative	Quand l'utiliser	Compromis
linear	Votre équipe vit en Linéaire, pas en Plan	Outil différent, forme différente
monday	Votre équipe est sur Monday.com	Modèle de données différent
shrimp-task-manager	Vous voulez juste un gestionnaire de tâches local, pas une plateforme PM complète	Aucune collaboration d'équipe

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills