ProductPlan MCP Server

Управляйте своими дорожными картами с помощью ИИ. Задавайте вопросы, создавайте идеи, проверяйте прогресс по OKR и управляйте запусками в ходе естественного общения с Claude, Cursor или другими ИИ-ассистентами.

Что можно делать с помощью этого сервера?

Вместо того чтобы кликать по интерфейсу ProductPlan, просто спросите:

"Что у нас в дорожной карте на 1-й квартал?"

"Покажи мне все цели, которые отстают от графика"

"Создай новую идею по улучшению мобильного приложения"

"Какие запуски запланированы на этот месяц?"

"Выведи все идеи с тегом 'customer-request'"

ИИ получит ваши реальные данные из ProductPlan и ответит за считанные секунды.

Для кого это?

• Продакт-менеджеры, которым нужен быстрый доступ к данным дорожных карт

• Тимлиды, которым нужны оперативные обновления статусов без переключения контекста

• Все, кто использует ИИ-ассистентов (Claude, Cursor и др.) и хочет интегрировать ProductPlan в свой рабочий процесс

Программирование не требуется. Вам нужно будет просто скопировать файл и вставить несколько настроек.

Быстрый старт (5 минут)

Шаг 1: Получите API-токен ProductPlan

1. Войдите в ProductPlan

2. Перейдите в Settings → API (или перейдите по этой ссылке)

3. Скопируйте свой API-токен

Шаг 2: Скачайте приложение

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

На Mac/Linux откройте терминал и выполните эти две команды (замените имя файла на то, что вы скачали):

chmod +x ~/Downloads/productplan-darwin-arm64
sudo mv ~/Downloads/productplan-darwin-arm64 /usr/local/bin/productplan

Вас попросят ввести пароль. Это нормально.

На Windows:

1. Создайте папку для бинарного файла (если она еще не существует):

   mkdir C:\Tools

2. Переместите скачанный .exe в эту папку и переименуйте его:

   move %USERPROFILE%\Downloads\productplan-windows-amd64.exe C:\Tools\productplan.exe

3. Используйте полный путь C:\Tools\productplan.exe в конфигурации вашего ИИ-ассистента (показано на шаге 3)

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

Шаг 3: Подключитесь к ИИ-ассистенту

Выберите инструмент, который вы используете:

1. Найдите файл конфигурации:

   • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Откройте его в любом текстовом редакторе и добавьте следующее (замените your-token на ваш реальный API-токен):

Mac/Linux:

{
  "mcpServers": {
    "productplan": {
      "command": "/usr/local/bin/productplan",
      "env": {
        "PRODUCTPLAN_API_TOKEN": "your-token"
      }
    }
  }
}

Windows:

{
  "mcpServers": {
    "productplan": {
      "command": "C:\\Tools\\productplan.exe",
      "env": {
        "PRODUCTPLAN_API_TOKEN": "your-token"
      }
    }
  }
}

3. Перезапустите Claude Desktop

Добавьте в файл конфигурации:

• Mac/Linux: ~/.claude.json

• Windows: %USERPROFILE%\.claude.json

Mac/Linux:

{
  "mcpServers": {
    "productplan": {
      "command": "/usr/local/bin/productplan",
      "env": {
        "PRODUCTPLAN_API_TOKEN": "your-token"
      }
    }
  }
}

Windows:

{
  "mcpServers": {
    "productplan": {
      "command": "C:\\Tools\\productplan.exe",
      "env": {
        "PRODUCTPLAN_API_TOKEN": "your-token"
      }
    }
  }
}

1. Откройте Cursor

2. Перейдите в Settings → MCP Servers

3. Добавьте эту конфигурацию:

Mac/Linux:

{
  "productplan": {
    "command": "/usr/local/bin/productplan",
    "env": {
      "PRODUCTPLAN_API_TOKEN": "your-token"
    }
  }
}

Windows:

{
  "productplan": {
    "command": "C:\\Tools\\productplan.exe",
    "env": {
      "PRODUCTPLAN_API_TOKEN": "your-token"
    }
  }
}

Пользователи Windows: Используйте двойную обратную косую черту (\\) в пути. Это необходимо, так как обратная косая черта является escape-символом в JSON.

1. Установите расширение Cline

2. Откройте настройки VS Code (JSON) и добавьте:

Mac/Linux:

{
  "cline.mcpServers": {
    "productplan": {
      "command": "/usr/local/bin/productplan",
      "env": {
        "PRODUCTPLAN_API_TOKEN": "your-token"
      }
    }
  }
}

Windows:

{
  "cline.mcpServers": {
    "productplan": {
      "command": "C:\\Tools\\productplan.exe",
      "env": {
        "PRODUCTPLAN_API_TOKEN": "your-token"
      }
    }
  }
}

1. Установите расширение Continue

2. Добавьте в файл конфигурации:

   • Mac/Linux: ~/.continue/config.json

   • Windows: %USERPROFILE%\.continue\config.json

Mac/Linux:

{
  "mcpServers": [
    {
      "name": "productplan",
      "command": "/usr/local/bin/productplan",
      "env": {
        "PRODUCTPLAN_API_TOKEN": "your-token"
      }
    }
  ]
}

Windows:

{
  "mcpServers": [
    {
      "name": "productplan",
      "command": "C:\\Tools\\productplan.exe",
      "env": {
        "PRODUCTPLAN_API_TOKEN": "your-token"
      }
    }
  ]
}

1. Установите переменную окружения в вашем экземпляре n8n:

   N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true

2. Добавьте узел MCP Client в ваш рабочий процесс

3. Настройте:

   • Command:

     • Mac/Linux: /usr/local/bin/productplan

     • Windows: C:\Tools\productplan.exe

   • Environment Variables: PRODUCTPLAN_API_TOKEN=your-token

