Collegare Productboard MCP a Microsoft Copilot

💡 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 + Microsoft Copilot

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 Microsoft Copilot

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.

Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.

1. In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
2. Inserisci un Server name (per esempio AnythingMCP), una Server description che dica cosa fa il connettore e il Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server.
3. Come autenticazione scegli API key, imposta Type su Header e come nome dell'header X-API-Key, poi seleziona Create.
4. In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
5. Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di Productboard.
6. Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.

Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.

Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.

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

Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.

Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.

L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Gemini
• Collegare a Meta Muse