모델 컨텍스트 프로토콜 서버 플레인. AI 에이전트가 프로젝트를 읽고 관리할 수 있는 도구를 제공합니다. 작업 항목, 사이클, 모듈, 릴리스, 고객 등 다양한 항목들이 포함됩니다.

FastMCP와 공식 plane-sdk.

• 30개의 도구, 평면 자원당 하나씩, 207개의 작업 포함
• 로컬 또는 원격 — stdio, 스트리밍 가능한 HTTP, SSE
• OAuth 또는 API 키 인증.

퀵 스타트

Plane에서 API 키를 받아보세요: Workspace Settings → API 토큰.

MCP 클라이언트 구성에 다음을 추가하세요:

uvx는 설치 단계가 필요 없습니다. Python 3.10+가 필요합니다.

자체 호스팅 플레인을 위해서는 "PLANE_BASE_URL": "https://plane.example.com"를 추가하세요.

수송

Stdio — 로컬

MCP 클라이언트의 하위 프로세스로 실행됩니다. 위에 나타난 구성; 필요 PLANE_API_KEY 그리고 PLANE_WORKSPACE_SLUG.

OAuth와 함께하는 HTTP — 호스팅

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

OAuth 흐름은 connect에서 처리되며; 설정에는 자격 증명이 없습니다. 클라이언트를 위해 네이티브 원격 MCP 지원이 없을 때, mcp-remote와 브리지:

22+ Node.js 필요합니다.

개인 액세스 토큰을 가진 HTTP — 호스팅

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

Plane MCP Server

A Model Context Protocol server for Plane. Gives an AI agent tools to read and manage projects, work items, cycles, modules, releases, customers and more.

Built on FastMCP and the official plane-sdk.

• 30 tools, one per Plane resource, covering 207 operations
• Local or remote — stdio, streamable HTTP, SSE
• OAuth or API key authentication

Quick start

Get an API key from Plane: Workspace Settings → API tokens.

Add this to your MCP client’s configuration:

{
  "mcpServers": {
    "plane": {
      "command": "uvx",
      "args": ["plane-mcp-server", "stdio"],
      "env": {
        "PLANE_API_KEY": "",
        "PLANE_WORKSPACE_SLUG": ""
      }
    }
  }
}

uvx needs no install step. Requires Python 3.10+.

For a self-hosted Plane, add "PLANE_BASE_URL": "https://plane.example.com".

Transports

stdio — local

Runs as a subprocess of your MCP client. Configuration as shown above; needs PLANE_API_KEY and PLANE_WORKSPACE_SLUG.

PLANE_API_KEY=... PLANE_WORKSPACE_SLUG=... uvx plane-mcp-server stdio

HTTP with OAuth — hosted

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

The OAuth flow is handled on connect; no credentials in your config. For clients without native remote MCP support, bridge with mcp-remote:

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

Requires Node.js 22+.

HTTP with a personal access token — hosted

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

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

SSE — deprecated

https://mcp.plane.so/sse is maintained for backward compatibility only. Use an HTTP transport instead.

Tools

The server advertises 30 tools, one per resource. Each takes an action parameter that selects the operation:

workitem(action="create", project_id=..., name="Fix login")
workitem(action="list", project_id=..., pql='state__group = "started"')
cycle(action="archive", project_id=..., cycle_id=...)

Every tool’s description lists its actions with their required and optional parameters, so the catalogue is self-documenting at call time.

→ Full tool and action reference

Querying work items

List, count and search accept PQL, Plane’s query language:

workitem(action="list", project_id=..., pql='state__group = "started" AND priority = "urgent"')