Сервер протокола контекста модели для Plane. Даёт агенту ИИ инструменты для чтения и управления проектами, Рабочие элементы, циклы, модули, релизы, клиенты и многое другое.

Построено на FastMCP и официальном plane-sdk.

• 30 инструментов, по одному на ресурс Плоскости, охватывающий 207 операций
• Локальный или удалённый — stdio, потоковый HTTP, SSE
• OAuth или API аутентификация

Быстрый старт

Получите API-ключ из Plane: Настройки рабочего пространства → API токёны.

Добавьте это в конфигурацию вашего MCP-клиента:

uvx не требует этапа установки. Требуется Python 3.10+.

Для самостоятельного самостоятельного самолёта добавьте "PLANE_BASE_URL": "https://plane.example.com".

Транспорты

stdio — локальный

Работает как подпроцесс вашего MCP-клиента. Конфигурация, как показано выше; потребности PLANE_API_KEY и PLANE_WORKSPACE_SLUG.

HTTP с OAuth — хостинг

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

Поток OAuth обрабатывается через Connect; в вашей конфигурации нет учетных данных. Для клиентов без поддержки нативного удаленного MCP — мост с mcp-remote:

Требуется Node.js 22+.

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"')