30개의 도구를 통해 AI 클라이언트가 Plane 프로젝트, 작업 항목, 사이클, 모듈, 릴리스 및 고객을 읽고 관리할 수 있습니다.
다른 이름 makeplane/plane-mcp-server
- 스타
- 364
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 11월 11일
- 라이선스
- MIT
Plane MCP란?
30개의 도구를 통해 AI 클라이언트가 Plane 프로젝트, 작업 항목, 사이클, 모듈, 릴리스 및 고객을 읽고 관리할 수 있습니다.
프로젝트 README에서 생성된 요약
Plane MCP server 정보
이 서버는 Plane을 사용하는 팀이 AI 에이전트에서 프로젝트 워크플로와 작업 항목을 직접 관리할 수 있도록 지원합니다. AI 클라이언트와 프로젝트 관리 데이터 사이의 가교 역할을 하여 프로젝트, 사이클, 모듈, 릴리스 및 고객 데이터를 읽고 관리할 수 있습니다. 207가지의 다양한 작업을 수행할 수 있는 30개의 특화된 도구를 제공하므로 자연어를 통해 복잡한 업무를 처리할 수 있습니다.
개발자는 PLANE_API_KEY와 PLANE_WORKSPACE_SLUG를 사용하여 stdio를 통해 이 서버를 로컬에서 실행하거나, OAuth 또는 개인 액세스 토큰을 사용하여 호스팅된 버전에 연결할 수 있습니다. streamable HTTP 및 SSE 전송을 포함하여 로컬 및 원격 설정을 모두 지원합니다. 셀프 호스팅 Plane 인스턴스를 사용하는 경우 PLANE_BASE_URL 변수를 통해 프라이빗 서버 주소로 쉽게 리다이렉션할 수 있습니다. 이 구현체는 FastMCP와 공식 plane-sdk를 기반으로 구축되어 워크스페이스 리소스와 안정적인 상호작용을 보장합니다.
활용 사례
- 1작업 생성 자동화AI 에이전트에게 특정 프로젝트의 버그 수정을 추적하기 위한 새로운 작업 항목을 생성하도록 지시합니다.
- 2프로젝트 사이클 관리AI 클라이언트를 사용하여 완료된 개발 사이클을 아카이브함으로써 워크스페이스를 체계적으로 유지합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
구성
LOG_PAYLOADSLOG_USER_INFOPLANE_API_KEYPLANE_BASE_URLPLANE_OAUTH_ALLOWED_REDIRECT_URISPLANE_TEST_API_KEYPLANE_TEST_MCP_URLPLANE_WORKSPACE_SLUG
| 이름 | 설명 | 유형 |
|---|---|---|
| LOG_PAYLOADS | — | |
| LOG_USER_INFO | — | |
| PLANE_API_KEY | — | |
| PLANE_BASE_URL | — | |
| PLANE_OAUTH_ALLOWED_REDIRECT_URIS | — | |
| PLANE_TEST_API_KEY | — | |
| PLANE_TEST_MCP_URL | — | |
| PLANE_WORKSPACE_SLUG | — |
자동 검사
2026년 11월 12일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능통과
- 오픈 소스 라이선스 (OSI)통과
- 최근 1년 내 커밋 또는 릴리스통과
- 패키지 이름이 인기 패키지와 유사하지 않음검사되지 않음
- 원격 엔드포인트가 HTTPS 사용검사되지 않음
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 모델에 대한 숨겨진 지침 없음통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
README
GitHub에서 보기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": "<your-api-key>",
"PLANE_WORKSPACE_SLUG": "<your-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
| Header | Value |
|---|---|
Authorization |
Bearer <PAT> |
X-Workspace-slug |
<workspace-slug> |
{
"mcpServers": {
"plane": {
"command": "npx",
"args": ["mcp-remote@latest", "https://mcp.plane.so/http/api-key/mcp"],
"headers": {
"Authorization": "Bearer <PAT>",
"X-Workspace-slug": "<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"')
workitem(action="count", pql='assignees__id = "<member id>"', group_by="state_id")
Call get_pql_reference for the full syntax, operators and worked examples.
Upgrading from the per-operation tools
Earlier releases exposed one tool per API operation. Existing integrations keep
working: 169 of those 177 names still resolve to the consolidated tool, so a
saved prompt or script calling create_work_item or list_cycles needs no
change. They are no longer advertised, and they keep the parameter names they
shipped with (work_item_id, not workitem_id).
Seven names chose between two operations with a parameter
(manage_project_archive(archive=False)), which one tool-and-action pair cannot
reproduce; calling one tells you its replacement. get_pql_reference is
unchanged.
Configuration
Authentication
| Variable | Required for | Purpose |
|---|---|---|
PLANE_API_KEY |
stdio | API key |
PLANE_WORKSPACE_SLUG |
stdio | Target workspace |
PLANE_BASE_URL |
optional | Plane API URL (default https://api.plane.so) |
The remote transports carry credentials in the connection — the OAuth flow or the PAT headers — and need none of these.
Outbound proxy for attachment uploads
HTTP_PROXY / HTTPS_PROXY / NO_PROXY (and their lowercase forms) are honored
for the attachment-upload-from-URL fetch (upload_from_url). When a proxy
applies to a given request, the proxy — not this server — is that request's
SSRF control: the server does not pin or validate the target's resolved
address itself, since the proxy connects to and resolves the target
independently. Scope NO_PROXY and proxy egress policy accordingly.
Self-hosting the server itself:
| Variable | Purpose |
|---|---|
PLANE_INTERNAL_BASE_URL |
Internal URL for server-to-server calls, preferred over PLANE_BASE_URL |
REDIS_URL |
OAuth token storage as one connection URL (redis:// or rediss:// for TLS); wins over host/port |
REDIS_HOST / REDIS_PORT |
OAuth token storage; falls back to in-memory |
PLANE_OAUTH_PROVIDER_* |
OAuth client credentials and base URL |
MCP_PATH_PREFIX |
Path prefix for the HTTP routes, when mounted behind a proxy — /plane serves /plane/http/mcp |
OAuth redirect URIs
The OAuth transports validate each client's redirect URI against an allowlist. Common clients (Cursor, VS Code, Claude.ai, ChatGPT connectors, localhost) are allowed by default.
To onboard a new client without a release, append patterns:
export PLANE_OAUTH_ALLOWED_REDIRECT_URIS="https://newclient.com/cb,https://other.app/oauth/*"
* matches any port, path segment or subdomain. Keep the host pinned and
wildcard only the port or path.
Logging
Structured JSON. Each tool call logs its name, duration, status and — when available — an opaque user id and the workspace slug.
export LOG_USER_INFO=false # also log the display name (PII);
export LOG_PAYLOADS=false # keep request payloads out of logs; default true
Only the OAuth and PAT transports carry a display name; stdio is unaffected.
Development
git clone https://github.com/makeplane/plane-mcp-server
cd plane-mcp-server
uv pip install -e ".[dev]"
Run the server against a workspace:
PLANE_API_KEY=... PLANE_WORKSPACE_SLUG=... python -m plane_mcp stdio
python -m plane_mcp http # port 8211
Tests, format, lint:
pytest # no network or credentials needed
ruff format plane_mcp/ tests/ # line length 120
ruff check plane_mcp/ tests/ # rules E, F, I, UP, B
The suite runs fully offline — every action of every resource is
executed against a stand-in that binds each call against the genuine plane-sdk
signature. See plane_mcp/tools/README.md.
Live integration tests are skipped unless you point them at a running server:
export PLANE_TEST_API_KEY=... PLANE_TEST_WORKSPACE_SLUG=...
export PLANE_TEST_MCP_URL=http://localhost:8211 # optional; this is the default
pytest tests/test_integration.py -v
They write real data to that workspace.
Repository layout
| Path | Contents |
|---|---|
plane_mcp/__main__.py |
entry point; picks the transport from argv[1] |
plane_mcp/server.py |
one factory per transport |
plane_mcp/client.py |
resolves credentials into a plane-sdk client |
plane_mcp/auth/ |
OAuth provider and header auth |
plane_mcp/tools/ |
the tool surface: one module per Plane resource |
plane_mcp/toolkit/ |
shared building blocks for the tool surface |
plane_mcp/pql_reference.py |
PQL syntax reference served to models |
Contributing
Pull requests welcome. Please run pytest and ruff check before submitting; new
tools should come with the invariants described in
plane_mcp/tools/README.md.
See CONTRIBUTING.md and CODE_OF_CONDUCT.md.
Migrating from the Node.js server
@makeplane/plane-mcp-server (Node.js) is deprecated and unmaintained. This
Python implementation replaces it.
| Node.js | Python |
|---|---|
PLANE_API_KEY |
PLANE_API_KEY |
PLANE_API_HOST_URL |
PLANE_BASE_URL |
PLANE_WORKSPACE_SLUG |
PLANE_WORKSPACE_SLUG |
Replace the command and args with the stdio configuration in
Quick start.
License
MIT — see LICENSE.
Plane MCP 질문
API 키로 Plane MCP server를 어떻게 연결하나요?
uvx를 사용하여 로컬에서 stdio 방식으로 서버를 실행하고, MCP 클라이언트의 환경 설정에 PLANE_API_KEY와 PLANE_WORKSPACE_SLUG를 설정하십시오. Python 3.10 이상 버전이 필요합니다.
쿼리 언어로 작업 항목을 필터링할 수 있나요?
네, list, count, search 기능에서 Plane의 쿼리 언어인 PQL을 사용할 수 있습니다. 전체 구문과 예시는 get_pql_reference를 호출하여 확인할 수 있습니다.
Plane MCP server는 몇 개의 도구를 제공하나요?
Plane 리소스당 하나씩, 총 30개의 도구를 제공하며 각 도구의 action 파라미터를 통해 총 207개의 작업을 수행할 수 있습니다.
셀프 호스팅 중인 Plane 인스턴스를 사용할 수 있나요?
네, stdio 방식으로 실행할 때 PLANE_BASE_URL을 해당 인스턴스의 API URL로 설정하십시오.