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

Por que usar

Principais recursos

Mais de 55 ferramentas em 8 categorias — projetos, itens de trabalho, ciclos, módulos, iniciativas, entradas, propriedades, usuários
Avião original/oficial — acompanha sua API REST
Transportes: stdio via uvx, além de HTTP remoto (OAuth ou PAT)
Ciclo de vida completo do item de trabalho: criar, atualizar, pesquisar, arquivar, transferir ciclos/módulos
Iniciativas em nível de espaço de trabalho para planejamento entre projetos

Demo ao vivo

Como fica na prática

plane-mcp-server.replay ▶ pronto

0/0

Instalar

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

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.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 o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a 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"
      }
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "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"
      }
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

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

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

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

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

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

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: Plane MCP Server

Faça a triagem da fila de entrada do avião no chat

👤 Líderes de equipe e PMs atendendo solicitações recebidas ⏱ ~15 min beginner

Quando usar: Novas solicitações chegam ao recebimento; você deseja classificá-los em massa e encaminhá-los.

Pré-requisitos

Chave de API do plano — Plano → Configurações → Tokens de API → Criar
Slug do espaço de trabalho — Observe o segmento de URL após /app/

Fluxo

Listar itens de ingestão

Liste os últimos 20 itens de trabalho de admissão; Vou fazer a triagem deles.✓ Copiado

→ Linhas com ID, título, remetente, idade
Classificar + mover

Para cada um: propor projeto alvo e rótulo; depois de confirmar, aceite o projeto.✓ Copiado

→ Aceita itens de rota no projeto certo; resto fique na ingestão

Resultado: Menos itens de entrada, melhor roteamento, sem abrir a IU.

Armadilhas

Aceitação em massa sem revisão — Sempre exija confirmação humana entre classificação e aceitação

Combine com: github · linear

Planeje um sprint movendo itens para o próximo ciclo

👤 Equipes de engenharia executando ciclos de avião ⏱ ~30 min intermediate

Quando usar: Tempo de planejamento do ciclo; você precisa obter os itens certos e definir estimativas.

Fluxo

Propor a lista de ciclos

Itens candidatos para o Sprint 24 no projeto 'acme-api': qualquer coisa rotulada como 'pronto' com estimativa ≤ 5.✓ Copiado

→ Lista classificada e com limite estimado
Mova-os para o ciclo

Depois de confirmar, adicione esses itens de trabalho ao Sprint 24.✓ Copiado

→ O ciclo agora contém o conjunto aprovado
Definir o link da iniciativa

Associe o ciclo à iniciativa ‘Tentativas de cobrança’.✓ Copiado

→ Iniciativa mostra o ciclo como colaborador

Resultado: Sprint encenado em uma passagem, com linhagem de iniciativa capturada.

Armadilhas

Desvio estimado porque Claude adivinhou valores — Solicite itens com estimativas existentes; não deixe o agente inventar pontos

Combine com: github

Crie uma iniciativa que abrange vários projetos

👤 Equipe mais engenheiros ou PMs coordenando entre equipes ⏱ ~25 min intermediate

Quando usar: Um esforço estratégico ultrapassa os limites do projeto e você deseja uma visão no nível do espaço de trabalho.

Fluxo

Crie a iniciativa

Criar a iniciativa 'Ship SOC 2 Type II' para o terceiro e quarto trimestre de 2026.✓ Copiado

→ ID da iniciativa retornado
Vincular projetos e itens de contribuição

Vincular os projetos ‘plataforma’ e ‘faturamento’; retire 6 itens rotulados de conformidade de cada um.✓ Copiado

→ Itens marcados com a iniciativa

Resultado: Painel de iniciativa preenchido com trabalho real, não um contêiner vazio.

Combine com: notion

Adicione uma propriedade personalizada de 'risco' a um projeto

👤 Equipes enriquecendo itens de trabalho além dos campos padrão ⏱ ~15 min intermediate

Quando usar: Você precisa de um campo que o Plane não fornece imediatamente.

Fluxo

Crie a propriedade

Adicione uma propriedade personalizada 'risk' (enum: low/med/high) ao projeto 'acme-api'.✓ Copiado

→ Propriedade configurada; visível na IU
Valores de preenchimento

Defina risco = med para todos os itens em aberto rotulados como 'escopo desconhecido'.✓ Copiado

→ Itens atualizados em massa

Resultado: Modelo de dados mais rico sem abrir as configurações do plano manualmente.

Combinações

Combine com outros MCPs para 10× de alavancagem

plane-mcp-server + github

Vincule PRs mesclados de volta ao item de trabalho do Plano que eles fecharam

Quando o PR #412 for mesclado, anexe o link de mesclagem ao item de trabalho 'ACME-221' e defina o status como Concluído.✓ Copiado

plane-mcp-server + linear

Trabalho de espelhamento: crie itens planos a partir de problemas lineares ou vice-versa

Para cada problema Linear rotulado como 'plane-mirror', crie um item de trabalho Planear correspondente com o mesmo título e descrição.✓ Copiado

plane-mcp-server + notion

Insira resumos de ciclo no Notion para leituras das partes interessadas

No final do sprint, resuma o Sprint 24 no Plane e poste na página de noção 'Atualizações de Eng'.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
projects.*	varies	Listar/criar/atualizar projetos e membros	1 API call
work_items.*	varies	CRUD completo + pesquisa em itens de trabalho	1 API call
cycles.*	varies	Gerenciar sprints/ciclos e seus itens	1 API call
modules.*	varies	Gerenciar módulos e transferências	1 API call
initiatives.*	varies	Planejamento estratégico em nível de espaço de trabalho	1 API call
intake.*	varies	Aceitar, rejeitar ou encaminhar entrada	1 API call
properties.*	project_id + schema	Configuração de propriedade personalizada	1 API call

Custo e limites

O que custa rodar

Cota de API: Limite-se aos limites da API do seu plano de avião
Tokens por chamada: Pequeno para a maioria das operações; grande ao buscar descrições de itens com anexos
Monetário: Gratuito – incluído no seu plano de avião
Dica: Lista com filtros estreitos (rótulos, estado, ciclo) em vez de buscar tudo e filtrar no Claude.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: PLANE_API_KEY pertence a env vars - nunca confirme. Gire na interface do avião se houver vazamento.

Saída de dados: O tráfego vai apenas para o PLANE_BASE_URL configurado (Plane Cloud ou sua instância auto-hospedada).

Um PAT possui as permissões do usuário que o criou. Crie um usuário agente dedicado para acesso do agente em vez de usar seu PAT pessoal.
Os transportes remotos (HTTP OAuth) transferem a confiança para o host MCP — revise quais permissões você concede ao cliente OAuth.

Solução de problemas

Erros comuns e correções

401 Não Autorizado

PLANE_API_KEY ausente/expirado ou espaço de trabalho incorreto. Regenere o token.

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

Incompatibilidade de slug do espaço de trabalho

PLANE_WORKSPACE_SLUG deve corresponder exatamente ao segmento de URL em /app/<slug>/.

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

Limite de taxa

Adicione pausas entre operações em massa; Limites de taxa da API Plane por espaço de trabalho.

Verificar: Inspect response headers for rate-limit fields

Alternativas

Plane MCP Server vs. outros

Alternativa	Quando usar	Troca
linear	Sua equipe vive em Linear, não em Plano	Ferramenta diferente, formato diferente
monday	Sua equipe está em Monday.com	Modelo de dados diferente
shrimp-task-manager	Você quer apenas um gerenciador de tarefas local, não uma plataforma PM completa	Sem colaboração em equipe

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills