Bir AI istemcisinin 30 araç aracılığıyla Plane projelerini, iş öğelerini, döngülerini, modüllerini, sürümlerini ve müşterilerini okumasını ve yönetmesini sağlar.
Ayrıca bilinen adı makeplane/plane-mcp-server
- Yıldızlar
- 364
- Araçlar
- —
- İndirmeler, 30 gün
- —
- En son sürüm
- —
- Son commit
- 11 Kas 2026
- Lisans
- MIT
Plane MCP nedir?
Bir AI istemcisinin 30 araç aracılığıyla Plane projelerini, iş öğelerini, döngülerini, modüllerini, sürümlerini ve müşterilerini okumasını ve yönetmesini sağlar.
Özet, projenin README dosyasından oluşturuldu
Plane MCP sunucusu hakkında
Bu sunucu, Plane kullanan ekiplerin proje iş akışlarını ve iş öğelerini doğrudan bir AI agent üzerinden yönetmesini sağlar. AI istemciniz ile proje yönetimi verileriniz arasında bir köprü kurarak projelerin, döngülerin, modüllerin, sürümlerin ve müşterilerin okunmasına ve yönetilmesine olanak tanır. Sunucu, 207 farklı işlemi kapsayan 30 özelleşmiş araç sunarak karmaşık görevlerin doğal dil aracılığıyla gerçekleştirilmesini mümkün kılar.
Geliştiriciler bu sunucuyu PLANE_API_KEY ve PLANE_WORKSPACE_SLUG kullanarak stdio üzerinden yerel olarak çalıştırabilir veya OAuth ya da kişisel erişim jetonlarını kullanarak barındırılan sürümlere bağlanabilirler. Sunucu, streamable HTTP ve SSE taşıma protokolleri dahil olmak üzere hem yerel hem de uzak kurulumları destekler. Kendi sunucusunda barındırılan Plane örneklerini kullananlar için PLANE_BASE_URL değişkeni, özel bir sunucu adresine kolayca yönlendirme yapılmasına imkan tanır. Uygulama, çalışma alanı kaynaklarınızla güvenilir etkileşim sağlamak için FastMCP ve resmi plane-sdk üzerine inşa edilmiştir.
Neler yapabilirsiniz
- 1Görev oluşturma otomasyonuBir hata düzeltmesini takip etmek için belirli bir proje için yeni bir iş öğesi oluşturması üzere bir AI agent'a talimat verin.
- 2Proje döngülerini yönetmeÇalışma alanınızı düzenli tutmak için tamamlanmış geliştirme döngülerini arşivlemesi için bir AI istemcisi kullanın.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Yapılandırma
LOG_PAYLOADSLOG_USER_INFOPLANE_API_KEYPLANE_BASE_URLPLANE_OAUTH_ALLOWED_REDIRECT_URISPLANE_TEST_API_KEYPLANE_TEST_MCP_URLPLANE_WORKSPACE_SLUG
| Ad | Açıklama | Sunucu |
|---|---|---|
| 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 | — |
Otomatik kontroller
Çalıştırıldı 12 Kas 2026Tam rapor →Henüz doğrulanmadı. Bir sunucunun 80 puana, ciddi bir bulgu olmamasına ve kontrol edebilmemiz için yeterli veriye ihtiyacı vardır. Kontroller nasıl çalışır · Daha fazla puan için nelerin düzeltileceği
- Kaynak deposu bağlantılı ve erişilebilirGeçti
- Açık kaynak lisansı (OSI)Geçti
- Son bir yıl içinde commit veya sürüm mevcutGeçti
- Paket adı popüler bir pakete yakın değilKontrol edilmedi
- Uzak uç nokta HTTPS kullanıyorKontrol edilmedi
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Modele yönelik gizli talimat yokGeçti
- Pakette veya bağımlılıklarında kritik uyarı yokKontrol edilmedi
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 soruları
Plane MCP server'ını bir API anahtarı ile nasıl bağlarım?
Sunucuyu uvx ile stdio üzerinden yerel olarak çalıştırın ve MCP istemcinizin env yapılandırmasında PLANE_API_KEY ile PLANE_WORKSPACE_SLUG değerlerini ayarlayın. Python 3.10+ gereklidir.
İş öğelerini bir sorgu dili ile filtreleyebilir miyim?
Evet; list, count ve search komutları Plane'in sorgu dili olan PQL'i kabul eder. Tam sözdizimi ve örnekler için get_pql_reference komutunu çağırabilirsiniz.
Plane MCP server kaç araç sunuyor?
Her biri bir Plane kaynağına karşılık gelen ve toplamda 207 işlemi kapsayan aksiyon parametresine sahip 30 araç sunmaktadır.
Kendi sunucumda barındırdığım (self-hosted) bir Plane örneğini kullanabilir miyim?
Evet, stdio üzerinden çalıştırırken PLANE_BASE_URL değerini kendi örneğinizin API URL'si olarak ayarlayın.