Plane MCP Server MCP — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

Más de 55 herramientas en 8 categorías: proyectos, elementos de trabajo, ciclos, módulos, iniciativas, admisión, propiedades, usuarios
Avión propio/oficial: se mantiene al día con su API REST
Transportes: stdio vía uvx, más HTTP remoto (OAuth o PAT)
Ciclo de vida completo del elemento de trabajo: crear, actualizar, buscar, archivar, transferir ciclos/módulos
Iniciativas a nivel de espacio de trabajo para la planificación de proyectos cruzados

Demo en vivo

Cómo se ve en la práctica

plane-mcp-server.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/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"
      }
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.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 usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

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"
      }
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "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"
      }
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

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

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

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

Añádelo a context_servers. Zed recarga en caliente al guardar.

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

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: Plane MCP Server

Clasificar la cola de admisión del avión desde el chat

👤 Líderes de equipo y PM que responden a las solicitudes entrantes ⏱ ~15 min beginner

Cuándo usarlo: Nuevas solicitudes llegan a la entrada; desea clasificarlos y enrutarlos de forma masiva.

Requisitos previos

Clave API de avión — Plano → Configuración → Tokens API → Crear
Babosa del espacio de trabajo — Mire el segmento de URL después de /app/

Flujo

Listar elementos de admisión

Enumere los últimos 20 elementos de trabajo de admisión; Los clasificaré.✓ Copiado

→ Filas con identificación, título, remitente, edad
Clasificar + mover

Para cada uno: proponer proyecto objetivo y etiqueta; Después de confirmar, acepto en el proyecto.✓ Copiado

→ Acepta elementos de ruta al proyecto correcto; descansar permanecer en la ingesta

Resultado: Menos elementos de entrada, mejor enrutados, sin abrir la interfaz de usuario.

Errores comunes

Aceptación masiva sin revisión — Requerir siempre confirmación humana entre clasificación y aceptación.

Combinar con: github · linear

Planifique un sprint moviendo elementos al siguiente ciclo

👤 Equipos de ingeniería ejecutando ciclos de aviones. ⏱ ~30 min intermediate

Cuándo usarlo: Tiempo de planificación del ciclo; necesita incorporar los elementos correctos y establecer estimaciones.

Flujo

Proponer la lista de ciclos

Elementos candidatos para Sprint 24 en el proyecto 'acme-api': cualquier cosa etiquetada como 'listo' con una estimación ≤ 5.✓ Copiado

→ Lista clasificada y limitada por estimaciones
Moverlas al ciclo

Después de confirmar, agregue estos elementos de trabajo a Sprint 24.✓ Copiado

→ El ciclo ahora contiene el conjunto aprobado
Establecer el enlace de la iniciativa

Asociar el ciclo a la iniciativa 'Reintentos de facturación'.✓ Copiado

→ Iniciativa muestra al ciclo como contribuyente

Resultado: Sprint realizado en una sola pasada, con el linaje de iniciativa capturado.

Errores comunes

Estimar la deriva porque Claude adivinó los valores — Solicite artículos con estimaciones existentes; no dejes que el agente invente puntos

Combinar con: github

Crear una iniciativa que abarque múltiples proyectos

👤 Personal más ingenieros o PM que coordinan entre equipos ⏱ ~25 min intermediate

Cuándo usarlo: Un esfuerzo estratégico cruza los límites del proyecto y usted desea una vista a nivel de espacio de trabajo.

Flujo

Crear la iniciativa

Crear iniciativa 'Ship SOC 2 Type II' para el Q3-Q4 2026.✓ Copiado

→ ID de iniciativa devuelta
Vincular proyectos y elementos contribuyentes

Vincular los proyectos de 'plataforma' y 'facturación'; saque 6 artículos con etiquetas de cumplimiento de cada uno.✓ Copiado

→ Artículos etiquetados con la iniciativa.

Resultado: Panel de control de la iniciativa lleno de trabajo real, no un contenedor vacío.

Combinar con: notion

Agregar una propiedad de 'riesgo' personalizada a un proyecto

