Plane MCPサーバー

Plane統合のためのModel Context Protocol (MCP) サーバーです。このサーバーは、AIエージェントを通じてPlaneと対話するためのツールとリソースを提供します。

機能

• 🔧 Plane統合: Plane APIおよびサービスとの対話

• 🔌 複数のトランスポート: stdio、SSE、およびストリーミング可能なHTTPトランスポートをサポート

• 🌐 リモート＆ローカル: ローカルおよびリモートサービスの両方で動作

• 🛠️ 拡張性: 新しいツールやリソースの追加が容易

Related MCP server: claude-plane

使用方法

このサーバーは3つのトランスポート方式をサポートしています。インストールが不要なため、uvxの使用を推奨します。

1. Stdioトランスポート（ローカル使用向け）

MCPクライアント設定 (uvxを使用 - 推奨):

{
  "mcpServers": {
    "plane": {
      "command": "uvx",
      "args": ["plane-mcp-server", "stdio"],
      "env": {
        "PLANE_API_KEY": "<your-api-key>",
        "PLANE_WORKSPACE_SLUG": "<your-workspace-slug>",
        "PLANE_BASE_URL": "https://api.plane.so"
      }
    }
  }
}

2. OAuthを使用したリモートHTTPトランスポート

OAuth認証を使用して、ホストされているPlane MCPサーバーに接続します。

URL: https://mcp.plane.so/http/mcp

MCPクライアント設定 (ネイティブのリモートMCPサポートがないClaude Desktopなどのツール向け):

{
  "mcpServers": {
    "plane": {
      "command": "npx",
      "args": ["mcp-remote@latest", "https://mcp.plane.so/http/mcp"]
    }
  }
}

注意: リモートサーバーへの接続時、OAuth認証は自動的に処理されます。

3. PATトークンを使用したリモートHTTPトランスポート

パーソナルアクセストークン (PAT) を使用して、ホストされているPlane MCPサーバーに接続します。

URL: https://mcp.plane.so/api-key/mcp

ヘッダー:

• Authorization: Bearer <PAT_TOKEN>

• X-Workspace-slug: <SLUG>

MCPクライアント設定 (ネイティブのリモートMCPサポートがないClaude Desktopなどのツール向け):

{
  "mcpServers": {
    "plane": {
      "command": "npx",
      "args": ["mcp-remote@latest", "https://mcp.plane.so/http/api-key/mcp"],
      "headers": {
        "Authorization": "Bearer <PAT_TOKEN>",
        "X-Workspace-slug": "<SLUG>"
      }
    }
  }
}

4. SSEトランスポート (レガシー)

⚠️ レガシーなトランスポート: SSE (Server-Sent Events) トランスポートは後方互換性のために維持されています。新規の実装では、代わりにHTTPトランスポート（セクション2または3）を使用してください。

Server-Sent Eventsを介したOAuth認証を使用して、ホストされているPlane MCPサーバーに接続します。

URL: https://mcp.plane.so/sse

MCPクライアント設定 (SSEトランスポートをサポートするツール向け):

{
  "mcpServers": {
    "plane": {
      "command": "npx",
      "args": ["mcp-remote@latest", "https://mcp.plane.so/sse"]
    }
  }
}

注意: リモートサーバーへの接続時、OAuth認証は自動的に処理されます。このトランスポートはHTTPトランスポートを優先するため、非推奨となっています。

設定

認証

サーバーは環境変数による認証を必要とします:

• PLANE_BASE_URL: Plane APIのベースURL (デフォルト: https://api.plane.so) - オプション

• PLANE_API_KEY: 認証用APIキー (stdioトランスポートで必須)

• PLANE_WORKSPACE_SLUG: ワークスペースのスラッグ識別子 (stdioトランスポートで必須)

• PLANE_ACCESS_TOKEN: 認証用アクセストークン (APIキーの代替)

例 (stdioトランスポートの場合):

export PLANE_BASE_URL="https://api.plane.so"
export PLANE_API_KEY="your-api-key"
export PLANE_WORKSPACE_SLUG="your-workspace-slug"

注意: リモートHTTPトランスポート（OAuthまたはPAT）の場合、認証は接続方法（OAuthフローまたはPATヘッダー）を介して処理されるため、これらの環境変数は不要です。

利用可能なツール

このサーバーは、Planeと対話するための包括的なツールを提供します。すべてのツールは、型安全性と検証のためにPlane SDKのPydanticモデルを使用しています。

プロジェクト

作業項目 (Work Items)

サイクル

モジュール

イニシアチブ

インテーク作業項目

作業項目のプロパティ

ユーザー

合計ツール数: 8カテゴリーで55以上のツール

開発

テストの実行

pytest

コードフォーマット

black plane_mcp/
ruff check plane_mcp/

ライセンス

MITライセンス - 詳細はLICENSEを参照してください。

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

非推奨通知

⚠️ Node.jsベースの plane-mcp-server は非推奨となり、メンテナンスは終了しました。

このリポジトリは、Python + FastMCPベースの新しいPlane MCPサーバー実装です。以前のNode.jsバージョンを使用していた場合は、継続的なサポートとアップデートのために、このPythonベースのバージョンへ移行してください。

新しい実装の利点:

• Pydanticモデルによる優れた型安全性

• FastMCPによるパフォーマンスの向上

• ツールカバレッジの強化

• アクティブなメンテナンスと開発

移行のサポートについては、このREADMEの設定例を参照するか、サポートのためにIssueを開いてください。

古いNode.js設定 (非推奨):

以前のNode.jsベースの @makeplane/plane-mcp-server を使用していた場合、設定は以下のようになっていました:

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

上記の「使用方法」セクションに示されている新しいPythonベースの設定へ移行してください。