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 |
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."
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.