👤 Equipos que enriquecen elementos de trabajo más allá de los campos predeterminados ⏱ ~15 min intermediate

Cuándo usarlo: Necesita un campo que Plane no proporciona de forma inmediata.

Flujo

Crear la propiedad

Agregue una propiedad personalizada 'riesgo' (enum: bajo/medio/alto) al proyecto 'acme-api'.✓ Copiado

→ Propiedad configurada; visible en la interfaz de usuario
Valores de relleno

Establezca riesgo=med para todos los elementos abiertos etiquetados como "alcance desconocido".✓ Copiado

→ Artículos actualizados en masa

Resultado: Modelo de datos más rico sin abrir manualmente la configuración del plano.

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

plane-mcp-server + github

Vincular los PR fusionados al elemento de trabajo del Plano que cerraron

Cuando PR #412 se fusione, agregue el enlace de combinación al elemento de trabajo 'ACME-221' y establezca el estado en Listo.✓ Copiado

plane-mcp-server + linear

Trabajo de espejo: cree elementos planos a partir de temas lineales, o viceversa

Para cada problema de Linear etiquetado como "plano-espejo", cree un elemento de trabajo de Plano coincidente con el mismo título y descripción.✓ Copiado

plane-mcp-server + notion

Inserte resúmenes de ciclos en Notion para lecturas de las partes interesadas

Al final del sprint, resuma el Sprint 24 en el plano y publíquelo en la página de nociones 'Actualizaciones de ingeniería'.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
projects.*	varies	Listar/crear/actualizar proyectos y miembros	1 API call
work_items.*	varies	Búsqueda CRUD + completa en elementos de trabajo	1 API call
cycles.*	varies	Gestionar sprints/ciclos y sus elementos.	1 API call
modules.*	varies	Gestionar módulos y transferencias	1 API call
initiatives.*	varies	Planificación estratégica a nivel del espacio de trabajo	1 API call
intake.*	varies	Aceptar, rechazar o enrutar la entrada	1 API call
properties.*	project_id + schema	Configuración de propiedad personalizada	1 API call

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Regido por los límites de API de su plan Plane
Tokens por llamada: Pequeño para la mayoría de las operaciones; grande al buscar descripciones de elementos con archivos adjuntos
Monetario: Gratis: incluido con tu plan de avión
Consejo: Enumere con filtros estrechos (etiquetas, estado, ciclo) en lugar de buscar todo y filtrar en Claude.

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: PLANE_API_KEY pertenece a env vars: nunca confirme. Gire desde la interfaz de usuario del avión si se filtra.

Salida de datos: El tráfico va solo a su PLANE_BASE_URL configurada (Plane Cloud o su instancia autohospedada).

Una PAT tiene los permisos del usuario que la creó. Cree un usuario de agente dedicado para el acceso de los agentes en lugar de utilizar su PAT personal.
Los transportes remotos (HTTP OAuth) transfieren la confianza al host MCP: revise qué permisos otorga al cliente OAuth.

Resolución de problemas

Errores comunes y soluciones

401 No autorizado

PLANE_API_KEY falta/caducó o espacio de trabajo incorrecto. Regenera el token.

Verificar: curl -H 'X-API-Key: $PLANE_API_KEY' $PLANE_BASE_URL/api/v1/workspaces/

No coinciden los slugs del espacio de trabajo

PLANE_WORKSPACE_SLUG debe coincidir exactamente con el segmento de URL en /app/<slug>/.

Verificar: Open Plane in the browser; copy the slug from the URL

Límite de tarifa

Agregue pausas entre operaciones masivas; Límites de velocidad de API plana por espacio de trabajo.

Verificar: Inspect response headers for rate-limit fields

Alternativas

Plane MCP Server vs otros

Alternativa	Cuándo usarla	Contrapartida
linear	Tu equipo vive en Lineal, no en Plano	Herramienta diferente, forma diferente
monday	Tu equipo está en Monday.com	Modelo de datos diferente
shrimp-task-manager	Solo desea un administrador de tareas local, no una plataforma de PM completa	Sin colaboración en equipo

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills