Productboard MCP Server

Integra-se com a API do Productboard, oferecendo 49 ferramentas especializadas

Documentação

productboard-mcp

Um servidor MCP (Model Context Protocol) para a API do Productboard. Permite que assistentes de IA (Claude, Cursor, etc.) interajam com seu workspace do Productboard.

Ferramentas

Ferramenta	Descrição
`pb_feature_list`	Listar funcionalidades com filtros
`pb_feature_get`	Obter uma funcionalidade por ID
`pb_feature_create`	Criar uma nova funcionalidade
`pb_feature_update`	Atualizar uma funcionalidade existente
`pb_feature_delete`	Excluir uma funcionalidade
`pb_product_list`	Listar produtos
`pb_product_create`	Criar um produto
`pb_product_hierarchy`	Obter hierarquia completa do produto
`pb_note_list`	Listar notas de clientes
`pb_note_create`	Criar uma nota de cliente
`pb_objective_list`	Listar objetivos
`pb_objective_create`	Criar um objetivo
`pb_objective_update`	Atualizar um objetivo
`pb_keyresult_list`	Listar resultados-chave
`pb_keyresult_create`	Criar um resultado-chave
`pb_keyresult_update`	Atualizar um resultado-chave
`pb_release_list`	Listar versões
`pb_release_create`	Criar uma versão
`pb_release_update`	Atualizar uma versão
`pb_release_status_update`	Atualizar status da versão
`pb_release_timeline`	Obter cronograma da versão

Instalação

Opção 1: Instalação com um clique (pacote .mcpb) — Recomendado

Baixe o arquivo .mcpb mais recente da página de Releases e arraste-o para o Claude Desktop (Developer → Extensions → Install), ou clique duas vezes em um cliente MCP compatível.

O pacote é autossuficiente — não é necessário clonar ou compilar.

Após a instalação, defina seu PRODUCTBOARD_API_TOKEN nas configurações da extensão.

Opção 2: Instalação local (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

Em seguida, adicione ao seu 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"
      }
    }
  }
}

Importante: Defina LOG_LEVEL como error (não info). O MCP usa stdio para comunicação — logs de nível informativo impressos no stdout interferirão no protocolo e farão o servidor travar.

Opção 3: npx

⚠️ Em breve — ainda não publicado no npm. Use a Opção 1 ou 2 acima.

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

Obtendo um Token da API do Productboard

Faça login no seu workspace do Productboard
Vá para Profile & Settings → API Access
Clique em Generate API key e copie o token

Configuração

Obrigatório

Variável	Descrição
`PRODUCTBOARD_API_TOKEN`	Seu token da API do Productboard (autenticação Bearer)

Opcional

Variável	Padrão	Descrição
`PRODUCTBOARD_AUTH_TYPE`	`bearer`	Tipo de autenticação: `bearer` ou `oauth2`
`PRODUCTBOARD_API_BASE_URL`	`https://api.productboard.com/v2`	URL base da API
`PRODUCTBOARD_API_TIMEOUT`	`10000`	Tempo limite de solicitação da API (ms)
`API_RETRY_ATTEMPTS`	`3`	Número de tentativas de repetição
`API_RETRY_DELAY`	`1000`	Atraso entre tentativas (ms)
`RATE_LIMIT_GLOBAL`	`100`	Máximo de solicitações por janela
`RATE_LIMIT_WINDOW_MS`	`60000`	Janela de limite de taxa (ms)
`CACHE_ENABLED`	`false`	Ativar cache de respostas
`CACHE_TTL`	`300`	TTL do cache (segundos)
`LOG_LEVEL`	`info`	Nível de log: `trace`, `debug`, `info`, `warn`, `error`, `fatal`

Nota para clientes MCP: Sempre defina LOG_LEVEL=error ao usar com Claude Desktop, Cursor ou qualquer cliente MCP baseado em stdio. Níveis de log mais altos gravam no stdout e quebrarão o protocolo MCP.

OAuth2 (opcional)

Variável	Descrição
`PRODUCTBOARD_OAUTH_CLIENT_ID`	ID do cliente OAuth2
`PRODUCTBOARD_OAUTH_CLIENT_SECRET`	Segredo do cliente OAuth2
`PRODUCTBOARD_OAUTH_REDIRECT_URI`	URI de redirecionamento OAuth2

Solução de problemas

"Servidor MCP trava / gera logs de erro" → Adicione "LOG_LEVEL": "error" ao bloco env na sua configuração MCP. Logs informativos gravados no stdout interferem no transporte stdio.

"npx falha / pacote não encontrado" → O pacote ainda não foi publicado no npm. Use o pacote .mcpb ou a instalação local acima.

"comando não encontrado após compilação local" → Aponte args para o caminho absoluto completo de dist/index.js, não o wrapper productboard-mcp.js.

Licença

MIT