Сервер MCP Plane

Сервер Model Context Protocol (MCP), который позволяет LLM взаимодействовать с Plane.so , позволяя им управлять проектами и проблемами через API Plane. Используя этот сервер, LLM, такие как Клод, могут напрямую взаимодействовать с вашими рабочими процессами управления проектами, сохраняя при этом контроль и безопасность пользователя.

Функции

Перечислите все проекты в вашем рабочем пространстве Plane
Получите подробную информацию о конкретных проектах
Создавайте новые выпуски с настраиваемыми свойствами
Список и фильтрация проблем из проектов
Получите подробную информацию о конкретных проблемах
Обновите существующие выпуски, добавив новую информацию

Предпосылки

Node.js 22.x или выше
API-ключ Plane.so
Рабочее пространство Plane.so

Установка

Вариант 1: Использование кузнечного дела

Самый быстрый способ начать работу — использовать Smithery для непосредственной установки сервера:

# Install to Claude for Desktop
npx -y @smithery/cli install @kelvin6365/plane-mcp-server --client claude

Эта команда автоматически настроит сервер Plane MCP для использования с Claude. После установки вам нужно будет настроить сервер с помощью ключа API Plane и слага рабочей области через настройки Claude.

Допустимые параметры клиента: claude, cline, windsurf, roo-cline, witsy, enconvo, cursor

Пример установки с помощью курсора:

npx -y @smithery/cli install @kelvin6365/plane-mcp-server --client cursor

Вариант 2: Ручная настройка

Если вы предпочитаете настроить сервер вручную, выполните следующие действия:

Клонируйте этот репозиторий:

git clone https://github.com/kelvin6365/plane-mcp-server.git
cd plane-mcp-server

Установите зависимости:

npm install

Сборка сервера:

npm run build

Использование с Claude для рабочего стола

Примечание: Если вы использовали вариант 1 (Smithery) выше, вы можете пропустить этот раздел. Smithery автоматически настраивает сервер MCP для вас.

Откройте файл конфигурации Claude for Desktop:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Добавьте конфигурацию сервера Plane MCP:

{
  "mcpServers": {
    "plane": {
      "command": "node",
      "args": ["path/to/plane-mcp-server/build/index.js"],
      "env": {
        "PLANE_API_KEY": "your_plane_api_key_here",
        "PLANE_WORKSPACE_SLUG": "your_workspace_slug_here"
      }
    }
  }
}

Перезапустить Клода для рабочего стола

Доступные инструменты

Примечание: Имена инструментов используют дефисы (например, list-projects ), а не подчеркивания. Сервер автоматически преобразует подчеркивания в дефисы для совместимости.

список-проекты

Перечисляет все проекты в вашем рабочем пространстве Plane.

Параметры: Нет

Пример:

{}

получить-проект

Получает подробную информацию о конкретном проекте.

Параметры:

project_id : идентификатор проекта для извлечения

Пример:

{
  "project_id": "01abc123-4567-89de-0123-456789abcdef"
}

создать-выпуск

Создает новую проблему в указанном проекте.

Параметры:

project_id : идентификатор проекта, в котором должна быть создана проблема
name : Название выпуска
description_html : HTML-описание проблемы (требуется для API Plane)
priority (необязательно): Приоритет вопроса («срочный», «высокий», «средний», «низкий», «нет»)
state_id (необязательно): идентификатор штата для этой проблемы
assignees (необязательно): массив идентификаторов пользователей, назначаемых для этой проблемы

Примечание: Параметр assignees должен быть массивом строк идентификатора пользователя. Распространенные ошибки включают предоставление словаря/объекта вместо массива или случайное вложение всех данных о проблеме в поле assignees. Сервер попытается обработать эти случаи, но лучше использовать правильный формат.

Пример:

{
  "project_id": "01abc123-4567-89de-0123-456789abcdef",
  "name": "Implement new feature",
  "description_html": "<p>We need to implement the new reporting feature</p>",
  "priority": "high",
  "assignees": ["user-id-1", "user-id-2"]
}

список-вопросов

Перечисляет проблемы из указанного проекта с возможностью фильтрации.

Параметры:

project_id : идентификатор проекта, из которого нужно получить проблемы
state_id (необязательно): Фильтр по идентификатору штата
priority (необязательно): Фильтр по приоритету
assignee_id (необязательно): Фильтр по идентификатору получателя
limit (необязательно): максимальное количество возвращаемых проблем (по умолчанию: 50)

Пример:

{
  "project_id": "01abc123-4567-89de-0123-456789abcdef",
  "priority": "high",
  "limit": 10
}

получить-выпуск

Получает подробную информацию о конкретной проблеме.

Параметры:

project_id : идентификатор проекта, содержащего проблему
issue_id : идентификатор проблемы, которую необходимо получить

Пример:

{
  "project_id": "01abc123-4567-89de-0123-456789abcdef",
  "issue_id": "01def456-7890-12gh-3456-789ijklmnopq"
}

обновление-выпуск

Обновляет существующую проблему в проекте.

Параметры:

project_id : идентификатор проекта, содержащего проблему
issue_id : идентификатор проблемы для обновления
name (необязательно): обновленное название выпуска
description_html (необязательно): HTML-описание проблемы (требуется для API Plane)
priority (необязательно): обновленный приоритет проблемы
state_id (необязательно): обновленный идентификатор состояния проблемы
assignees (необязательно): обновленный массив идентификаторов пользователей для назначения этой проблеме

Примечание: Параметр assignees должен быть массивом строк идентификаторов пользователей, соответствующим тем же правилам форматирования, что и для инструмента создания проблем.

Пример:

{
  "project_id": "01abc123-4567-89de-0123-456789abcdef",
  "issue_id": "01def456-7890-12gh-3456-789ijklmnopq",
  "priority": "urgent",
  "description_html": "<p>Updated description with <strong>more details</strong></p>"
}

Разработка

Установка зависимостей разработки:

npm install --save-dev typescript @types/node

Запустите сервер в режиме разработки:

npm run dev

Тестирование

Вы можете протестировать сервер с помощью MCP Inspector:

npx @modelcontextprotocol/inspector node dist/index.js

Примеры

Вот несколько примеров взаимодействия, которые вы можете попробовать с Клодом после настройки сервера Plane MCP:

«Можете ли вы составить список всех проектов в моем рабочем пространстве Plane?»
«Пожалуйста, создайте новую высокоприоритетную задачу в маркетинговом проекте под названием «Обновление стратегии социальных сетей»»
«Каковы наиболее приоритетные вопросы в проекте развития?»
«Обновить задачу № 123 в проекте QA, изменив ее приоритет на срочный»

Клод будет использовать соответствующие инструменты для взаимодействия с Plane, запрашивая ваше одобрение перед созданием или изменением любых задач.

Соображения безопасности

Для работы API-ключа требуются соответствующие разрешения Plane.
Все операции, изменяющие данные, требуют явного одобрения пользователя.
Переменные среды должны быть надежно защищены.
Ключи API никогда не следует передавать в систему контроля версий.

Внося вклад

Форк репозитория
Создайте ветку функций ( git checkout -b feature/amazing-feature )
Зафиксируйте свои изменения ( git commit -m 'Add some amazing feature' )
Отправить в ветку ( git push origin feature/amazing-feature )
Открыть запрос на извлечение

Лицензия

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

Поддерживать

Если у вас возникли проблемы или есть вопросы:

Проверьте раздел GitHub Issues
Ознакомьтесь с документацией MCP на сайте modelcontextprotocol.io.
Откройте новый выпуск с подробными шагами воспроизведения

Plane MCP Server

Integrations