AI导哈

Productboard API协议服务器

一个用于Productboard API的MCP（模型上下文协议）服务器，使AI助手（如Claude、Cursor等）能够与您的Productboard工作区交互。

  • by Enreign
  • TypeScript
  • 本地部署
  • 20 星标
  • 更新于
在 GitHub 查看 Enreign/productboard-mcp

使用说明

产品板mcp

一 MCP（模型上下文协议） 服务器 产品板 API使AI助手（Claude、Cursor等）能够与您的Productboard工作区进行交互。

工具

工具 说明
pb_feature_list 列出具有过滤功能的功能
pb_feature_get 按ID获取功能
pb_feature_create 创建新功能
pb_feature_update 更新现有功能
pb_feature_delete 删除功能
pb_product_list 列出产品
pb_product_create 创建产品
pb_product_hierarchy 获取完整的产品层次结构
pb_note_list 列出客户备注
pb_note_create 创建客户备注
pb_objective_list 列出目标
pb_objective_create 设定一个目标
pb_objective_update 更新目标
pb_keyresult_list 列出关键结果
pb_keyresult_create 创建关键结果
pb_keyresult_update 更新关键结果
pb_release_list 列表发布
pb_release_create 创建发布
pb_release_update 更新版本
pb_release_status_update 更新发布状态
pb_release_timeline 获取发布时间表

安装

选项1：一键安装（.mcpb捆绑包）——推荐

下载最新 .mcpb 文件来自 发布 页面并将其拖动到Claude Desktop（开发人员→ 扩展→ 安装），或在兼容的MCP客户端中双击它。

该捆绑包是自包含的，不需要克隆或构建。

安装后，设置 PRODUCTBOARD_API_TOKEN 在扩展设置中。

选项2：本地安装（手动）

# 1. Clone the repo
git clone https://github.com/Enreign/productboard-mcp.git
cd productboard-mcp

# 2. Install dependencies and build
npm install --include=dev
npm run build

然后添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "productboard": {
      "command": "node",
      "args": ["/absolute/path/to/productboard-mcp/dist/index.js"],
      "env": {
        "PRODUCTBOARD_API_TOKEN": "your-api-token-here",
        "LOG_LEVEL": "error"
      }
    }
  }
}

重要提示： 集 LOG_LEVEL 到 error （不是 info).MCP使用stdio进行通信——打印到stdout的信息级日志会干扰协议并导致服务器锁定。

选项3:npx

⚠️ 即将发布，尚未发布到npm。使用上述选项1或2。

{
  "mcpServers": {
    "productboard": {
      "command": "npx",
      "args": ["-y", "@enreign/productboard-mcp"],
      "env": {
        "PRODUCTBOARD_API_TOKEN": "your-api-token-here",
        "LOG_LEVEL": "error"
      }
    }
  }
}

获取Productboard API代币

  1. 登录到您的Productboard工作区
  2. 首选 配置文件和设置 → API访问
  3. 点击 生成API密钥 并复制令牌

配置

必需

变量 描述
PRODUCTBOARD_API_TOKEN 您的Productboard API令牌（Bearer-auth）

可选的

变量 默认值 描述
PRODUCTBOARD_AUTH_TYPE bearer 身份验证类型： bearer 或 oauth2
PRODUCTBOARD_API_BASE_URL https://api.productboard.com/v2 API基本URL
PRODUCTBOARD_API_TIMEOUT 10000 API请求超时（ms）
API_RETRY_ATTEMPTS 3 重试次数
API_RETRY_DELAY 1000 重试之间的延迟（ms）
RATE_LIMIT_GLOBAL 100 每个窗口的最大请求数
RATE_LIMIT_WINDOW_MS 60000 速率限制窗口（ms）
CACHE_ENABLED false 启用响应缓存
CACHE_TTL 300 缓存TTL（秒）
LOG_LEVEL info 日志级别： trace, debug, info, warn, error, fatal

MCP客户端注意事项： 始终设置 LOG_LEVEL=error 与Claude Desktop、Cursor或任何基于stdio的MCP客户端一起使用时。更高的日志级别会写入stdout，并会破坏MCP协议。

OAuth2（可选）

变量 描述
PRODUCTBOARD_OAUTH_CLIENT_ID OAuth2客户端ID
PRODUCTBOARD_OAUTH_CLIENT_SECRET OAuth2客户端机密
PRODUCTBOARD_OAUTH_REDIRECT_URI OAuth 2重定向类型

故障排除

“MCP服务器锁定/生成错误日志” → Add "LOG_LEVEL": "error" 到 env MCP配置中的块。写入stdout的信息日志会干扰stdio传输。

“npx失败/找不到包” → 该包尚未发布到npm。使用 .mcpb 捆绑或本地安装。

“本地生成后找不到命令” → Point args 在完全绝对路径上 dist/index.js，而不是 productboard-mcp.js 包装。

许可证

麻省理工学院

相关 MCP