Integração com o Plane MCP Server

O que faz o “Plane” MCP Server?

O Plane MCP Server é um servidor Model Context Protocol (MCP) que permite que grandes modelos de linguagem (LLMs) interajam diretamente com o Plane.so, uma plataforma de gestão de projetos e tarefas. Atuando como ponte entre assistentes de IA e a API do Plane.so, esse servidor permite que LLMs executem ações como listar projetos, recuperar detalhes, criar e atualizar tarefas e mais—sempre mantendo o controle e a segurança do usuário. Isso aprimora o fluxo de trabalho de desenvolvedores ao permitir automação por IA, recuperação de dados e gestão de tarefas dentro do ambiente conhecido do Plane.so. LLMs como o Claude podem usar o Plane MCP Server para otimizar o acompanhamento de projetos, automatizar atualizações e integrar IA conversacional às operações do projeto.

Lista de Prompts

Nenhum template de prompt explícito é descrito no repositório. Esta seção permanece vazia devido à falta de informação.

Lista de Recursos

Nenhum recurso MCP explícito está documentado no repositório. Esta seção permanece vazia devido à falta de informação.

Lista de Ferramentas

• list-projects
  • Lista todos os projetos do seu workspace Plane.
• get-project
  • Recupera informações detalhadas sobre um projeto específico (requer project_id).
• create-issue
  • Cria uma nova tarefa em um projeto com propriedades customizáveis.
• list-issues
  • Lista e filtra tarefas de projetos.
• get-issue
  • Obtém informações detalhadas sobre uma tarefa específica.
• update-issue
  • Atualiza tarefas existentes com novas informações.

Casos de Uso deste MCP Server

• Visão Geral e Relatórios de Projetos
  • Liste instantaneamente todos os projetos de um workspace Plane e recupere detalhes, ajudando equipes a monitorar trabalhos em andamento e status dos projetos.
• Criação Automatizada de Tarefas
  • LLMs podem criar novas tarefas no Plane.so, permitindo abertura automática de chamados a partir de conversas, bugs ou solicitações de usuários.
• Acompanhamento e Filtragem de Tarefas
  • A IA pode listar e filtrar tarefas por critérios, otimizando a triagem, priorização e resposta a bloqueios do projeto.
• Recuperação de Detalhes das Tarefas
  • Desenvolvedores ou agentes de IA conseguem rapidamente buscar detalhes de tarefas para automação de fluxos, sugestões de código ou documentação.
• Automação de Gestão de Projetos
  • Atualizações rotineiras e alterações em projetos podem ser tratadas pela IA, reduzindo entrada manual e mantendo o status sempre atualizado.

Como configurar

Windsurf

1. Certifique-se de possuir Node.js 22.x ou superior e uma chave de API do Plane.so.
2. Instale o servidor usando o Smithery:

   npx -y @smithery/cli install @kelvin6365/plane-mcp-server --client windsurf
   

3. Localize seu arquivo de configuração do Windsurf.
4. Adicione o Plane MCP server usando o seguinte JSON:

   {
     "mcpServers": {
       "plane": {
         "command": "node",
         "args": ["path/to/plane-mcp-server/build/index.js"],
         "env": {
           "PLANE_API_KEY": "your_plane_api_key_here",
           "PLANE_WORKSPACE_SLUG": "your_workspace_slug_here"
         }
       }
     }
   }
   

5. Salve as alterações e reinicie o Windsurf.

Claude

1. Garanta que o Node.js 22.x ou superior esteja instalado juntamente com uma chave de API do Plane.so.
2. Instale via Smithery:

   npx -y @smithery/cli install @kelvin6365/plane-mcp-server --client claude
   

3. Abra o arquivo de configuração do Claude for Desktop:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
4. Insira o seguinte JSON em mcpServers:

   {
     "mcpServers": {
       "plane": {
         "command": "node",
         "args": ["path/to/plane-mcp-server/build/index.js"],
         "env": {
           "PLANE_API_KEY": "your_plane_api_key_here",
           "PLANE_WORKSPACE_SLUG": "your_workspace_slug_here"
         }
       }
     }
   }
   

5. Reinicie o Claude for Desktop.

Cursor

1. Instale Node.js 22.x+ e obtenha sua chave de API do Plane.so.
2. Instale com:

   npx -y @smithery/cli install @kelvin6365/plane-mcp-server --client cursor
   

3. Edite a configuração MCP do Cursor.
4. Adicione a seguinte configuração:

   {
     "mcpServers": {
       "plane": {
         "command": "node",
         "args": ["path/to/plane-mcp-server/build/index.js"],
         "env": {
           "PLANE_API_KEY": "your_plane_api_key_here",
           "PLANE_WORKSPACE_SLUG": "your_workspace_slug_here"
         }
       }
     }
   }
   

5. Salve e reinicie o Cursor para aplicar as alterações.

Cline

1. Confirme que o Node.js 22.x+ está presente e que você possui sua chave de API do Plane.so.
2. Execute:

   npx -y @smithery/cli install @kelvin6365/plane-mcp-server --client cline
   

3. Abra a configuração do servidor MCP do Cline.
4. Adicione:

   {
     "mcpServers": {
       "plane": {
         "command": "node",
         "args": ["path/to/plane-mcp-server/build/index.js"],
         "env": {
           "PLANE_API_KEY": "your_plane_api_key_here",
           "PLANE_WORKSPACE_SLUG": "your_workspace_slug_here"
         }
       }
     }
   }
   

5. Salve e reinicie o Cline.

Segurança das Chaves de API:
Sempre armazene seu PLANE_API_KEY e PLANE_WORKSPACE_SLUG como variáveis de ambiente dentro do campo env da sua configuração, como mostrado acima. Nunca insira diretamente nos arquivos-fonte.

Como usar este MCP em fluxos

Usando MCP no FlowHunt

Para integrar servidores MCP ao seu fluxo no FlowHunt, comece adicionando o componente MCP ao seu fluxo e conectando-o ao seu agente de IA:

Clique no componente MCP para abrir o painel de configuração. Na seção de configuração MCP do sistema, insira os detalhes do seu servidor MCP usando este formato JSON:

{
  "plane": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Uma vez configurado, o agente de IA poderá utilizar este MCP como uma ferramenta, acessando todas as suas funções e capacidades. Lembre-se de trocar “plane” pelo nome do seu MCP server e substituir a URL pela URL do seu próprio servidor MCP.

Visão Geral

Nossa opinião:
O Plane MCP Server oferece excelente documentação de instalação e uso das ferramentas, mas carece de informações sobre templates de prompt, primitivas de recurso e suporte a sampling/roots. O servidor é focado e prático para automação de gestão de projetos, mas se beneficiaria de recursos MCP e documentação ampliados. No geral, é bem adequado para integração direta com o Plane.so.

Pontuação MCP