Canny MCP Server per feedback e changelog

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

Canny

Feedback dei clienti su Canny: leggi bacheche, post e richieste di funzionalità con voti e commenti, utenti e aziende con MRR, categorie, tag e storico degli stati, registra nuovi post, voti e commenti, fai triage con cambi di stato, tag e responsabili, e scrivi, pianifica e pubblica voci del changelog.

Setup

La configurazione richiede circa 1 minuto. Ti servono un workspace Canny e l'accesso alle sue impostazioni aziendali.

1. In Canny apri Settings > API & Webhooks (le impostazioni dell'azienda) e copia la secret API key in CANNY_API_KEY.
2. Installa il connettore ed esegui canny_list_boards: elenca le tue bacheche di feedback e conferma la chiave.

Come viaggia la chiave: ogni chiamata a Canny è un POST con un body JSON, anche quelle di lettura. Canny si aspetta la chiave nel campo apiKey di quel body, e il connettore la aggiunge da solo a ogni richiesta. È la chiave segreta di tutta la tua azienda su Canny, quindi affidala solo a workspace fidati.

Cosa legge:

• Le bacheche con numero di post, flag privato e URL di amministrazione; le categorie (e sottocategorie) e i tag di ogni bacheca.
• I post (idee e richieste di funzionalità) con canny_list_posts, filtrati per bacheca, autore, azienda, tag, stato o testo di ricerca e ordinati per newest, oldest, score, trending, statusChanged o relevance. Con sort: score o trending vedi cosa è più richiesto. canny_get_post aggiunge campi personalizzati, ETA, issue Jira o Linear collegate e lo storico dei merge.
• I commenti (incluse le note interne visibili solo al team) e i voti con votante, priorità e data, filtrati per post, bacheca, autore o utente, o azienda.
• Lo storico dei cambi di stato con stato vecchio e nuovo, chi l'ha cambiato e il commento allegato.
• Gli utenti con email, l'id utente della tua app, aziende e flag admin; le aziende (account cliente) con dominio, spesa mensile (MRR), numero di membri e campi personalizzati, ricercabili per nome o segmento.
• Le voci del changelog, incluse bozze e pianificate, con dettagli in markdown, tipi, etichette e post collegati.

Cosa scrive:

• Raccogliere feedback: canny_create_or_update_user crea la persona (o aggiorna quella corrispondente) e restituisce l'id Canny che serve come autore o votante; con companies collega e crea anche le aziende. Poi canny_create_post per una nuova idea, oppure canny_create_vote su un post esistente quando qualcuno chiede qualcosa che c'è già, con una priorità facoltativa. canny_create_comment aggiunge un commento o una risposta (parent_id), con internal: true per una nota visibile solo al team.
• Triage: canny_change_post_status imposta open, under review, planned, in progress, complete, closed o uno stato personalizzato. Serve l'id Canny di un admin come changer_id, e should_notify_voters manda un'email a tutti i votanti. canny_update_post modifica titolo, dettagli, ETA, immagini, responsabile o campi personalizzati; canny_change_post_category, canny_add_post_tag e canny_remove_post_tag organizzano i post; canny_create_category e canny_create_tag ampliano una bacheca.
• Aziende: canny_update_company modifica nome, dominio, spesa mensile o campi personalizzati. Un CRM sincronizzato può sovrascrivere questi valori.
• Changelog: canny_create_changelog_entry scrive una bozza di default; published: true o scheduled_for la pubblica, e post_ids collega i post che rilascia. canny_update_changelog_entry modifica titolo, dettagli, tipi, etichette e post collegati (le liste passate sostituiscono quelle vecchie), e canny_change_changelog_entry_status pubblica, pianifica o riporta una voce in bozza. Con notify attivo, la pubblicazione manda un'email ai tuoi utenti.

Niente è disattivato all'installazione: il connettore non ha strumenti di eliminazione. Tieni presente che un cambio di stato con should_notify_voters e una voce del changelog pubblicata con notify inviano email.

Id: tutti gli id sono stringhe esadecimali di 24 caratteri. I filtri company_id usano l'identificativo dell'azienda come lo restituisce canny_list_companies (l'id della tua app quando le aziende sono sincronizzate). L'id Canny di un admin per changer_id, by_id o owner_id si ottiene da canny_list_users (voci con isAdmin: true) o da canny_get_user con l'email dell'admin. canny_get_user trova un utente tramite uno solo tra id Canny, email o id utente nella tua app.

Formati dei dati: i post riportano score (il numero di voti), commentCount, status, eta e url (il link di amministrazione). Gli orari sono ISO 8601 in UTC. I dettagli del changelog sono in markdown.

Paginazione: due modalità. canny_list_posts, canny_list_categories, canny_list_tags e canny_list_changelog_entries usano limit e skip e rispondono con hasMore. canny_list_comments, canny_list_votes, canny_list_users, canny_list_companies e canny_list_status_changes usano limit (fino a 100) e cursor: l'AI passa il cursor restituito finché hasNextPage è true. Una ricerca di aziende non si pagina con il cursore.

Limiti: per chiave 5 richieste al secondo e 1.000 all'ora nel piano Free, 10 e 5.000 nei piani a pagamento, 20 e 15.000 in Business. Il 429 arriva con Retry-After.

Errori comuni: Canny segnala gli errori come {"error": "..."}. Un messaggio sulla API key torna come 401: copia di nuovo la chiave segreta da Settings > API & Webhooks. Un messaggio sui limiti torna come 429, tutto il resto come 400, per esempio invalid post id.

Il connettore non elimina né unisce post, non elimina commenti, voti, utenti o voci del changelog, non crea bacheche e non gestisce i webhook.

Prerequisiti: CANNY_API_KEY

Installazione locale del connettore

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

Apri http://localhost:3000/connectors/store, scegli Canny e inserisci le variabili elencate nei Prerequisiti.

Tool disponibili

Esempi di prompt

• "Quali sono le dieci richieste di funzionalità aperte più votate sulla nostra bacheca Feature Requests?"
• "Quali post sono passati a planned o in progress nell'ultimo mese, e chi li ha cambiati?"
• "Quali aziende con il MRR più alto hanno votato la richiesta della modalità scura?"
• "[email protected] oggi in call ha chiesto un'esportazione CSV. Aggiungi il suo voto al post esistente, o crea il post se non c'è."
• "Scrivi una bozza di voce del changelog per la nuova modifica in blocco e collega i post che rilascia."

Prossimi passi

• Collegare a Claude
• Collegare a ChatGPT