Productboard MCP Server

产品板MCP服务器

A. 全面的 模型上下文协议（MCP）服务器，提供与Productboard API的无缝集成。该服务器使AI助手和其他MCP客户端能够通过以下方式与Productboard交互 49种专用工具 涵盖所有主要的Productboard功能。

🚀 快速入门（承载令牌-推荐）

开始完全访问所有工具的最快方法：

# 1. Clone the repository
git clone https://github.com/miguelarios/productboard-mcp-server.git
cd productboard-mcp-server

# 2. Install dependencies
npm install

# 3. Set up environment
cp .env.example .env

# 4. Add your Productboard API key to .env:
PRODUCTBOARD_AUTH_TYPE=bearer
PRODUCTBOARD_API_TOKEN=your_api_key_from_productboard

# 5. Build and run
npm run build
npm start

就是这样！ 承载令牌提供对所有49个工具的即时访问，无需复杂的权限设置。

📍 获取API密钥： 访问 https://your-subdomain.productboard.com/settings/api-keys 在您的Productboard工作区中。

✨ 主要特点

🔐 简化身份验证

• 🎯 承载令牌快速路径 -API密钥提供对所有工具的即时访问（推荐）
• 🔧 OAuth2支持 -基于角色的团队协作范围访问
• 🔄 自动令牌管理 -自动处理验证和刷新

🛠️ 完整的工具覆盖范围

总计：49个MCP工具 覆盖100%的主要产品板功能：

🎯 功能管理（6个工具）

• 创建、读取、更新、删除功能
• 批量操作和高级过滤
• 功能生命周期管理

📦 产品管理（3个工具）

• 产品层次导航
• 组件和产品创建
• 组织结构管理

📝 客户反馈（4个工具）

• 笔记创建和管理
• 功能反馈链接
• 大宗票据操作

👥 用户和公司管理（3个工具）

• 用户目录和配置文件
• 公司信息访问
• 工作区成员管理

🎯 目标和关键成果（7个工具）

• OKR创建和跟踪
• 功能目标链接
• 战略目标管理

🚀 发布管理（8个工具）

• 发布计划和跟踪
• 为版本分配功能
• 时间线和状态管理

🔗 网钩和集成 (5 工具)

• Webhook 配置
• 第三方集成
• 实时事件管理

🔍 搜索和分析（4个工具）

• 全球搜索功能
• 高级过滤和报告
• 绩效指标和见解

⚡ 批量操作（5个工具）

• 海量数据操作
• 高效的批处理
• 节省时间的自动化

📊 自定义字段和导出（10个工具）

• 自定义字段管理
• 数据导出功能
• 配置和设置工具

🏗️ 建筑亮点

• 承载令牌快速路径 -API密钥绕过权限发现以立即进行完全访问
• OAuth2示波器系统 -基于Productboard角色的精细权限
• 基于权限的工具注册 -仅加载相关工具
• 全面的错误处理 -具有重试逻辑的强大API交互
• 速率限制和缓存 -生产就绪性能优化

📖 设置选项

选项1：不记名代币（推荐）

非常适合个人使用或需要立即访问所有工具时使用：

1. 从Productboard设置获取API密钥
2. 集 PRODUCTBOARD_AUTH_TYPE=bearer 在……里面 .env
3. 添加您的 PRODUCTBOARD_API_TOKEN
4. 运行服务器-所有49个工具立即可用！

选项2:OAuth2（团队协作）

非常适合具有基于角色的访问权限的团队环境：

1. 在Productboard中创建OAuth2应用程序
2. 根据用户角色（贡献者/创建者/管理员）配置作用域
3. 运行OAuth2安装过程
4. 工具根据授予的范围进行注册

📚 详细设置指南： 看 SETUP_GUIDE.md 获取全面的指导。

🔧 配置

环境变量

# Authentication
PRODUCTBOARD_AUTH_TYPE=bearer              # or 'oauth2'
PRODUCTBOARD_API_TOKEN=your_api_key        # For Bearer token auth
PRODUCTBOARD_API_BASE_URL=https://api.productboard.com

# OAuth2 (if using OAuth2)
PRODUCTBOARD_OAUTH_CLIENT_ID=your_client_id
PRODUCTBOARD_OAUTH_CLIENT_SECRET=your_client_secret
PRODUCTBOARD_OAUTH_PRESET=admin            # contributor, maker, admin

# Server Configuration
MCP_SERVER_PORT=3000
LOG_LEVEL=info
CACHE_ENABLED=true

基于角色的访问（OAuth2）

