Docs

Connettore MCP ProWoDo — Documentazione

Setup, elenco dei tool e troubleshooting del connettore MCP di ProWoDo: gestisci task, sprint, backlog e daily planning da Claude e altri assistenti AI.

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

  1. In Claude, apri Impostazioni → Connettori.
  2. Cerca ProWoDo nella directory e clicca Connetti.
  3. Verrai reindirizzato a ProWoDo per accedere e autorizzare l'accesso. Approva gli scope richiesti.
  4. Fatto — chiedi a Claude dei tuoi task.

Setup manuale (connettore custom)

Se preferisci aggiungerlo a mano, o usi Claude Code:

  1. Apri Impostazioni → Connettori → Aggiungi connettore custom.
  2. Inserisci l'URL del server: https://mcp.prowodo.com/mcp/
  3. 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:

ScopeConcede
tasks:readLettura di task, progetti, sprint, tag
tasks:writeCreazione, modifica, completamento, riorganizzazione dei task
assignments:writeAssegnazione / rimozione di membri del team
comments:writeScrittura 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

ToolTipoCosa fa
List TasksRElenca/cerca task (filtri per progetto, stato, sprint, testo…)
Get TaskRRecupera un singolo task con tutti i dettagli
Create TaskWCrea un task (titolo, progetto, priorità, story point…)
Update / Partially Update TaskWModifica un task (stato, progress, priorità, ecc.)
Delete TaskWSoft-delete di un task
Add Tag / Remove TagWAggiunge o rimuove un tag
Assign / Unassign UserWGestisce gli assegnatari
Increase / Decrease DepthWAnnida / de-annida un task come sotto-task
Move Up / Move DownWRiordina un task nel suo livello
Relate to TaskWSposta un task rispetto a un altro
Move to ProjectWSposta un task in un altro progetto
Move to SprintWAssegna un task a uno sprint
Reorder Children / Reorder Root TasksWNormalizza l'ordinamento di un livello

Progetti

ToolTipoCosa fa
List Projects / Get ProjectRElenca i progetti di una company / ne recupera uno
Create ProjectWCrea un progetto
Update / Partially Update ProjectWModifica un progetto
Delete ProjectWSoft-delete di un progetto

Sprint e lane (Scrum)

ToolTipoCosa fa
List Sprints / Get SprintRElenca gli sprint / ne recupera uno
Create SprintWCrea uno sprint
Update / Partially Update SprintWModifica uno sprint
Delete SprintWSoft-delete di uno sprint
Start Sprint / Close SprintWAvvia / chiude uno sprint
List Sprint Lanes / Get Sprint LaneRLegge le lane dello sprint board
Move Sprint LaneWRiordina una lane

Company, utenti e tag

ToolTipoCosa fa
List Companies / Get CompanyRElenca le tue company / ne recupera una
Create CompanyWCrea una company
List Users / Get UserRElenca i membri / ne recupera uno
List / Get Task TagRLegge i tag
Create / Update / Partially Update / Delete Task TagWGestisce i tag

Daily Resume

ToolTipoCosa fa
List / Get Resume EntryRLegge le resume entry
Create / Update / Partially Update / Delete Resume EntryWGestisce le resume entry

Note e ricerca di conoscenza

ToolTipoCosa fa
List Notes / Get NoteRElenca 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 NotesRRicerca full-text su titoli e contenuto delle note. Le note private di altre persone non vengono mai restituite
Search KnowledgeRUn'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 NoteWScrive 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 NoteWSposta una nota nel cestino. Non viene rimossa per sempre: si può recuperare
List Trashed Notes / Restore NoteR / WVede le note nel cestino e ne ripristina una. L'eliminazione definitiva è possibile solo dall'app, mai via MCP
Note History / Revert NoteR / WElenca le versioni salvate di una nota e torna a una precedente (il ripristino viene salvato come nuova versione)
Note LinksRSegue i collegamenti di una nota: i [[wikilink]] che contiene e le note che puntano a lei

Ritmo (focus settimanale)

ToolTipoCosa fa
Get my weekly rhythmRIl 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 dayRIl 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 ItemsRLegge le tue voci, filtrate per ambito o giorno
Write my rhythm textWSostituisce il testo libero del ritmo, per esempio "Lunedì: clienti e tesi"
Create / Update / Delete Rhythm ItemWGestisce le voci a mano. Eliminare una voce derivata dal testo la scarta soltanto, così non viene ricreata per la stessa frase
Mark Rhythm as InterpretedWRegistra che il testo è stato trasformato in voci

Guida e note di rilascio

ToolTipoCosa fa
Get a guide to the toolsRUna breve guida ai tool, per area, per quando l'assistente non sa quale usare
Get Recent Release NotesRLe 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.