飛行機MCPサーバー

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

特徴

• 平面ワークスペース内のすべてのプロジェクトを一覧表示する

• 特定のプロジェクトに関する詳細情報を入手する

• カスタマイズ可能なプロパティで新しい問題を作成する

• プロジェクトからの問題の一覧表示とフィルタリング

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

• 既存の問題を新しい情報で更新する

前提条件

• Node.js 22.x 以上

• Plane.so APIキー

• Plane.so ワークスペース

インストール

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

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

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

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

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

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

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

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

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

3. サーバーを構築します。

Claude for Desktop での使用

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

1. Claude for Desktop の構成ファイルを開きます。

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Plane MCP サーバー構成を追加します。

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

利用可能なツール

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

プロジェクト一覧

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

パラメータ: なし

例：

プロジェクトを取得

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

パラメータ:

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

例：

問題作成

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

パラメータ:

• project_id : 問題を作成するプロジェクトのID

• name : 問題のタイトル

• description_html : 問題の HTML 説明 (Plane API で必須)

• priority （オプション）：問題の優先度（「緊急」、「高」、「中」、「低」、「なし」）

• state_id (オプション): この問題の状態のID

• assignees （オプション）: この問題に割り当てるユーザーIDの配列

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

例：

リストの問題

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

パラメータ:

• project_id : 課題を取得するプロジェクトのID

• state_id (オプション): 州IDでフィルタリング

• priority （オプション）: 優先度でフィルタリング

• assignee_id (オプション): 担当者IDでフィルタリング

• limit (オプション): 返される問題の最大数 (デフォルト: 50)

例：

問題を取得する

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

パラメータ:

• project_id : 問題を含むプロジェクトのID

• issue_id : 取得する問題のID

例：

アップデートの問題

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

パラメータ:

• project_id : 問題を含むプロジェクトのID

• issue_id : 更新する問題のID

• name （オプション）: 問題の更新されたタイトル

• description_html (オプション): 問題の HTML 説明 (Plane API で必須)

• priority （オプション）: 問題の更新された優先度

• state_id (オプション): 問題の更新された状態ID

• assignees （オプション）: この問題に割り当てるユーザーIDの更新された配列

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

例：

発達

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

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

テスト

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

例

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

1. 「Plane ワークスペース内のすべてのプロジェクトを一覧表示できますか?」

2. 「マーケティング プロジェクトに、「ソーシャル メディア戦略の更新」というタイトルの新しい高優先度の問題を作成してください。」

3. 「開発プロジェクトにおける最優先事項は何ですか？」

4. 「QA プロジェクトの問題 #123 を更新して、優先度を緊急に変更します」

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

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

• APIキーが機能するには適切なPlane権限が必要です

• データを変更するすべての操作には、明示的なユーザー承認が必要です。

• 環境変数は適切に保護する必要がある

• APIキーはバージョン管理にコミットしてはならない

貢献

1. リポジトリをフォークする

2. 機能ブランチを作成します（ git checkout -b feature/amazing-feature ）

3. 変更をコミットします ( git commit -m 'Add some amazing feature' )

4. ブランチにプッシュする ( git push origin feature/amazing-feature )

5. プルリクエストを開く

ライセンス

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

サポート

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

1. GitHubのIssuesセクションを確認してください

2. modelcontextprotocol.ioの MCP ドキュメントを参照してください。

3. 詳細な再現手順を記載した新しい問題を開く

スターの歴史