ProWoDo espone un server MCP remoto che permette ad assistenti AI come Claude di leggere e aggiornare i tuoi task, progetti, sprint e backlog direttamente dalla chat — niente copia-incolla, niente context switching.
- URL del server:
https://mcp.prowodo.com/mcp/ - Autenticazione: OAuth 2.0 (nessun token da incollare)
- Transport: Streamable HTTP
Setup
Dalla directory dei connettori di Claude
- In Claude, apri Impostazioni → Connettori.
- Cerca ProWoDo nella directory e clicca Connetti.
- Verrai reindirizzato a ProWoDo per accedere e autorizzare l'accesso. Approva gli scope richiesti.
- Fatto — chiedi a Claude dei tuoi task.
Setup manuale (connettore custom)
Se preferisci aggiungerlo a mano, o usi Claude Code:
- Apri Impostazioni → Connettori → Aggiungi connettore custom.
- Inserisci l'URL del server:
https://mcp.prowodo.com/mcp/ - Claude avvia automaticamente il flusso OAuth (discovery via
/.well-known/oauth-protected-resource). Accedi a ProWoDo e autorizza.
Serve prima un account ProWoDo — creane uno gratis su app.prowodo.com.
Autenticazione e permessi
Il connettore usa OAuth 2.0. ProWoDo non ti chiede mai di incollare un token in Claude. L'accesso è concesso con scope espliciti:
| Scope | Concede |
|---|---|
tasks:read | Lettura di task, progetti, sprint, tag |
tasks:write | Creazione, modifica, completamento, riorganizzazione dei task |
assignments:write | Assegnazione / rimozione di membri del team |
comments:write | Scrittura di commenti / resume entry |
L'assistente accede solo ai tuoi dati (le company di cui fai parte). Puoi rivedere e revocare il collegamento in qualsiasi momento dal tuo profilo ProWoDo, o rimuovendo il connettore dalle impostazioni di Claude.
I tool di sola lettura hanno l'annotazione readOnlyHint (girano senza conferma); quelli che modificano o cancellano dati hanno destructiveHint (Claude chiede prima la tua approvazione).
Elenco dei tool
Il server è tool-only (nessun resource o prompt MCP). I tool sono raggruppati per entità. R = sola lettura, W = scrive/modifica dati.
Task
| Tool | Tipo | Cosa fa |
|---|---|---|
| List Tasks | R | Elenca/cerca task (filtri per progetto, stato, sprint, testo…) |
| Get Task | R | Recupera un singolo task con tutti i dettagli |
| Create Task | W | Crea un task (titolo, progetto, priorità, story point…) |
| Update / Partially Update Task | W | Modifica un task (stato, progress, priorità, ecc.) |
| Delete Task | W | Soft-delete di un task |
| Add Tag / Remove Tag | W | Aggiunge o rimuove un tag |
| Assign / Unassign User | W | Gestisce gli assegnatari |
| Increase / Decrease Depth | W | Annida / de-annida un task come sotto-task |
| Move Up / Move Down | W | Riordina un task nel suo livello |
| Relate to Task | W | Sposta un task rispetto a un altro |
| Move to Project | W | Sposta un task in un altro progetto |
| Move to Sprint | W | Assegna un task a uno sprint |
| Reorder Children / Reorder Root Tasks | W | Normalizza l'ordinamento di un livello |
Progetti
| Tool | Tipo | Cosa fa |
|---|---|---|
| List Projects / Get Project | R | Elenca i progetti di una company / ne recupera uno |
| Create Project | W | Crea un progetto |
| Update / Partially Update Project | W | Modifica un progetto |
| Delete Project | W | Soft-delete di un progetto |
Sprint e lane (Scrum)
| Tool | Tipo | Cosa fa |
|---|---|---|
| List Sprints / Get Sprint | R | Elenca gli sprint / ne recupera uno |
| Create Sprint | W | Crea uno sprint |
| Update / Partially Update Sprint | W | Modifica uno sprint |
| Delete Sprint | W | Soft-delete di uno sprint |
| Start Sprint / Close Sprint | W | Avvia / chiude uno sprint |
| List Sprint Lanes / Get Sprint Lane | R | Legge le lane dello sprint board |
| Move Sprint Lane | W | Riordina una lane |
Company, utenti e tag
| Tool | Tipo | Cosa fa |
|---|---|---|
| List Companies / Get Company | R | Elenca le tue company / ne recupera una |
| Create Company | W | Crea una company |
| List Users / Get User | R | Elenca i membri / ne recupera uno |
| List / Get Task Tag | R | Legge i tag |
| Create / Update / Partially Update / Delete Task Tag | W | Gestisce i tag |
Daily Resume
| Tool | Tipo | Cosa fa |
|---|---|---|
| List / Get Resume Entry | R | Legge le resume entry |
| Create / Update / Partially Update / Delete Resume Entry | W | Gestisce le resume entry |
Note e ricerca di conoscenza
| Tool | Tipo | Cosa fa |
|---|---|---|
| List Notes / Get Note | R | Elenca le note di un'azienda (filtro per progetto, titolo, visibilità, tag, data di creazione o di modifica; ordinamento per titolo, data di creazione o di modifica) / ne recupera una |
| Search Notes | R | Ricerca full-text su titoli e contenuto delle note. Le note private di altre persone non vengono mai restituite |
| Search Knowledge | R | Un'unica ricerca full-text su titoli e descrizioni dei task, commenti dei task e note; prima i risultati migliori, con un breve estratto. I ticket di supporto non sono inclusi. Le note private di altre persone non vengono mai restituite |
| Create / Update / Partially Update Note | W | Scrive note in markdown; una nota può rimandare al task da cui nasce, ed essere condivisa con l'azienda (predefinito) oppure privata, visibile solo a te |
| Delete Note | W | Sposta una nota nel cestino. Non viene rimossa per sempre: si può recuperare |
| List Trashed Notes / Restore Note | R / W | Vede le note nel cestino e ne ripristina una. L'eliminazione definitiva è possibile solo dall'app, mai via MCP |
| Note History / Revert Note | R / W | Elenca le versioni salvate di una nota e torna a una precedente (il ripristino viene salvato come nuova versione) |
| Note Links | R | Segue i collegamenti di una nota: i [[wikilink]] che contiene e le note che puntano a lei |
Ritmo (focus settimanale)
| Tool | Tipo | Cosa fa |
|---|---|---|
| Get my weekly rhythm | R | Il tuo ritmo: il testo libero che hai scritto, le sue voci (focus per giorno, obiettivi di tutta la settimana, scadenze) e se il testo è cambiato dall'ultima volta che è stato trasformato in voci |
| Plan my day | R | Il piano di oggi: i task in focus, le scadenze che non possono aspettare (scadute o entro 3 giorni), un breve elenco del resto e ciò che va sistemato. I task arrivano già ordinati per priorità |
| List Rhythm Items | R | Legge le tue voci, filtrate per ambito o giorno |
| Write my rhythm text | W | Sostituisce il testo libero del ritmo, per esempio "Lunedì: clienti e tesi" |
| Create / Update / Delete Rhythm Item | W | Gestisce le voci a mano. Eliminare una voce derivata dal testo la scarta soltanto, così non viene ricreata per la stessa frase |
| Mark Rhythm as Interpreted | W | Registra che il testo è stato trasformato in voci |
Guida e note di rilascio
| Tool | Tipo | Cosa fa |
|---|---|---|
| Get a guide to the tools | R | Una breve guida ai tool, per area, per quando l'assistente non sa quale usare |
| Get Recent Release Notes | R | Le ultime note di rilascio di ProWoDo, dalla più recente. Chiedi cosa è cambiato dalla versione che conosci |
Prompt di esempio
- "Mostrami i task ProWoDo aperti non ancora completati."
- "Crea un task nel progetto X: 'Scrivere le release notes', priorità alta, 3 story point."
- "Segna il task #1234 come fatto e metti il progress al 100%."
- "Sposta il bug auth nello sprint corrente e assegnalo a me."
- "Dammi un riepilogo di sprint planning: task raggruppati per priorità con gli story point."
- "Dove abbiamo parlato dei retry dei webhook Stripe? Cerca in task, commenti e note."
- "Rivedi le mie note con tag inbox dell'ultimo mese e suggeriscimi cosa farne."
- "Pianifica la mia giornata."
- "Cosa è cambiato in ProWoDo dalla versione 1.24?"
Troubleshooting
"Couldn't reach the MCP server."
Verifica che l'URL sia esattamente https://mcp.prowodo.com/mcp/ (HTTPS, slash finale). Il server è pubblicamente raggiungibile; se continua a fallire, riprova il flusso OAuth.
L'autorizzazione va in loop o fallisce. Assicurati di essere loggato nell'account ProWoDo corretto nel browser che si apre per l'OAuth. Rimuovi il collegamento in sospeso dalle impostazioni di Claude e riaggiungilo.
Claude chiede conferma a ogni chiamata.
È previsto per i tool che modificano dati (destructiveHint). I tool di sola lettura (list/get) girano senza conferma.
Un tool restituisce "not found" o risultati vuoti. Vedi solo i dati delle company di cui sei membro. Verifica di esserti collegato con l'account giusto e che il progetto/company esista per quell'utente.
Voglio revocare l'accesso. Rimuovi il connettore da Impostazioni → Connettori in Claude, e/o revoca l'autorizzazione dal tuo profilo ProWoDo. L'accesso si interrompe subito.
Supporto
Domande o problemi? Scrivi a hello@prowodo.com.