作者 makeplane · makeplane/plane-mcp-server
Plane 的第一方 MCP — 由您的代理商進行全面的工作區控制：跨專案、工作項目、週期、模組、計劃等的 55 多個工具。
plane-mcp-server 是 Plane 的官方 MCP 伺服器。 借助 API 金鑰和工作區 slug，代理程式可以建立和更新專案、端對端管理工作項目（CRUD + 搜尋）、運行週期和模組、引導工作區級計畫、對接收佇列進行分類、配置自訂工作項屬性以及尋找目前使用者。 透過 uvx 支援 stdio（本地），也支援託管用戶端的具有 OAuth 或 PAT 標頭的 HTTP/遠端傳輸。
%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。儲存後重啟應用。
{
"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 格式。專案級設定優先於全域。
{
"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"。
{
"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 生效。
{
"mcpServers": [
{
"name": "plane-mcp-server",
"command": "uvx",
"args": [
"plane-mcp-server",
"stdio"
]
}
]
}Continue 使用伺服器物件陣列，而非映射。
{
"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 移除。
何時使用： 新的請求正在接收中；您想要對它們進行批量分類和路由。
結果： 更少的攝取物品，更好的路線，無需打開 UI。
何時使用： 週期規劃時間；您需要提取正確的項目並進行估算。
結果： 一次衝刺，捕捉主動血統。
何時使用： 策略工作跨越專案邊界，您需要工作區層級的視圖。
結果： 倡議儀表板充滿了真實的工作，而不是一個空容器。
何時使用： 您需要一個 Plane 未提供的現成欄位。
結果： 更豐富的資料模型，無需手動開啟 Plane 設定。
將合併的 PR 連結回他們關閉的 Plane 工作項
Mirror work: create Plane items from Linear issues, or vice versa
將週期摘要推送到 Notion 中以供利害關係人讀取
| 工具 | 輸入參數 | 何時呼叫 | 成本 |
|---|---|---|---|
| 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 |
401 未經授權PLANE_API_KEY 遺失/過期，或工作空間錯誤。 重新產生令牌。
curl -H 'X-API-Key: $PLANE_API_KEY' $PLANE_BASE_URL/api/v1/workspaces/工作區 slug 不匹配PLANE_WORKSPACE_SLUG 必須與 /app/<slug>/ 中的 URL 段完全相符。
Open Plane in the browser; copy the slug from the URL速率限制在批次操作之間新增暫停；每個工作區的平面 API 速率限制。
Inspect response headers for rate-limit fields| 替代方案 | 何時用它替代 | 權衡 |
|---|---|---|
| linear | 你的團隊生活在線性中，而不是平面中 | 不同的工具，不同的形狀 |
| monday | 您的團隊在 Monday.com | 不同的資料模型 |
| shrimp-task-manager | 您只需要一個本機任務管理器，而不是一個完整的 PM 平台 | 沒有團隊協作 |