La versione più corta
- In Comuna: Impostazioni → Integrazioni IA → Claude → copia la URL del server e il Client ID.
- In Claude.ai: Impostazioni → Connectors → Add custom connector → incolla quei valori → Connect → Authorize.
- In qualsiasi board Comuna: Membri → Aggiungi collega IA → Claude → scegli i permessi.
- In Claude.ai: digli "controlla Comuna e fai i miei pendenti".
Tutto qui. Niente API key, niente webhook, niente plugin, niente proxy. Tutto l'handshake è OAuth2; il protocollo sopra è MCP (Model Context Protocol), uno standard aperto costruito da Anthropic.
Un walkthrough dettagliato con screenshot vive in Connetti Claude al tuo board di progetto in 60 secondi.
Cosa può fare Claude una volta connesso
Tramite circa 80 strumenti MCP, Claude può:
- Leggere i tuoi board, colonne, label, membri
- Leggere il contenuto completo di qualsiasi card (descrizione, date, checklist, commenti, cronologia)
- Creare, muovere, completare e cancellare card
- Gestire label, assegnati, date, dipendenze, checklist, allegati
- Leggere e scrivere note, pagine wiki, goals, key results, milestones
- Inviare messaggi di chat e DM nei canali di progetto
- Proporre card nuove da accettare (escalation leggera)
- Tirare fuori item di attenzione da tutti i tuoi board (card stagnanti, date scadute, review senza risposta)
- Riportare il proprio progresso così vedi "Claude · lavora sulla Card #34"
Tutte le azioni sono attribuite a Claude nel feed di attività. Puoi revocare il connettore in qualsiasi momento da Comuna o da Claude.
Permessi
L'IA riceve gli stessi permessi che hai tu, scoped per board. Su un board con membri solo lettura, l'IA può leggere ma non scrivere. Su un board dove hai diritti admin, l'IA può fare tutto ciò che puoi fare — a meno che non la limiti esplicitamente dal pannello permessi del Collega IA.
Quando l'IA sta per fare qualcosa che richiede il tuo giudizio ("cancellare questa card?", "riassegnare queste tre?"), non lo fa. Apre una richiesta di review e aspetta.
Costo
Zero dal lato di Comuna. Connettere e usare Claude è gratis in Comuna per sempre.
Il costo dal lato Anthropic è ciò che copre il tuo piano Claude. Il free tier di Claude funziona per uso leggero; Claude Pro ($20/mese al momento della scrittura) ti dà considerevolmente più margine. Comuna non proxysizza token, non prende un cut, non aggiunge cariche per chiamata IA.
Privacy
Quando Claude legge una card a tuo nome, quella card è inviata ad Anthropic via MCP per quella specifica chiamata. Anthropic la gestisce secondo la propria policy sui dati — non allenano sulle chiamate API consumer-tier di default. Noi non proxysiamo i dati, non teniamo copia, non li rigiochiamo.
I token OAuth del connettore sono salvati cifrati in Supabase, scoped al tuo utente. Revocali quando vuoi in Impostazioni → Integrazioni IA di Comuna o nel pannello Connectors di Claude.
Troubleshooting
- Il connettore dice "unauthorized" dopo l'OAuth. Assicurati che l'email autorizzata corrisponda a quella del tuo workspace Comuna. Revoca e rifai il passo 2.
- Claude non vede un board. L'IA eredita i tuoi permessi. Se il proprietario del board non ti ha invitato, l'IA non lo vede neanche. Chiedi di essere aggiunto.
- Hai cambiato la password di Comuna. I token OAuth sono indipendenti; non si rompono. Scadono col proprio calendario (~30 giorni, refresh automatico).
- Vuoi disconnettere. Comuna → Impostazioni → Integrazioni IA → Disconnect. O in Claude.ai → Settings → Connectors → Remove. Qualsiasi lato taglia il link.
Altri client IA
ChatGPT funziona allo stesso modo (Settings → Apps → Developer Mode → Create — richiede piano Plus / Pro). Gemini e Cursor sono nella roadmap; il server MCP li supporta già — aspettiamo che quei client portino a GA i loro UI di connettore MCP.
Apri un workspace e connetti Claude.