飛行機MCPサーバー

モデルコンテキストプロトコル（MCP）サーバーは、LLMがPlane.soと連携し、PlaneのAPIを介してプロジェクトや課題を管理できるようにします。このサーバーを使用することで、ClaudeのようなLLMは、ユーザーの制御とセキュリティを維持しながら、プロジェクト管理ワークフローに直接アクセスできるようになります。

特徴

平面ワークスペース内のすべてのプロジェクトを一覧表示する
特定のプロジェクトに関する詳細情報を入手する
カスタマイズ可能なプロパティで新しい問題を作成する
プロジェクトからの問題の一覧表示とフィルタリング
特定の問題に関する詳細情報を取得する
既存の問題を新しい情報で更新する

前提条件

Node.js 22.x 以上
Plane.so APIキー
Plane.so ワークスペース

インストール

オプション1: Smitheryを使用する

最も早く始める方法は、Smithery を使用してサーバーを直接インストールすることです。

# Install to Claude for Desktop
npx -y @smithery/cli install @kelvin6365/plane-mcp-server --client claude

このコマンドは、Claudeで使用するためのPlane MCPサーバーを自動的にセットアップします。インストール後、Claudeの設定でPlane APIキーとワークスペーススラッグを使用してサーバーを設定する必要があります。

有効なクライアントオプションは次のとおりです: claude、cline、windsurf、roo-cline、witsy、enconvo、cursor

カーソルを使用してインストールする例:

npx -y @smithery/cli install @kelvin6365/plane-mcp-server --client cursor

オプション2: 手動セットアップ

サーバーを手動でセットアップする場合は、次の手順に従ってください。

このリポジトリをクローンします:

git clone https://github.com/kelvin6365/plane-mcp-server.git
cd plane-mcp-server

依存関係をインストールします:

npm install

サーバーを構築します。

npm run build

Claude for Desktop での使用

**注:**上記のオプション 1 (Smithery) を使用した場合は、このセクションをスキップできます。Smithery が MCP サーバーを自動的に構成します。

Claude for Desktop の構成ファイルを開きます。
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Plane MCP サーバー構成を追加します。

{
  "mcpServers": {
    "plane": {
      "command": "node",
      "args": ["path/to/plane-mcp-server/build/index.js"],
      "env": {
        "PLANE_API_KEY": "your_plane_api_key_here",
        "PLANE_WORKSPACE_SLUG": "your_workspace_slug_here"
      }
    }
  }
}

デスクトップ版のClaudeを再起動する

利用可能なツール

**注:**ツール名にはアンダースコアではなくハイフン（例： list-projects ）を使用します。サーバーは互換性を保つため、アンダースコアをハイフンに自動的に変換します。

プロジェクト一覧

Plane ワークスペース内のすべてのプロジェクトを一覧表示します。

パラメータ: なし

例：

{}

プロジェクトを取得

特定のプロジェクトに関する詳細情報を取得します。

パラメータ:

project_id : 取得するプロジェクトのID

例：

{
  "project_id": "01abc123-4567-89de-0123-456789abcdef"
}

問題作成

指定されたプロジェクトに新しい問題を作成します。

パラメータ:

project_id : 問題を作成するプロジェクトのID
name : 問題のタイトル
description_html : 問題の HTML 説明 (Plane API で必須)
priority （オプション）：問題の優先度（「緊急」、「高」、「中」、「低」、「なし」）
state_id (オプション): この問題の状態のID
assignees （オプション）: この問題に割り当てるユーザーIDの配列

注: assigneesパラメータはユーザーID文字列の配列である必要があります。よくあるエラーとしては、配列ではなく辞書/オブジェクトを指定したり、担当者フィールド内に課題データ全体を誤ってネストしたりすることが挙げられます。サーバーはこれらのケースを適切に処理しようとしますが、正しい形式を使用することを推奨します。

例：

{
  "project_id": "01abc123-4567-89de-0123-456789abcdef",
  "name": "Implement new feature",
  "description_html": "<p>We need to implement the new reporting feature</p>",
  "priority": "high",
  "assignees": ["user-id-1", "user-id-2"]
}

リストの問題

オプションのフィルタリングを使用して、指定されたプロジェクトの問題を一覧表示します。

パラメータ:

project_id : 課題を取得するプロジェクトのID
state_id (オプション): 州IDでフィルタリング
priority （オプション）: 優先度でフィルタリング
assignee_id (オプション): 担当者IDでフィルタリング
limit (オプション): 返される問題の最大数 (デフォルト: 50)

例：

{
  "project_id": "01abc123-4567-89de-0123-456789abcdef",
  "priority": "high",
  "limit": 10
}

問題を取得する

特定の問題に関する詳細情報を取得します。

パラメータ:

project_id : 問題を含むプロジェクトのID
issue_id : 取得する問題のID

例：

{
  "project_id": "01abc123-4567-89de-0123-456789abcdef",
  "issue_id": "01def456-7890-12gh-3456-789ijklmnopq"
}

アップデートの問題

プロジェクト内の既存の問題を更新します。

パラメータ:

project_id : 問題を含むプロジェクトのID
issue_id : 更新する問題のID
name （オプション）: 問題の更新されたタイトル
description_html (オプション): 問題の HTML 説明 (Plane API で必須)
priority （オプション）: 問題の更新された優先度
state_id (オプション): 問題の更新された状態ID
assignees （オプション）: この問題に割り当てるユーザーIDの更新された配列

注: assigneesパラメータは、問題作成ツールと同じ形式のガイドラインに従ったユーザー ID 文字列の配列である必要があります。

例：

{
  "project_id": "01abc123-4567-89de-0123-456789abcdef",
  "issue_id": "01def456-7890-12gh-3456-789ijklmnopq",
  "priority": "urgent",
  "description_html": "<p>Updated description with <strong>more details</strong></p>"
}

発達

開発依存関係をインストールします。

npm install --save-dev typescript @types/node

開発モードでサーバーを起動します。

npm run dev

テスト

MCP Inspector を使用してサーバーをテストできます。

npx @modelcontextprotocol/inspector node dist/index.js

例

以下は、Plane MCP サーバーをセットアップした後に Claude と試すことができるやり取りの例です。

「Plane ワークスペース内のすべてのプロジェクトを一覧表示できますか?」
「マーケティングプロジェクトに、「ソーシャルメディア戦略の更新」というタイトルの新しい高優先度の問題を作成してください。」
「開発プロジェクトにおける最優先事項は何ですか？」
「QA プロジェクトの問題 #123 を更新して、優先度を緊急に変更します」

Claude は適切なツールを使用して Plane と対話し、問題を作成または変更する前にユーザーの承認を求めます。

セキュリティに関する考慮事項

APIキーが機能するには適切なPlane権限が必要です
データを変更するすべての操作には、明示的なユーザー承認が必要です。
環境変数は適切に保護する必要がある
APIキーはバージョン管理にコミットしてはならない

貢献

リポジトリをフォークする
機能ブランチを作成します（ git checkout -b feature/amazing-feature ）
変更をコミットします ( git commit -m 'Add some amazing feature' )
ブランチにプッシュする ( git push origin feature/amazing-feature )
プルリクエストを開く

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細については LICENSE ファイルを参照してください。

サポート

問題が発生した場合や質問がある場合は、次の手順に従ってください。

GitHubのIssuesセクションを確認してください
modelcontextprotocol.ioの MCP ドキュメントを参照してください。
詳細な再現手順を記載した新しい問題を開く

Plane MCP Server

Integrations