• 贡献者 （~5个工具）：笔记创建、用户信息
• 制造者 （约15个工具）：笔记、用户、发布、反馈表
• 管理员 （约49个工具）：完整的系统访问权限，包括OKR、分析、集成

🖥️ MCP客户端配置

克劳德桌面

增添 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "productboard": {
      "command": "node",
      "args": ["/full/path/to/productboard-mcp-server/dist/index.js"],
      "env": {
        "PRODUCTBOARD_AUTH_TYPE": "bearer",
        "PRODUCTBOARD_API_TOKEN": "your_api_key_here"
      }
    }
  }
}

🧪 发展

# Development mode
npm run dev

# Run tests
npm test

# Type checking
npm run typecheck

# Linting
npm run lint

📋 可用的MCP工具

Click to view all 49 tools

特点（6）

• pb_feature_create -创建新功能
• pb_feature_list -列表和筛选功能
• pb_feature_get -获取功能详细信息
• pb_feature_update -更新功能属性
• pb_feature_delete -删除/存档功能
• pb_feature_bulk_update -批量更新操作

产品（3）

• pb_product_create -创建产品/组件
• pb_product_list -列出产品和组件
• pb_product_hierarchy -获取产品结构

注释（4）

• pb_note_create -创建客户反馈
• pb_note_list -列出带有过滤功能的笔记
• pb_note_attach -将注释链接到功能
• pb_note_bulk_create -批量笔记创建

用户和公司（3）

• pb_user_current -当前用户信息
• pb_user_list -列出工作区用户
• pb_company_list -列出公司

目标和关键成果（7）

• pb_objective_create -制定目标
• pb_objective_list -列出目标
• pb_objective_update -更新目标
• pb_objective_link_feature -将功能与目标联系起来
• pb_keyresult_create -创建关键结果
• pb_keyresult_list -列出关键结果
• pb_keyresult_update -更新关键结果

新闻发布（8）

• pb_release_create -创建发布
• pb_release_list -列表发布
• pb_release_update -更新发布详细信息
• pb_release_feature_add -为版本添加功能
• pb_release_feature_remove -从版本中删除功能
• pb_release_status_update -更新发布状态
• pb_release_timeline -获取发布时间表
• pb_release_bulk_update -批量放行操作

网络连接器 （5）

• pb_webhook_create - 创建网上挂钩
• pb_webhook_list 列出已配置的 Webhooks
• pb_webhook_update -更新webhook设置
• pb_webhook_delete 删除 Webhooks
• pb_webhook_test -测试webhook功能

搜索与分析（4）

• pb_search_global -跨产品板的全球搜索
• pb_search_features -特定搜索功能
• pb_search_notes -搜索客户反馈
• pb_analytics_features -功能使用分析

自定义字段（4）

• pb_customfield_create -创建自定义字段
• pb_customfield_list -列出可用的自定义字段
• pb_customfield_set_value -设置自定义字段值
• pb_export_data -导出产品板数据

批量操作（5）

• pb_feature_bulk_create -批量创建功能
• pb_feature_bulk_delete -批量删除功能
• pb_note_bulk_attach -将注释批量附加到功能上
• pb_integration_jira_sync -与Jira同步
• pb_integration_export_jira -导出到Jira

🚨 重要提示

• 承载令牌提供无限制的访问 -将它们用于个人/管理场景
• OAuth2提供作用域访问 -用于有角色限制的团队环境
• 所有凭据都安全存储 -永不承诺 .env 文件到版本控制
• 内置速率限制 -自动遵守Productboard API限制

🛟 故障排除

常见问题

❌ Bearer令牌出现“权限被拒绝”错误

• 确保您的API密钥有效，并且来自管理员用户
• 检查一下 PRODUCTBOARD_AUTH_TYPE=bearer 设置正确

❌ OAuth2“工具未加载”

• 验证您的OAuth2作用域是否与您的Productboard角色匹配
• 检查授权是否已成功完成
• 查看日志以了解特定权限错误

❌ “连接失败”

• 验证 PRODUCTBOARD_API_BASE_URL 是正确的
• 检查api.productboard.com的网络连接
• 确保API密钥/令牌尚未过期

📄 许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

🤝 贡献

此MCP服务器提供了全面的Productboard集成，包括简单的Bearer令牌身份验证和高级的基于OAuth2作用域的访问控制。Bearer令牌快速路径可确保立即访问所有功能，而OAuth2则支持细粒度的团队权限。

______________________________________________________________________

*内置于❤️ 使用模型上下文协议*