4. Подключитесь к узлу AI Agent

Пример рабочего процесса: Slack Trigger → AI Agent (с MCP Client) → Slack Response

Шаг 4: Начните задавать вопросы

Откройте своего ИИ-ассистента и попробуйте:

• "Перечисли мои дорожные карты ProductPlan"

• "Какие элементы (bars) есть в дорожной карте [название]?"

• "Покажи мне наши OKR"

• "Какие идеи находятся в стадии исследования (discovery)?"

Примеры реального использования

Подготовка к утреннему стендапу

"Обобщи, что изменилось в нашей дорожной карте продукта за последнюю неделю"

Обновления для стейкхолдеров

"Перечисли все цели на 1-й квартал и прогресс по ним"

Сортировка идей

"Покажи мне все идеи с тегом 'enterprise', у которых не установлен приоритет"

Координация запусков

"Какие задачи еще не выполнены для январского запуска?"

Быстрый поиск

"Когда запланировано начало работы над элементом 'Mobile App v2'?"

К каким данным ProductPlan можно получить доступ?

Как это работает

┌─────────────────┐      spawns       ┌─────────────────┐      API calls     ┌─────────────────┐
│   AI Assistant  │ ───────────────── │   MCP Server    │ ─────────────────▶ │   ProductPlan   │
│ (Claude, Cursor)│ ◀───────────────▶ │   (this binary) │ ◀───────────────── │      API        │
└─────────────────┘   stdin/stdout    └─────────────────┘     JSON data      └─────────────────┘
      your computer                        your computer                         cloud

Почему это должно работать на вашем компьютере?

MCP (Model Context Protocol) работает через модель подпроцессов. Ваш ИИ-ассистент не подключается к удаленному серверу; он запускает бинарный файл как локальный процесс и общается через stdin/stdout. Эта архитектура означает:

1. Бинарный файл должен существовать локально, так как ИИ-ассистент запускает его как дочерний процесс

2. Ваш API-токен остается на вашем компьютере и никогда не передается через сторонние серверы

3. Синхронная связь в реальном времени без сетевых задержек между ИИ и MCP-сервером

4. Работает офлайн для кэшированных данных (хотя для вызовов API ProductPlan все равно нужен интернет)

Когда вы спрашиваете "Что у нас в дорожной карте на 1-й квартал?", происходит следующее:

1. ИИ-ассистент понимает, что ему нужны данные ProductPlan

2. Он отправляет структурированный запрос процессу MCP-сервера

3. Бинарный файл переводит это в вызовы API ProductPlan

4. ProductPlan возвращает данные в формате JSON

5. Бинарный файл форматирует и возвращает результаты вашему ИИ

6. ИИ представляет ответ на естественном языке

Навыки агента (Agent Skills)

Готовые руководства по рабочим процессам, которые обучают ИИ-ассистентов эффективно использовать инструменты ProductPlan. Каждый навык ориентирован на конкретную роль с адаптированными рабочими процессами.

Общие принципы

Все навыки следуют этим правилам вывода:

• Никакого сырого JSON — форматируйте ответы как читаемый текст и таблицы

• Человекочитаемые даты — используйте "Март 2025" или "1 кв. 2025", а не "2025-03-15"

• Обобщайте большие списки — не перегружайте пользователя 50 пунктами; предложите развернуть список

Вариации по ролям:

• PM включает bar_id для последующих действий

• Руководство начинает с краткого резюме, скрывая детали реализации

• Работа с клиентами полностью опускает внутренние ID, названия дорожек и OKR

Чтобы использовать навык, скопируйте файл SKILL.md в директорию навыков Claude Code:

# Copy a skill (example: PM skill)
cp skills/productplan-pm/SKILL.md ~/.claude/skills/productplan-pm.md

Или ссылайтесь на навыки напрямую в ваших промптах:

"Используй рабочий процесс productplan-pm, чтобы показать мне нашу дорожную карту на 1-й квартал"

Устранение неполадок

"Command not found" или "spawn ENOENT"

Ваш ИИ-ассистент не может найти бинарный файл. Это означает:

• Mac/Linux: Файл отсутствует по пути /usr/local/bin/productplan, или вы забыли выполнить chmod +x

• Windows: Путь в конфигурации не совпадает с тем местом, куда вы сохранили .exe

Решение: Убедитесь, что бинарный файл существует по пути, указанному в конфигурации. Выполните ls -la /usr/local/bin/productplan (Mac/Linux) или проверьте наличие C:\Tools\productplan.exe (Windows).

Проблемы с путями в Windows

Распространенные ошибки в Windows:

Windows использует обратные косые черты (\) для путей, но JSON воспринимает их как escape-символы. Вы должны дублировать их (\\) в файле конфигурации.

"Invalid API token"

Перепроверьте свой токен в ProductPlan Settings → API. Токены могут истекать или быть пересозданы. Убедитесь, что вы скопировали полный токен без лишних пробелов.

"No roadmaps found"

Ваш API-токен имеет доступ только к тем данным, которые вам разрешено видеть в ProductPlan. Убедитесь, что у вашей учетной записи есть доступ к дорожным картам, которые вы ищете.

ИИ-ассистент не видит инструменты ProductPlan

MCP-серверы загружаются при запуске ИИ-ассистента, а не при изменении конфигурации. После редактирования файла конфигурации полностью закройте и перезапустите приложение. На Mac используйте Cmd+Q (а не просто закрытие окна).

"Permission denied" на Mac/Linux

Бинарному файлу нужны права на выполнение. Выполните:

chmod +x /usr/local/bin/productplan