作者 makeplane · makeplane/plane-mcp-server
Plane のファーストパーティ MCP — エージェントからの完全なワークスペース制御: プロジェクト、作業項目、サイクル、モジュール、イニシアチブなどにわたる 55 以上のツール。
plan-mcp-server は Plane の公式 MCP サーバーです。 API キーとワークスペース スラッグを使用すると、エージェントはプロジェクトの作成と更新、作業項目のエンドツーエンドの管理 (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 を開かなくても、取り込みアイテムが減り、より適切にルーティングされます。
使うタイミング： サイクル計画の時間。 適切な項目を取り出して見積もりを設定する必要があります。
結果： スプリントは 1 回のパスで行われ、主導権を獲得しました。
使うタイミング： 戦略的な取り組みはプロジェクトの境界を越えるため、ワークスペース レベルのビューが必要になります。
結果： 空のコンテナではなく、実際の作業が入力されたイニシアチブ ダッシュボード。
使うタイミング： Plane がそのままでは提供しないフィールドが必要です。
結果： プレーン設定を手動で開かなくても、より豊富なデータ モデル。
マージされた PR を、閉じた Plane ワークアイテムにリンクして戻します
ミラー作業: 線形課題から平面アイテムを作成、またはその逆
サイクルの概要を 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/ワークスペースのスラッグの不一致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 プラットフォームではなく、ローカル タスク マネージャーだけが必要な場合 | チームの協力がない |