飛行機MCPサーバー

Plane MCP サーバーは、Plane API とのシームレスな統合を提供し、開発および AI インターフェースのプロジェクト、作業項目、自動化機能を有効にするモデルコンテキストプロトコル (MCP) サーバーです。

ユースケース

プロジェクトと作業項目の作成、更新
作業を進めるために人、プロパティを割り当て、コメントを書きます
さまざまな作業項目を状態ごとに移動して観察する
作業項目にラベルを追加する
Plane内のプロジェクトとメンバーからデータを抽出して分析する
Plane のエコシステムと連携する AI 搭載ツールとアプリケーションの構築

構成パラメータ

PLANE_API_KEY - ユーザーのAPIトークン。UIの/settings/api-tokens/ページから取得できます。
PLANE_WORKSPACE_SLUG - Plane インスタンスのワークスペーススラッグ。
PLANE_API_HOST_URL (オプション) - Plane API サーバーのホスト URL。デフォルトはhttps://api.plane.so/です。

ツール

ユーザー

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 : プロジェクト識別子（例："PROJ"）（文字列、必須）
- issue_identifier : 問題番号（例："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 : 追加する問題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 : 追加する問題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（文字列、必須）

使用法

クロードデスクトップ

claude_desktop_config.jsonを編集して、 Claude Desktopに Plane を追加します。

{
  "mcpServers": {
    "plane": {
       "command": "npx",
      "args": [
        "-y",
        "@makeplane/plane-mcp-server"
      ],
      "env": {
        "PLANE_API_KEY": "<YOUR_API_KEY>",
        "PLANE_API_HOST_URL": "<HOST_URL_FOR_SELF_HOSTED",
        "PLANE_WORKSPACE_SLUG": "<YOUR_WORKSPACE_SLUG>"
      }
    }
  }
}

VSコード

.vscode.json/mcp.jsonを編集して、 VSCodeに Plane を追加します。

{
  "servers": {
    "plane": {
      "command": "npx",
      "args": [
        "-y",
        "@makeplane/plane-mcp-server"
      ],
      "env": {
        "PLANE_API_KEY": "<YOUR_API_KEY>",
        "PLANE_API_HOST_URL": "<HOST_URL_FOR_SELF_HOSTED",
        "PLANE_WORKSPACE_SLUG": "<YOUR_WORKSPACE_SLUG>"
      }
    }
  }
}

ライセンス

このプロジェクトは、MIT オープンソースライセンスの条件に基づいてライセンスされます。

Plane MCP Server