productplan-mcp-server
ProductPlan MCP 服务器
通过 AI 与您的路线图对话。 通过与 Claude、Cursor 或其他 AI 助手进行自然对话，您可以提问、创建想法、检查 OKR 进度并管理发布。
您可以用它做什么？
无需点击 ProductPlan 的界面，只需询问：
“我们第一季度的路线图上有什么？”
“向我展示所有进度落后的目标”
“为移动应用改进创建一个新想法”
“本月有哪些发布计划？”
“列出所有标记为 'customer-request' 的想法”
AI 会获取您真实的 ProductPlan 数据并在几秒钟内做出响应。
这是为谁准备的？
产品经理：希望更快地访问路线图数据
团队负责人：需要快速获取状态更新而无需切换上下文
任何使用 AI 助手（Claude、Cursor 等）并希望将 ProductPlan 集成到工作流中的用户
无需编码。您只需复制一个文件并粘贴一些设置即可。
快速入门（5 分钟）
第 1 步：获取您的 ProductPlan API 令牌
登录 ProductPlan
转到 Settings → API（或直接访问 此链接）
复制您的 API 令牌
第 2 步：下载应用程序
前往 Releases 页面 并下载适合您计算机的文件：
您的计算机 | 下载此文件 |
Mac (M1, M2, M3, M4) |
|
Mac (Intel) |
|
Windows |
|
Linux |
|
在 Mac/Linux 上，打开终端并运行这两条命令（将文件名替换为您下载的文件名）：
chmod +x ~/Downloads/productplan-darwin-arm64
sudo mv ~/Downloads/productplan-darwin-arm64 /usr/local/bin/productplan系统会要求您输入密码。这是正常的。
在 Windows 上：
为二进制文件创建一个文件夹（如果不存在）：
mkdir C:\Tools将下载的
.exe移动到该文件夹并重命名：move %USERPROFILE%\Downloads\productplan-windows-amd64.exe C:\Tools\productplan.exe在您的 AI 助手配置中使用完整路径
C:\Tools\productplan.exe（在第 3 步中显示）
注意：您可以跳过添加到 PATH 的步骤。只需在配置中使用完整文件路径即可。
第 3 步：连接到您的 AI 助手
选择您使用的工具：
找到您的配置文件：
Mac:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
在任何文本编辑器中打开它并添加以下内容（将
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"
}
}
}
}重启 Claude Desktop
添加到您的配置文件：
Mac/Linux:
~/.claude.jsonWindows:
%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"
}
}
}
}打开 Cursor
转到 Settings → MCP Servers
添加此配置：
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 用户：在路径中使用双反斜杠 (
\\)。这是必需的，因为反斜杠在 JSON 中是转义字符。
安装 Cline 扩展
打开 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"
}
}
}
}安装 Continue 扩展
添加到您的配置文件：
Mac/Linux:
~/.continue/config.jsonWindows:
%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"
}
}
]
}在您的 n8n 实例上设置环境变量：
N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true将 MCP Client 节点添加到您的工作流
配置：
Command：
Mac/Linux:
/usr/local/bin/productplanWindows:
C:\Tools\productplan.exe
Environment Variables:
PRODUCTPLAN_API_TOKEN=your-token
连接到 AI Agent 节点
示例工作流：Slack Trigger → AI Agent (with MCP Client) → Slack Response
第 4 步：开始提问
打开您的 AI 助手并尝试：
“列出我的 ProductPlan 路线图”
“路线图 [名称] 上有哪些条目？”
“向我展示我们的 OKR”
“哪些想法处于发现阶段？”
实际用例
早会准备
“总结过去一周我们产品路线图上的变化”
利益相关者更新
“列出所有第一季度的目标及其进度”
想法分类
“向我展示所有标记为 'enterprise' 且未设置优先级的想法”
发布协调
“一月份的发布还有哪些任务未完成？”
快速查找
“'Mobile App v2' 条目计划何时开始？”
您可以访问哪些 ProductPlan 数据？
功能 | 查看 | 创建 | 编辑 | 删除 |
路线图 | 是 | - | - | - |
路线图评论 | 是 | - | - | - |
条目 (路线图项) | 是 | 是 | 是 | 是 |
条目评论 | 是 | - | - | - |
条目连接 | 是 | 是 | - | 是 |
条目链接 | 是 | 是 | - | 是 |
泳道 (类别) | 是 | 是 | 是 | 是 |
图例 (条目颜色) | 是 | - | - | - |
里程碑 | 是 | 是 | 是 | 是 |
想法 (发现) | 是 | 是 | 是 | - |
想法客户 | 是 | - | - | - |
想法标签 | 是 | - | - | - |
机会 | 是 | 是 | 是 | - |
想法表单 | 是 | - | - | - |
目标 (OKR) | 是 | 是 | 是 | 是 |
关键结果 | 是 | 是 | 是 | 是 |
发布 | 是 | 是 | 是 | 是 |
发布部分 | 是 | 是 | 是 | 是 |
发布任务 | 是 | 是 | 是 | 是 |
用户 | 是 | - | - | - |
团队 | 是 | - | - | - |
工作原理
┌─────────────────┐ 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) 通过子进程模型工作。您的 AI 助手不会连接到远程服务器；它将二进制文件作为本地进程启动，并通过 stdin/stdout 进行通信。这种架构意味着：
二进制文件必须存在于本地，因为您的 AI 助手将其作为子进程运行
您的 API 令牌保留在您的机器上，绝不会通过第三方服务器
实时、同步通信，AI 和 MCP 服务器之间没有网络延迟
离线工作（针对缓存数据，尽管 ProductPlan API 调用仍需要互联网）
当您询问“我们第一季度的路线图上有什么？”时，会发生以下情况：
您的 AI 助手识别出它需要 ProductPlan 数据
它向 MCP 服务器进程发送结构化请求
二进制文件将其转换为 ProductPlan API 调用
ProductPlan 返回 JSON 数据
二进制文件格式化并将结果返回给您的 AI
您的 AI 以自然语言呈现答案
代理技能
预构建的工作流指南，教导 AI 助手如何有效地使用 ProductPlan 工具。每项技能都针对具有量身定制工作流的特定角色。
技能 | 受众 | 重点 |
通用 | 核心模式和工具参考 | |
产品经理 | 全套工具：路线图、OKR、想法、发布 | |
高管 | 组合健康状况、跨路线图视图 | |
销售与客户成功 | 面向客户的路线图时间表 |
共享原则
所有技能都遵循这些输出约定：
无原始 JSON - 将响应格式化为可读的文本和表格
人类可读的日期 - 使用 “2025 年 3 月” 或 “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 工作流向我展示我们的第一季度路线图”
故障排除
“Command not found” 或 “spawn ENOENT”
您的 AI 助手找不到二进制文件。这意味着：
Mac/Linux: 文件不在
/usr/local/bin/productplan，或者您忘记运行chmod +xWindows: 配置中的路径与您保存
.exe的位置不匹配
解决方法：验证二进制文件是否存在于配置中的路径。运行 ls -la /usr/local/bin/productplan (Mac/Linux) 或检查 C:\Tools\productplan.exe 是否存在 (Windows)。
Windows 路径问题
Windows 上的常见错误：
错误 | 正确 |
|
|
|
|
|
|
缺少 | 在路径中包含 |
Windows 使用反斜杠 (\) 作为路径，但 JSON 将反斜杠视为转义字符。您必须在配置文件中将它们加倍 (\\)。
“Invalid API token”
请在 ProductPlan Settings → API 仔细检查您的令牌。令牌可能会过期或被重新生成。确保您复制了完整的令牌，没有多余的空格。
“No roadmaps found”
您的 API 令牌只能访问您在 ProductPlan 中有权查看的数据。检查您的帐户是否拥有您正在查找的路线图的访问权限。
AI 助手看不到 ProductPlan 工具
MCP 服务器在您的 AI 助手启动时加载，而不是在配置更改时加载。编辑配置文件后，请完全退出并重启应用程序。在 Mac 上，使用 Cmd+Q（不仅仅是关闭窗口）。
“Permission denied” (Mac/Linux)
二进制文件需要执行权限。运行：
chmod +x /usr/local/bin/productplan命令行 (可选)
您也可以直接在终端中使用此工具，无需 AI 助手：
# First, set your token
export PRODUCTPLAN_API_TOKEN="your-token"
# Then run commands
productplan status # Check connection
productplan roadmaps # List all roadmaps
productplan bars 12345 # List bars in roadmap #12345
productplan objectives # List all OKRs
productplan ideas # List all ideas
productplan opportunities # List all opportunities
productplan launches # List all launches背景信息
什么是 MCP？
Model Context Protocol (MCP) 是一种开放标准，允许 AI 助手连接到外部工具。Anthropic 创建了它；其他 AI 提供商正在采用它。此服务器实现了 MCP，以便您的 AI 助手可以读取和写入 ProductPlan 数据。
什么是 ProductPlan？
ProductPlan 是 4000 多家产品团队使用的路线图软件。它处理路线图、OKR、想法发现和发布协调。
给开发者
productplan-mcp-server/
├── cmd/productplan/main.go # Entry point (~100 lines)
├── internal/
│ ├── api/ # ProductPlan API client
│ │ ├── client.go # HTTP client with caching, retry, rate limiting
│ │ ├── endpoints.go # 40+ API endpoint methods
│ │ └── formatters.go # Response enrichment for AI
│ ├── mcp/ # MCP protocol implementation
│ │ ├── server.go # JSON-RPC server, stdio I/O
│ │ ├── handler.go # Tool dispatch via registry
│ │ └── types.go # Protocol types
│ ├── tools/ # Tool definitions and handlers
│ │ ├── registry.go # Tool registration and dispatch
│ │ └── types.go # Typed argument structs for handlers
│ ├── cli/ # CLI commands (status, roadmaps, etc.)
│ │ └── cli.go
│ └── logging/ # Structured JSON logging
│ └── logger.go
├── pkg/productplan/ # Reusable utilities
│ ├── cache.go # LRU cache with TTL
│ ├── retry.go # Exponential backoff with jitter
│ ├── ratelimit.go # Adaptive rate limiting
│ ├── registry.go # ToolBuilder for schema generation
│ ├── requestid.go # Request tracing
│ └── errors.go # Error suggestions
└── evals/ # LLM evaluation test suite
├── tool_selection.json
├── confusion_pairs.json
└── argument_correctness.jsongit clone https://github.com/olgasafonova/productplan-mcp-server.git
cd productplan-mcp-server
go build -o productplan ./cmd/productplan为所有平台构建：
# macOS Apple Silicon
GOOS=darwin GOARCH=arm64 go build -o dist/productplan-darwin-arm64 ./cmd/productplan
# macOS Intel
GOOS=darwin GOARCH=amd64 go build -o dist/productplan-darwin-amd64 ./cmd/productplan
# Linux
GOOS=linux GOARCH=amd64 go build -o dist/productplan-linux-amd64 ./cmd/productplan
# Windows
GOOS=windows GOARCH=amd64 go build -o dist/productplan-windows-amd64.exe ./cmd/productplan运行所有测试：
go test ./...运行覆盖率：
go test ./... -cover运行基准测试：
go test ./internal/... -bench=. -benchmem运行评估套件：
./scripts/run-evals.sh覆盖率目标：
包 | 覆盖率 |
internal/mcp | 97% |
internal/logging | 97% |
internal/api | 95% |
internal/cli | 95% |
internal/tools | 90% |
提供 47 个工具：35 个读取工具和 12 个写入工具（基于操作）：
读取工具：
路线图：
list_roadmaps,get_roadmap,get_roadmap_bars, `get_
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/olgasafonova/productplan-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server