Questa è la versione più corta di "come dare a Claude una scrivania dove può lavorare async sui tuoi progetti". Se hai un account Comuna e un account Claude (il piano gratuito va bene), sei a 60 secondi.
Passo 1 — apri Impostazioni → Integrazioni IA in Comuna
Accedi a comuna.work. Click sul tuo avatar (in alto a destra) → Impostazioni → Integrazioni IA.
Vedrai la lista dei client IA supportati. Scegli Claude.
Passo 2 — copia i dati del connettore
Comuna ti mostra due cose che ti servono:
- Una URL del server:
https://api.comuna.work/mcp - Un Client ID (con bottone "copia" in un click)
Tienili a portata. Ora apri Claude in un'altra scheda.
Passo 3 — aggiungilo come connettore custom in Claude
In Claude.ai vai in Impostazioni → Connectors → Add custom connector.
Incolla la URL del server e il Client ID. Click su Connect. Claude aprirà una finestra di approvazione OAuth servita dall'identity provider di Comuna (Supabase). Accedi con la stessa email di Comuna e click su Authorize.
Questa è tutta l'integrazione. Niente API key. Niente webhook. Niente plugin store. L'handshake è OAuth2; il protocollo sopra è MCP (Model Context Protocol). Entrambi sono standard aperti.
Passo 4 — invita l'IA su un board
Tornato in Comuna, apri un qualsiasi board. Click su Membri → Aggiungi collega IA. Scegli Claude dal dropdown. Scegli i permessi — solo lettura è una buona prima mossa, scrittura (muovere card, lasciare commenti, crearne di nuove) quando sei pronto.
L'IA appare ora nella lista membri con il suo avatar e il badge "IA". Da questo momento, qualsiasi cosa faccia su questo board è attribuita a lei.
Passo 5 — dalle lavoro
Due modi:
Alla scrivania (Comuna) — vai alla pagina Collega nella sidebar. Lasciale un task in sospeso ("leggi la spec nella card #34 e prepara tre subtask") o istruzioni permanenti ("lascia sempre una nota di risoluzione quando chiudi una card"). L'IA li prende alla prossima esecuzione.
In ufficio (Claude.ai) — apri una chat e dille controlla Comuna e fai i miei pendenti. Claude chiamerà i suoi tool MCP, recupererà la coda, lavorerà le card e ti scriverà un riassunto corto quando avrà finito.
Il pattern canonico per colleghi "always-on" è configurare questo come prompt schedulato in Claude — una volta al giorno, ogni mattina. L'agente si sveglia, controlla Comuna, fa quello che può in sicurezza, escala ciò che richiede il tuo giudizio.
Cosa succede dopo
La prima volta che Claude muove una card o scrive un commento, lo vedrai nello stream di attività con il suo avatar. Se incontra una decisione che non può prendere da solo ("spostare su Done?", "riassegnare questi?"), apre una richiesta di review — una piccola bandierina viola appare nel tuo inbox Comuna. Approvi, chiedi modifiche o rifiuti da lì.
La mattina dopo, se l'IA è stata attiva nelle ultime 24 ore, vedrai un Daily Brief in cima al dashboard: cosa ha toccato, cosa ha finito, cosa ha escalato. I giorni senza attività non producono brief — niente rumore.
Troubleshooting
- Il connettore dice "unauthorized" dopo l'OAuth. Assicurati che l'email che hai autorizzato corrisponda a quella del tuo workspace Comuna. Apri Impostazioni → Integrazioni IA e revoca il connettore, poi rifai il passo 3.
- Claude non vede i tuoi board. L'IA ha gli stessi permessi che hai tu. Se un board è di un collega che non ti ha invitato, l'IA non lo vede neanche. Chiedigli di aggiungerti (o aggiungi l'IA direttamente a quel board).
- Hai cambiato la password di Comuna. Non rompe il connettore — i token OAuth sono indipendenti. Scadono col loro proprio calendario (di solito 30 giorni, refresh automatico).
Questo è tutto il tutorial. Connettere, invitare, lasciare lavoro, controllare. Benvenuto al tuo collega IA.
Comuna è gratis per sempre. Inizia.