Plane MCP Server

平面 MCP 服务器

Plane MCP 服务器将模型上下文协议 (MCP) 的强大功能带入 Plane，允许 AI 代理和开发人员工具以编程方式与您的 Plane 工作区进行交互。

无论您是构建智能助手、自动化脚本还是工作流驱动的工具，该服务器都提供了与 Plane API 的无缝桥梁——因此您可以创建项目、管理问题、分配任务并使您的工作与 AI 驱动的工具保持同步。

你能用它做什么？

该服务器为使用 Plane 的任何人解锁了各种有用的功能：

• 直接从您的 AI 或应用程序界面启动项目和工作项。
• 更新进度、分配团队成员、设置属性或添加评论——全部以编程方式进行。
• 通过工作流程移动问题并动态更新其状态。
• 使用标签、模块和周期来组织工作。
• 分析有关您的团队跨项目工作的数据。
• 构建与 Plane 自然交互的智能应用程序 - 无论是记录工作的 AI 代理，还是保持项目整洁的机器人。

工具

用户

• get_user
  • 获取当前用户的信息
  • 无需参数

项目

• get_projects
  • 获取当前用户的所有项目
  • 无需参数
• create_project
  • 创建新项目
  • 参数：
    • name （字符串，必需）：项目名称

问题类型

• list_issue_types
  • 获取特定项目的所有问题类型
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
• get_issue_type
  • 获取特定问题类型的详细信息
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
    • type_id （字符串，必需）：问题类型的 UUID
• create_issue_type
  • 在项目中创建新的问题类型
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
    • issue_type_data ：对象包含：
      • name （字符串，必需）：问题类型的名称
      • description （字符串，必需）：问题类型的描述
• update_issue_type
  • 更新现有问题类型
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
    • type_id （字符串，必需）：问题类型的 UUID
    • issue_type_data （对象）：问题类型需要更新的字段
• delete_issue_type
  • 删除问题类型
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
    • type_id （字符串，必需）：问题类型的 UUID

州

• list_states
  • 获取特定项目的所有状态
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
• get_state
  • 获取特定州的详细信息
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
    • state_id （字符串，必需）：状态的 UUID
• create_state
  • 在项目中创建新状态
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
    • state_data ：对象包含：
      • name （字符串，必需）：州名
      • color （字符串，必需）：状态的颜色代码
• update_state
  • 更新现有状态
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
    • state_id （字符串，必需）：状态的 UUID
    • state_data （对象）：状态更新的字段
• delete_state
  • 删除状态
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
    • state_id （字符串，必需）：状态的 UUID

标签

• list_labels
  • 获取特定项目的所有标签
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
• get_label
  • 获取特定标签的详细信息
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
    • label_id （字符串，必需）：标签的 UUID
• create_label
  • 在项目中创建新标签
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
    • label_data ：包含以下内容的对象：
      • name （字符串，必需）：标签的名称
      • color （字符串，必需）：标签的颜色代码
• update_label
  • 更新现有标签
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
    • label_id （字符串，必需）：标签的 UUID
    • label_data （对象）：标签上要更新的字段
• delete_label
  • 删除标签
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
    • label_id （字符串，必需）：标签的 UUID

问题

• get_issue_using_readable_identifier
  • 使用可读标识符获取问题详细信息（例如 PROJ-123）
  • 参数：
    • project_identifier （字符串，必需）
    • issue_identifier （字符串，必需）：问题编号：项目标识符（例如，“PROJ”）r（例如，“123”）
• get_issue_comments
  • 获取特定问题的所有评论
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
    • issue_id （字符串，必需）：问题的 UUID
• add_issue_comment
  • 向问题添加评论
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
    • issue_id （字符串，必需）：问题的 UUID
    • comment_html （字符串，必需）：评论的 HTML 内容
• create_issue
  • 创建新问题
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
    • issue_data ：对象包含：
    • name （字符串，必需）：问题标题
    • description_html （字符串，必需）：问题的 HTML 描述
• update_issue
  • 更新现有问题
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
    • issue_id （字符串，必需）：问题的 UUID
    • issue_data （对象）：问题更新字段

模块

