跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用,一键添加 Productboard,然后将你的 AI 客户端(Claude、ChatGPT、Copilot 或 Cursor)指向生成的 MCP 端点。无需 Docker,无需 git clone,无需任何工程经验。
摘要
通过 REST API v2 使用 Productboard 进行产品管理:以带自定义字段和关系的实体形式读取和编辑产品、组件、功能、举措、目标和关键结果、发布、公司和用户,记录和搜索客户反馈笔记并关联到功能,以及查询成员和团队。
试试这样问
Productboard 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → Productboard、粘贴凭证、生成 MCP API key,即可完成。无 Docker、无
git clone、无本地服务器。
Productboard
通过 REST API v2 使用 Productboard 进行产品管理:以带自定义字段和关系的实体形式读取和编辑产品、组件、功能、举措、目标和关键结果、发布、公司和用户,记录和搜索客户反馈笔记并关联到功能,以及查询成员和团队。
设置
设置大约需要 2 分钟。你需要一个 Pro 或更高套餐的 Productboard 工作区。
- 在 Productboard 中打开 Settings > Integrations > Public APIs > Access Token,点击 + 创建令牌。请立即复制:它只显示一次。
- 把它粘贴到
PRODUCTBOARD_API_TOKEN,不要带Bearer前缀。它以Authorization: Bearer <token>的形式发送,并以创建它的成员的权限执行操作,因此工作区管理员或 maker 的令牌能看到最多的数据。 - 安装连接器并运行
productboard_list_entity_configurations:它会确认令牌,并列出你工作区的实体类型。
仅 API v2:连接器使用 Productboard REST API v2(https://api.productboard.com/v2)。API v1 已于 2026 年 4 月弃用,并于 2026 年 7 月 8 日停止服务。
一切都是实体:产品、组件、功能、子功能、举措、目标、关键结果、发布、发布组、用户和公司(以及工作区中存在的竞争对手和任务)都是带 type 的实体。客户反馈存放在笔记中。
先了解工作区:每个工作区的字段都不同。productboard_list_entity_configurations 和 productboard_get_entity_configuration 显示某个类型的全部字段(name、description、status、owner、timeframe、teams、tags 等标准字段,以及以 UUID 为键的自定义字段)、哪些是必填项以及各自支持的 patch 操作。productboard_list_note_configurations 对笔记做同样的事,productboard_list_field_values 列出选择、标签或状态字段的可选值。
可以读取的内容:
- 路线图:
productboard_list_entities配合types(例如["feature"]、["objective", "keyResult"]或["company"]),并可按名称、负责人、状态、团队、父级或归档状态过滤;productboard_search_entities支持按多个 ID、日期范围、字段值(包括自定义字段)、父级和客户进行结构化过滤,并可选择返回的字段;productboard_get_entity读取单个条目及其links.html链接。 - 层级:
productboard_list_entity_relationships显示父级、子级、链接和阻塞关系,例如某个组件下的所有功能。 - 反馈:
productboard_list_notes按日期、负责人、创建者、来源系统、已处理或已归档状态筛选;productboard_search_notes把全文搜索与标签、客户和关联功能结合起来;productboard_get_note和productboard_list_note_relationships查看单条笔记、它的客户和关联的功能。 - 人员:工作区成员用
productboard_list_members和productboard_get_member,团队用productboard_list_teams和productboard_list_team_members。
可以写入的内容:
productboard_create_entity用type和fields创建功能、组件、举措、目标、关键结果、发布、公司等;父级通过relationships设置,例如[{"type": "parent", "target": {"id": "<component id>"}}]。productboard_update_entity用fields覆盖值,或对标签、团队等列表执行patch操作(set、addItems、removeItems、clear)。productboard_set_entity_parent把实体移到另一个父级下;productboard_create_entity_relationship添加link、isBlockedBy或isBlocking关系。productboard_create_note把反馈记录到 Insights 收件箱,包含标题、正文、标签、负责人、来源记录、客户和关联功能;productboard_update_note修改笔记(例如标记为已处理);productboard_link_note把笔记关联到功能或设置它的客户。
无需关闭,也没有删除:连接器根本没有删除工具,因此安装时也没有关闭任何工具。在 API v2 中删除一个实体会同时删除它的所有子级,所以删除操作留在 Productboard 应用中完成。
数据格式:引用都是对象:负责人写作 {"email": "[email protected]"} 或 {"id": "<uuid>"},状态写作 {"name": "In progress"},标签写作 [{"name": "Q4"}]。timeframe 的形式为 {"startDate": "2026-10-01", "endDate": "2026-12-31", "granularity": "month"}。笔记的 content 和富文本字段接受简单 HTML 或纯文本。列表返回 data,每个条目包含 id、type、fields、links.html、createdAt 和 updatedAt。所有 ID 都是 UUID,时间为 UTC 的 ISO 8601。没有 members:pii:read 权限时,负责人的邮箱显示为 [redacted]。
分页:当 links.next 存在时,AI 从该 URL 中取出 pageCursor 的值作为 page_cursor 传入;links.next 为 null 时停止。
限制和常见错误:每个令牌每秒 50 次请求;429 会带上 Retry-After。401 表示令牌错误或已撤销,403 表示令牌所属成员没有该数据的权限,400 或 422 表示字段或类型未知:错误信息会说明工作区接受哪些值,AI 会对照配置检查。
该连接器不删除实体或笔记,不修改工作区的设置、字段或状态,也不使用已停用的 API v1。
前提条件: PRODUCTBOARD_API_TOKEN
本地安装连接器
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
打开 http://localhost:3000/connectors/store,选择 Productboard 并填入前提条件中列出的环境变量。
可用工具
| Tool | What it does |
|---|---|
productboard_list_entity_configurations | List the entity types of the workspace (product, component, feature, subfeature, initiative, objective, keyResult, release, releaseGroup… |
productboard_get_entity_configuration | Fields of one entity type (e.g. feature or company): standard and custom fields with their types, whether they are required, and the… |
productboard_list_entities | List entities (features, components, products, initiatives, objectives, key results, releases, companies, users, ...) with their fields… |
productboard_search_entities | Search entities with a structured filter: several types or ids, created or updated date ranges, field values (name, archived, owner… |
productboard_get_entity | One entity (feature, component, product, initiative, objective, key result, release, company, user, ...) by id with all its fields, its… |
productboard_create_entity | Create an entity: a feature, subfeature, component, product, initiative, objective, key result, release, release group, company or user |
productboard_update_entity | Update an entity. fields overwrites the given values (null clears one); patch applies operations: set, addItems and removeItems on lists… |
productboard_list_entity_relationships | Relationships of an entity: its parent, children, linked entities and blockers (type parent, child, link, isBlockedBy, isBlocking) with the… |
productboard_create_entity_relationship | Add a relationship from one entity to another: link (related items), isBlockedBy or isBlocking (dependencies), or child |
productboard_set_entity_parent | Set or replace the parent of an entity, e.g. move a feature to another component, a subfeature under a feature or a key result under an… |
productboard_list_field_values | Allowed values of a select, multi-select, tag or status field (custom field UUID, or a standard field name such as status or tags), with… |
productboard_list_note_configurations | Note types of the workspace (textNote, conversationNote, opportunityNote) with their fields, required fields and patch operations |
productboard_list_notes | List customer feedback notes, newest first, with name, content, tags, owner, processed and archived state |
productboard_search_notes | Full-text search over notes, optionally combined with filters on tags, owner, processed or archived state, dates, customer and linked… |
productboard_get_note | One note by id with its fields (name, content, tags, owner, creator, processed, archived), metadata source and the links.html URL to open… |
productboard_create_note | Capture customer feedback as a note in the Productboard Insights inbox: a title, the feedback text, optional tags, owner, source record… |
productboard_update_note | Update a note. fields overwrites the given values (name, content, owner, processed, archived, ...); patch applies set, addItems… |
productboard_list_note_relationships | Relationships of a note: the customer (user or company) it came from and the entities (features, components, products) it is linked to |
productboard_link_note | Link a note to a feature, subfeature, component or product (type link, the insight then counts for that item), or assign its customer (type… |
productboard_list_members | Members of the Productboard workspace (name, email, role), oldest first |
productboard_get_member | One workspace member by id: name, email, role, disabled or invited state and teams |
productboard_list_teams | Teams of the workspace with name, handle and description, newest first |
productboard_list_team_members | Members of one team (name, email, role), newest membership first, with cursor paging |
示例提示
- “列出状态为 In progress 的功能,附上负责人和时间范围,并按组件分组。”
- “过去两周未处理的反馈笔记中,哪些提到了新用户引导?总结主要主题。”
- “在 Mobile 组件下创建一个功能‘移动应用深色模式’,负责人 [email protected],状态 New idea。”
- “把这张支持工单记录为来自 [email protected] 的笔记,并关联到 CSV 导出功能。”
- “给我看本季度的目标及其关键结果,附上状态和负责人。”
下一步
这份指南对你有帮助吗?