Plane MCP Server

Сервер протокола контекста модели (MCP) для интеграции с Plane. Этот сервер предоставляет инструменты и ресурсы для взаимодействия с Plane через ИИ-агентов.

Возможности

• 🔧 Интеграция с Plane: Взаимодействие с API и сервисами Plane

• 🔌 Множественные транспорты: Поддержка stdio, SSE и потоковых HTTP-транспортов

• 🌐 Удаленная и локальная работа: Работает как локально, так и в качестве удаленного сервиса

• 🛠️ Расширяемость: Легко добавлять новые инструменты и ресурсы

Related MCP server: claude-plane

Использование

Сервер поддерживает три метода транспорта. Мы рекомендуем использовать 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. Удаленный HTTP-транспорт с OAuth

Подключитесь к размещенному серверу Plane MCP с помощью аутентификации OAuth.

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

Конфигурация MCP-клиента (для таких инструментов, как Claude Desktop, без встроенной поддержки удаленного MCP):

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

Примечание: Аутентификация OAuth будет выполнена автоматически при подключении к удаленному серверу.

3. Удаленный HTTP-транспорт с использованием PAT-токена

Подключитесь к размещенному серверу Plane MCP с помощью персонального токена доступа (PAT).

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

Заголовки:

• Authorization: Bearer <PAT_TOKEN>

• X-Workspace-slug: <SLUG>

Конфигурация MCP-клиента (для таких инструментов, как Claude Desktop, без встроенной поддержки удаленного MCP):

{
  "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).

Подключитесь к размещенному серверу Plane MCP с помощью аутентификации OAuth через Server-Sent Events.

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: Базовый URL для API Plane (по умолчанию: https://api.plane.so) — необязательно

• PLANE_API_KEY: API-ключ для аутентификации (обязательно для stdio-транспорта)

• PLANE_WORKSPACE_SLUG: Идентификатор (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. Все инструменты используют модели Pydantic из SDK Plane для обеспечения безопасности типов и валидации.

Проекты

Рабочие элементы (Work Items)

Циклы (Cycles)

Модули

Инициативы

Входящие рабочие элементы (Intake)

Свойства рабочих элементов

Пользователи

Всего инструментов: 55+ в 8 категориях

Разработка

Запуск тестов

pytest

Форматирование кода

black plane_mcp/
ruff check plane_mcp/

Лицензия

Лицензия MIT — подробности см. в файле LICENSE.

Участие в разработке

Мы приветствуем ваш вклад! Пожалуйста, не стесняйтесь отправлять Pull Request.

Уведомление об устаревании

⚠️ Сервер plane-mcp-server на базе Node.js устарел и больше не поддерживается.

Этот репозиторий представляет новую реализацию сервера Plane MCP на базе Python+FastMCP. Если вы использовали предыдущую версию на Node.js, пожалуйста, перейдите на эту версию на Python для получения дальнейшей поддержки и обновлений.

Новая реализация предлагает:

• Лучшую безопасность типов с моделями Pydantic

• Улучшенную производительность с FastMCP

• Расширенный охват инструментов

• Активную поддержку и разработку

За помощью при миграции обратитесь к примерам конфигурации в этом README или создайте issue для получения поддержки.

Старая конфигурация Node.js (устарела):

Если вы использовали предыдущий @makeplane/plane-mcp-server на базе Node.js, ваша конфигурация выглядела так:

{
  "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, показанную в разделе «Использование» выше.