/ 目录 / 演练场 / Plane MCP Server
← 全部服务器 ↗ GitHub
● 官方 makeplane 🔑 需要你的密钥

Plane MCP Server

作者 makeplane · makeplane/plane-mcp-server

Plane的第一方MCP —来自您的代理的完整工作区控制：跨项目、工作项、周期、模块、计划等的55多种工具。

plane-mcp-server是Plane的官方MCP服务器。借助API密钥和工作区slug ，代理可以创建和更新项目、端到端管理工作项（ CRUD +搜索）、运行周期和模块、引导工作区级别的计划、分类接收队列、配置自定义工作项属性以及查找当前用户。支持通过uvx的stdio （本地） ，以及托管客户端的OAuth或PAT标头的HTTP/远程传输。

▶ 观看演示 📦 安装 💡 使用场景

为什么要用

核心特性

实时演示

实际使用效果

plane-mcp-server.replay ▶ 就绪
0/0

安装

选择你的客户端

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

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.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 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

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

点击 Cline 侧栏中的 MCP Servers 图标，然后选 "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"
      }
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "plane-mcp-server",
      "command": "uvx",
      "args": [
        "plane-mcp-server",
        "stdio"
      ]
    }
  ]
}

Continue 使用服务器对象数组，而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "plane-mcp-server": {
      "command": {
        "path": "uvx",
        "args": [
          "plane-mcp-server",
          "stdio"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

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

一行命令搞定。用 claude mcp list 验证，claude mcp remove 卸载。

使用场景

实战用法： Plane MCP Server

在聊天中对飞机接听队列进行分类

👤 团队负责人和项目经理处理收到的请求 ⏱ ~15 min beginner

何时使用： 新请求被接收；您想批量分类并路由它们。

前置条件
  • 平面API密钥 — 平面→设置→API令牌→创建
  • 工作区别名 — 查看/app/之后的URL段
步骤
  1. 列出接收项目
    列出最后20个接收工作项目；我将对它们进行分类。✓ 已复制
    → 具有id、title、submitter、age的行
  2. 分类+移动
    对于每个：提出目标项目和标签；我确认后，接受进入项目。✓ 已复制
    → 接受将项目路由到正确的项目中；休息留在接收中

结果： 更少的摄入项目，更好的路由，而无需打开用户界面。

注意事项
  • 批量接受，无需审核 — 始终要求在分类和验收之间进行人工确认
搭配使用： github · linear

通过将项目移至下一个周期来规划冲刺

👤 运行平面循环的工程团队 ⏱ ~30 min intermediate

何时使用： 周期规划时间；您需要提取正确的项目并设置估计值。

步骤
  1. 提出周期清单
    项目“acme-api”中Sprint 24的候选项目：任何标记为“就绪”且估计值≤ 5的内容。✓ 已复制
    → 排名，估计上限列表
  2. 将它们移动到循环中
    确认后，将这些工作项添加到Sprint 24。✓ 已复制
    → 周期现在包含已批准的集合
  3. 设置计划链接
    将周期与“账单重试”计划相关联。✓ 已复制
    → 倡议将周期显示为贡献者

结果： 冲刺以一次传球的方式进行，捕捉到主动性的血统。

注意事项
  • 估计漂移，因为Claude猜测了值 — 询问包含现有估算的项目；不要让代理人发明积分
搭配使用： github

创建跨多个项目的计划

👤 跨团队协调的员工+工程师或项目经理 ⏱ ~25 min intermediate

何时使用： 战略工作跨越了项目界限，您需要一个工作区级别的视图。

步骤
  1. 创建计划
    为2026年第三季度至第四季度创建“Ship SOC 2 Type II”计划。✓ 已复制
    → 已返回计划ID
  2. 链接正在贡献的项目和项目
    链接“平台”和“计费”项目；从每个项目中提取6个标有合规性的项目。✓ 已复制
    → 带有倡议标记的项目

结果： 计划仪表板填充了实际工作，而不是空容器。

搭配使用： notion

向项目添加自定义“风险”属性

👤 团队丰富了默认字段以外的工作项目 ⏱ ~15 min intermediate

何时使用： 您需要一个平面不提供开箱即用的字段。

步骤
  1. 创建房源
    将自定义属性“risk” （枚举： low/med/high ）添加到项目“acme-api”。✓ 已复制
    → 属性已配置；在UI中可见
  2. 回填值
    为所有标记为“未知范围”的未结项目设置风险=医疗。✓ 已复制
    → 批量更新的商品

结果： 更丰富的数据模型，无需手动打开平面设置。

组合

与其他 MCP 搭配，撬动十倍杠杆

plane-mcp-server + github

将合并的PR链接回其关闭的Plane工作项

PR # 412合并时，将合并链接追加到工作项“ACME-221” ，并将状态设置为“完成”。✓ 已复制
plane-mcp-server + linear

镜像工作：从线性问题创建平面项目，反之亦然

对于每个标记为“平面镜”的线性问题，创建一个具有相同标题和描述的匹配平面工作项。✓ 已复制
plane-mcp-server + notion

将周期总结推入Notion ，以供利益相关者读取

在冲刺结束时，在平面中总结Sprint 24 ，并发布到“Eng Updates” （英语更新）概念页面。✓ 已复制

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
projects.* varies 列出/创建/更新项目和成员 1 API call
work_items.* varies 工作项的完整CRUD +搜索 1 API call
cycles.* varies 管理冲刺/周期及其项目 1 API call
modules.* varies 管理模块和传输 1 API call
initiatives.* varies 工作空间层面的战略规划 1 API call
intake.* varies 接受、拒绝或安排接收 1 API call
properties.* project_id + schema 自定义属性配置 1 API call

成本与限制

运行它的成本

API 配额
受飞机套餐API限制的限制
每次调用 Token 数
对于大多数操作来说很小；在获取带有附件的项目描述时很大
费用
免费—包含在您的飞机套餐中
提示
使用狭窄的筛选器（标签、状态、周期）列出，而不是在Claude中获取所有内容和筛选。

安全

权限、密钥、影响范围

凭据存储： PLANE_API_KEY属于env vars —永不提交。如果泄漏，请从平面UI旋转。
数据出站： 流量仅流向您配置的PLANE_BASE_URL （平面云或自托管实例）。

故障排查

常见错误与修复

401未授权

PLANE_API_KEY丢失/过期，或工作区错误。重新生成令牌。

验证： curl -H 'X-API-Key: $PLANE_API_KEY' $PLANE_BASE_URL/api/v1/workspaces/
工作区slug不匹配

PLANE_WORKSPACE_SLUG必须与/app//中的URL段完全匹配<slug>。

验证： Open Plane in the browser; copy the slug from the URL
价格限制

在批量操作之间添加暂停；每个工作空间的平面API速率限制。

验证： Inspect response headers for rate-limit fields

替代方案

Plane MCP Server 对比其他方案

替代方案何时用它替代权衡
linear您的团队位于线性而非平面不同的工具，不同的形状
monday您的团队正在使用Monday.com不同的数据模型
shrimp-task-manager您只需要一个本地任务经理，而不是一个完整的项目经理平台团队协作

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills