Plane Workflow について
Plane Workflow は、設定可能なチームワークフローに沿って Plane の作業項目を管理する、コーディングエージェント向け MCP サーバーです。書き込みのプレビュー、完了証跡の記録、読み取り専用のプロジェクト概要やレポートに対応します。
主な機能
- 01設定可能な計画ルール
- 02プロジェクトを限定した項目更新
- 03dry_run による書き込みプレビュー
- 04完了証跡の記録
- 05読み取り専用の概要とレポート
活用シーン
- 01チーム要件に沿ったタスクの起草
- 02期限超過・未割り当て作業の確認
- 03検証済みのタスク完了記録
MCP 対応
MCP サーバーとして、対応クライアントに Plane のプロジェクトおよび作業項目の操作を公開します。セットアップには Claude Code、Codex、Cursor、Claude Desktop、OpenCode、Zed 向けアダプターがあります。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
Plane Workflow MCP
設定可能なチームワークフローを使って、Plane のタスクをコーディングエージェントと同期します。 構造化されたタスクを作成し、変更をプレビューし、完了の証拠を記録して、 読み取り専用のプロジェクト概要や DOCX/PDF レポートを取得できます。
インストールして最初の結果を確認する
Python 3.11+、uv、API キーを持つ Plane ワークスペースが必要です。 PyPI からインストールします:
uv tool install plane-workflow-mcp
plane-workflow setup --client claude-code
plane-workflow project list
plane-workflow project activate PROJECT_ID
plane-workflow status
PROJECT_ID を一覧に表示された ID に置き換えてください。セットアップでは、--client codex、cursor、
claude-desktop、opencode、zed のアダプターも利用できます。クライアントを再起動してから、次のように尋ねます:
アクティブな Plane ワークスペースとプロジェクトを確認し、期限超過と担当者未割り当ての 作業を表示してください。識別子と合計数を含め、一覧が省略されている場合は明示し、 Plane のデータは変更しないでください。
未リリースのチェックアウトを使用するには、代わりにリポジトリのルートから
uv tool install ./plugins/plane-workflow を実行してください。
ワークフローの動作
- アドバイザリー計画では不完全な計画データを受け入れます。厳格な計画では、スコープ、複雑さ、担当者、見積もりのマッピング、日付、未着手の状態が必要です。
- プロジェクト選択により、作業項目の変更が競合するプロジェクトに対して行われないよう保護します。
- 完了には、着手済みの項目、概要、検証テキストが必要です。状態の遷移前に完了記録が書き込まれます。
- API キーは、ガイド付きセットアップによって OS のキーリングに保存されます。環境変数を使えば、ヘッドレスで使用できます。
dry_run=true を指定してサポート対象の書き込みをプレビューし、承認を待つようエージェントに依頼してください。
書き込みの一部は、デフォルトで変更を適用します。承認はクライアントのワークフローであり、
サーバーによって強制される人間の承認ゲートではありません。更新はツール呼び出しを通じて行われ、
コードからタスクへのバックグラウンド同期は行われません。
ドキュメント
MIT ライセンス。独立したコミュニティプロジェクトであり、Plane とは無関係です。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。