enreign/productboard-mcp

20 stars 0 forks 품질 90 트렌드 90

A complete Model Context Protocol (MCP) server that provides comprehensive integration with the Productboard API. More than 40+ tools.

개요

An MCP (Model Context Protocol) server for the Productboard API. Enables AI assistants (Claude, Cursor, etc.) to interact with your Productboard workspace. Download the latest .mcpb file from the Releases page and drag it into Claude Desktop (Developer → Extensions → Install), or double-click it in a compatible MCP client. The bundle is self-contained — no cloning or building required. After installing, set your PRODUCTBOARD_API_TOKEN in the extension settings. Then add to your claude_desktop_config.json: Set LOG_LEVEL to error (not info). MCP uses stdio for communication — info-level logs printed to stdout will interfere with the protocol and cause the server to lock up. ⚠️ Coming soon — not yet published to npm. Use Option 1 or 2 above. 1. Log in to your Productboard workspace 2. Go to → 3. Click and copy the token

README

productboard-mcp

An MCP (Model Context Protocol) server for the Productboard API. Enables AI assistants (Claude, Cursor, etc.) to interact with your Productboard workspace.

Tools

Tool	Description
`pb_feature_list`	List features with filtering
`pb_feature_get`	Get a feature by ID
`pb_feature_create`	Create a new feature
`pb_feature_update`	Update an existing feature
`pb_feature_delete`	Delete a feature
`pb_product_list`	List products
`pb_product_create`	Create a product
`pb_product_hierarchy`	Get full product hierarchy
`pb_note_list`	List customer notes
`pb_note_create`	Create a customer note
`pb_objective_list`	List objectives
`pb_objective_create`	Create an objective
`pb_objective_update`	Update an objective
`pb_keyresult_list`	List key results
`pb_keyresult_create`	Create a key result
`pb_keyresult_update`	Update a key result
`pb_release_list`	List releases
`pb_release_create`	Create a release
`pb_release_update`	Update a release
`pb_release_status_update`	Update release status
`pb_release_timeline`	Get release timeline

Installation

Option 1: One-click install (.mcpb bundle) — Recommended

Download the latest .mcpb file from the Releases page and drag it into Claude Desktop (Developer → Extensions → Install), or double-click it in a compatible MCP client.

The bundle is self-contained — no cloning or building required.

After installing, set your PRODUCTBOARD_API_TOKEN in the extension settings.

Option 2: Local install (manual)

# 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

Then add to your 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"
      }
    }
  }
}

Important: Set LOG_LEVEL to error (not info). MCP uses stdio for communication — info-level logs printed to stdout will interfere with the protocol and cause the server to lock up.

Option 3: npx

⚠️ Coming soon — not yet published to npm. Use Option 1 or 2 above.

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

Getting a Productboard API Token

Log in to your Productboard workspace
Go to Profile & Settings → API Access
Click Generate API key and copy the token

Configuration

Required

Variable	Description
`PRODUCTBOARD_API_TOKEN`	Your Productboard API token (Bearer auth)

Optional

Variable	Default	Description
`PRODUCTBOARD_AUTH_TYPE`	`bearer`	Auth type: `bearer` or `oauth2`
`PRODUCTBOARD_API_BASE_URL`	`https://api.productboard.com/v2`	API base URL
`PRODUCTBOARD_API_TIMEOUT`	`10000`	API request timeout (ms)
`API_RETRY_ATTEMPTS`	`3`	Number of retry attempts
`API_RETRY_DELAY`	`1000`	Delay between retries (ms)
`RATE_LIMIT_GLOBAL`	`100`	Max requests per window
`RATE_LIMIT_WINDOW_MS`	`60000`	Rate limit window (ms)
`CACHE_ENABLED`	`false`	Enable response caching
`CACHE_TTL`	`300`	Cache TTL (seconds)
`LOG_LEVEL`	`info`	Log level: `trace`, `debug`, `info`, `warn`, `error`, `fatal`

Note for MCP clients: Always set LOG_LEVEL=error when using with Claude Desktop, Cursor, or any stdio-based MCP client. Higher log levels write to stdout and will break the MCP protocol.

OAuth2 (optional)

Variable	Description
`PRODUCTBOARD_OAUTH_CLIENT_ID`	OAuth2 client ID
`PRODUCTBOARD_OAUTH_CLIENT_SECRET`	OAuth2 client secret
`PRODUCTBOARD_OAUTH_REDIRECT_URI`	OAuth2 redirect URI

Troubleshooting

“MCP server locks up / produces error logs” → Add "LOG_LEVEL": "error" to the env block in your MCP config. Info logs written to stdout interfere with the stdio transport.

“npx fails / package not found” → The package is not yet published to npm. Use the .mcpb bundle or local install above.

“command not found after local build” → Point args at the full absolute path to dist/index.js, not the productboard-mcp.js wrapper.

License

MIT

View this README on GitHub

설치

npx -y @enreign/productboard-mcp

설정

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