飛行機MCPサーバー

Plane MCP サーバーは、モデル コンテキスト プロトコル (MCP) の機能を Plane にもたらし、AI エージェントと開発者ツールが Plane ワークスペースとプログラムで対話できるようにします。

インテリジェント アシスタント、自動化スクリプト、ワークフロー駆動型ツールなどを構築する場合でも、このサーバーは Plane の API へのシームレスなブリッジを提供するため、プロジェクトの作成、問題の管理、タスクの割り当て、AI 搭載ツールとの作業の同期が可能になります。

それを使って何ができるのでしょうか?

このサーバーは、Plane を使用するすべての人にとってさまざまな便利な機能を実現します。

• AI またはアプリ インターフェースから直接プロジェクトと作業項目を起動します。

• 進捗状況の更新、チーム メンバーの割り当て、プロパティの設定、コメントの追加など、すべてプログラムで実行できます。

• 問題をワークフローを通じて移動し、その状態を即座に更新します。

• ラベル、モジュール、サイクルを使用して作業を整理します。

• プロジェクト全体にわたるチームの作業に関するデータを分析します。

• 作業を記録する AI エージェントや、プロジェクトを整理するボットなど、Plane と自然にやり取りするスマート アプリを構築します。

Related MCP server: Plane MCP Server

ツール

ユーザー

• 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インスタンスのワークスペーススラッグ。ワークスペーススラッグは、Plane内のワークスペースの一意の識別子を表します。URLに記載されています。

• PLANE_API_HOST_URL (オプション) - Plane API サーバーのホスト URL。デフォルトはhttps://api.plane.so/です。

使用法

クロードデスクトップ

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ファイルを編集して、Plane をVSCodeに接続することもできます。

{
  "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>"
      }
    }
  }
}

ライセンス

このMCPサーバーはMITライセンスに基づいてライセンスされています。つまり、MITライセンスの条件に従って、ソフトウェアを自由に使用、改変、配布することができます。詳細については、プロジェクトリポジトリのLICENSEファイルをご覧ください。