• list_modules
  • 获取特定项目的所有模块
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
• get_module
  • 获取特定模块的详细信息
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
    • module_id （字符串，必需）：模块的 UUID
• create_module
  • 在项目中创建新模块
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
    • module_data ：对象包含：
      • name （字符串，必需）：模块的名称
• update_module
  • 更新现有模块
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
    • module_id （字符串，必需）：模块的 UUID
    • module_data （对象）：模块上要更新的字段
• delete_module
  • 删除模块
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
    • module_id （字符串，必需）：模块的 UUID

模块问题

• list_module_issues
  • 获取特定模块的所有问题
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
    • module_id （字符串，必需）：模块的 UUID
• add_module_issues
  • 向模块添加问题
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
    • module_id （字符串，必需）：模块的 UUID
    • issues （string[]，必需）：要添加的问题 UUID 数组
• delete_module_issue
  • 从模块中删除问题
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
    • module_id （字符串，必需）：模块的 UUID
    • issue_id （字符串，必需）：要删除的问题的 UUID

周期

• list_cycles
  • 获取特定项目的所有周期
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
• get_cycle
  • 获取特定周期的详细信息
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
    • cycle_id （字符串，必需）：循环的 UUID
• create_cycle
  • 在项目中创建新的周期
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
    • cycle_data ：对象包含：
    • name （字符串，必需）：循环的名称
    • start_date （字符串，必需）：开始日期（YYYY-MM-DD）
    • end_date （字符串，必需）：结束日期（YYYY-MM-DD）
• update_cycle
  • 更新现有周期
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
    • cycle_id （字符串，必需）：循环的 UUID
    • cycle_data （对象）：循环中要更新的字段
• delete_cycle
  • 删除循环
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
    • cycle_id （字符串，必需）：循环的 UUID

周期问题

• list_cycle_issues
  • 获取特定周期的所有问题
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
    • cycle_id （字符串，必需）：循环的 UUID
• add_cycle_issues
  • 将问题添加到周期
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
    • cycle_id （字符串，必需）：循环的 UUID
    • issues （string[]，必需）：要添加的问题 UUID 数组
• delete_cycle_issue
  • 从周期中删除问题
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
    • cycle_id （字符串，必需）：循环的 UUID
    • issue_id （字符串，必需）：要删除的问题的 UUID

工作日志

• get_issue_worklogs
  • 获取特定问题的所有工作日志
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
    • issue_id （字符串，必需）：问题的 UUID
• get_total_worklogs
  • 获取项目的总记录时间
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
• create_worklog
  • 为问题创建新的工作日志
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
    • issue_id （字符串，必需）：问题的 UUID
    • worklog_data ：对象包含：
      • description （字符串，必需）：已完成工作的描述
      • duration （整数，必需）：持续时间（分钟）
• update_worklog
  • 更新现有的工作日志
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
    • issue_id （字符串，必需）：问题的 UUID
    • worklog_id (字符串，必需)：工作日志的 UUID
    • worklog_data （对象）：工作日志中要更新的字段
• delete_worklog
  • 删除工作日志
  • 参数：
    • project_id （字符串，必需）：项目的 UUID
    • issue_id （字符串，必需）：问题的 UUID
    • worklog_id (字符串，必需)：工作日志的 UUID

配置参数

• PLANE_API_KEY - 您的 Plane API 令牌。您可以在 Plane 应用中的“工作区设置”>“API 令牌”页面 ( /settings/api-tokens/ ) 生成一个。
• PLANE_WORKSPACE_SLUG - 您的 Plane 实例的工作区标识符。workspace-slug 表示 Plane 中每个工作区的唯一标识符。您可以在 URL 中找到它。
• PLANE_API_HOST_URL （可选）- Plane API 服务器的主机 URL。默认为https://api.plane.so/

用法

克劳德桌面

您可以通过更新claude_desktop_config.json将 Plane 添加到Claude Desktop ：

VSCode

您还可以通过编辑.vscode.json或mcp.json文件将 Plane 连接到VSCode ：

执照

此 MCP 服务器采用 MIT 许可证。这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。更多详情，请参阅项目仓库中的 LICENSE 文件。