Collegare Productboard MCP a Gemini CLI

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Productboard, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Productboard + Gemini

Product management con Productboard tramite la REST API v2: leggere e modificare prodotti, componenti, feature, iniziative, objective e key result, release, aziende e utenti come entità con campi personalizzati e relazioni, raccogliere e cercare le note di feedback dei clienti e collegarle alle feature, e consultare membri e team.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

PRODUCTBOARD_API_TOKEN

Step 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti. Ti serve un workspace Productboard con piano Pro o superiore.

1. In Productboard apri Settings > Integrations > Public APIs > Access Token e clicca + per creare un token. Copialo subito: viene mostrato una sola volta.
2. Incollalo in PRODUCTBOARD_API_TOKEN, senza il prefisso Bearer. Viene inviato come Authorization: Bearer <token> e agisce con i permessi del membro che l'ha creato, quindi il token di un admin o maker del workspace vede di più.
3. Installa il connettore ed esegui productboard_list_entity_configurations: conferma il token ed elenca i tipi di entità del tuo workspace.

Solo API v2: il connettore usa la Productboard REST API v2 (https://api.productboard.com/v2). La API v1 è stata deprecata ad aprile 2026 e dismessa l'8 luglio 2026.

Tutto è un'entità: prodotti, componenti, feature, subfeature, iniziative, objective, key result, release, gruppi di release, utenti e aziende (e concorrenti e task dove il workspace li prevede) sono entità con un type. Il feedback dei clienti sta nelle note.

Prima esplora il workspace: i campi cambiano da workspace a workspace. productboard_list_entity_configurations e productboard_get_entity_configuration mostrano tutti i campi di un tipo (quelli standard come name, description, status, owner, timeframe, teams, tags e i campi personalizzati con UUID come chiave), quali sono obbligatori e quali operazioni di patch accettano. productboard_list_note_configurations fa lo stesso per le note, productboard_list_field_values elenca le opzioni di un campo select, tag o status.

Cosa legge:

• La roadmap: productboard_list_entities con types (ad esempio ["feature"], ["objective", "keyResult"] o ["company"]) e filtri per nome, owner, status, team, entità padre o archiviazione; productboard_search_entities per filtri strutturati su più id, date, valori di campo (anche personalizzati), padri e clienti, scegliendo i campi restituiti; productboard_get_entity per un singolo elemento con l'URL links.html.
• La gerarchia: productboard_list_entity_relationships mostra padre, figli, collegamenti e blocchi, ad esempio tutte le feature di un componente.
• Feedback: productboard_list_notes per data, owner, autore, sistema di origine, stato elaborato o archiviato; productboard_search_notes per la ricerca full-text combinata con tag, cliente e feature collegate; productboard_get_note e productboard_list_note_relationships per una nota, il suo cliente e le feature collegate.
• Persone: productboard_list_members e productboard_get_member per i membri del workspace, productboard_list_teams e productboard_list_team_members per i team.

Cosa scrive:

• productboard_create_entity crea una feature, un componente, un'iniziativa, un objective, un key result, una release, un'azienda e altro con type e fields; il padre si imposta tramite relationships, ad esempio [{"type": "parent", "target": {"id": "<component id>"}}].
• productboard_update_entity sovrascrive valori con fields o applica operazioni patch (set, addItems, removeItems, clear) su liste come tag e team.
• productboard_set_entity_parent sposta un'entità sotto un altro padre; productboard_create_entity_relationship aggiunge una relazione link, isBlockedBy o isBlocking.
• productboard_create_note raccoglie un feedback nella inbox Insights con titolo, testo, tag, owner, record di origine, cliente e feature collegate; productboard_update_note lo modifica (ad esempio lo segna come elaborato); productboard_link_note collega una nota a una feature o ne imposta il cliente.

Niente da disattivare, niente da cancellare: nessun tool è disattivato all'installazione perché il connettore non ha alcun tool di cancellazione. Cancellare un'entità nella API v2 cancella anche tutti i suoi figli, quindi le cancellazioni restano nell'app Productboard.

Formati dei dati: i riferimenti sono oggetti: owner come {"email": "[email protected]"} o {"id": "<uuid>"}, uno status come {"name": "In progress"}, i tag come [{"name": "Q4"}]. timeframe ha la forma {"startDate": "2026-10-01", "endDate": "2026-12-31", "granularity": "month"}. Il content delle note e i campi rich text accettano HTML semplice o testo. Gli elenchi restituiscono data, ogni elemento con id, type, fields, links.html, createdAt e updatedAt. Tutti gli id sono UUID e gli orari ISO 8601 in UTC. Senza il permesso members:pii:read le email degli owner arrivano come [redacted].

Paginazione: quando links.next è presente, l'AI prende il valore pageCursor da quell'URL e lo passa come page_cursor; si ferma quando links.next è null.

Limiti ed errori comuni: 50 richieste al secondo per token; il 429 arriva con Retry-After. 401 indica un token errato o revocato, 403 un token il cui membro non ha i permessi per quei dati, 400 o 422 un campo o un tipo sconosciuto: il messaggio indica cosa accetta il workspace e l'AI controlla la configurazione.

Il connettore non cancella entità o note, non modifica impostazioni, campi o status del workspace e non usa la API v1 dismessa.

Step 2 — Installa l'adapter

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

Step 3 — Aggiungi il connettore in Gemini

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di Productboard.

Tool disponibili

Esempi di prompt

• "Elenca le feature in stato In progress con owner e timeframe, raggruppate per componente."
• "Quali note di feedback non elaborate delle ultime due settimane parlano di onboarding? Riassumi i temi principali."
• "Crea una feature chiamata Dark mode per l'app mobile sotto il componente Mobile, owner [email protected], status New idea."
• "Registra questo ticket di supporto come nota di [email protected] e collegala alla feature Export CSV."
• "Mostrami i nostri objective con i relativi key result per questo trimestre, con status e owner."

FAQ

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Meta Muse
• Collegare a Microsoft Copilot