Model Context Protocol

Il tuo agente, incontra il tuo command center

Il server MCP è il ponte tra il tuo client AI — Claude Code o qualsiasi altro client MCP — e la dashboard. Accedi una volta, approva la connessione, e l'agente lavora sui progetti che vedi anche tu, con l'accesso che gli hai dato e una ricevuta per ogni scrittura.

Nessuna API key da incollare, quindi niente che un agente possa lasciare nella cronologia della shell.

Endpoint del server

https://mcp.grafizum.com/mcp

Come si imposta

1

Aggiungi il server

In Claude Code esegui il comando qui sotto. Qualsiasi client MCP: usa l'endpoint sopra come URL del server (Streamable HTTP, OAuth 2.1). Chi parla MCP trova la strada da solo.

claude mcp add --transport http grafizum https://mcp.grafizum.com/mcp

https://mcp.grafizum.com/mcp

2

Approva la connessione

Il client apre una pagina di approvazione con una sola scheda nella dashboard. Accedi, scegli l'agente che deve agire e autorizza. Progetti e accesso valgono per tutto l'agente e restano modificabili.

3

Lavora

L'agente ora può leggere progetti, attività, calendario e memoria — e scrivere entro i suoi scope. Ogni scrittura finisce nel registro attività.

Cambiare la modalità di sincronizzazione

Un'impostazione sulla connessione decide se l'agente tiene aggiornata la board mentre lavora o aspetta che glielo chieda. Vive sulla connessione, non nel client: l'agente in cui la cambi non è l'unico a cui si applica.

Auto

Predefinita

Tiene la dashboard aggiornata appena il lavoro verificato è finito: il task corrispondente viene aggiornato una volta, con l'esito reale. Nessun task duplicato, nessun progresso inventato.

/gz-auto

Manuale

Su richiesta

Continua a leggere liberamente — leggere è come ti risponde — ma scrive solo se glielo chiedi in quel turno. Altrimenti dice cosa sincronizzerebbe e aspetta.

/gz-manual
Tre modi per dirlo
/gz-autoClaude Code CLI: la skill che aggiunge l'installer di Grafizum. /gz-manual è la direzione opposta.
/grafizum:autoQualsiasi client che elenca i prompt del server. Esiste anche /grafizum:manual.
switch Grafizum to manualQualsiasi agente — Codex CLI, Gemini CLI, Aider o un semplice terminale — perché la connessione ha un tool set_sync_mode. Per tornare indietro basta dire «torna su auto».

La modalità è un'istruzione che il server passa al modello, non un comportamento che può imporre — per questo la scheda della connessione mostra anche la modalità salvata, e ogni lettura di sessione la porta di nuovo con sé.

Aggiungi un client MCP personalizzato

Claude Code è la strada più corta. Qualsiasi client MCP che parla Streamable HTTP funziona allo stesso modo: dagli l'URL del server e lascia che faccia l'OAuth da solo — non c'è nessuna API key da incollare.

Formato portabile — .mcp.json, Cursor, Copilot
{
  "mcpServers": {
    "grafizum": { "type": "http", "url": "https://mcp.grafizum.com/mcp" }
  }
}

VS Code tiene gli stessi due campi sotto un oggetto "servers" in .vscode/mcp.json.

Discovery

Un client che parla MCP remoto non ha bisogno d'altro: legge il 401, poi questi due documenti, e si registra da solo.

Metadati del server OAuth

https://mcp.grafizum.com/.well-known/oauth-authorization-server

Metadati della risorsa protetta

https://mcp.grafizum.com/.well-known/oauth-protected-resource/mcp

Cosa può fare una connessione

Leggere
  • Progetti, stato e avanzamento
  • Attività e liste di to-do
  • Calendario e scadenze
  • Memoria di progetto e manuale globale
  • Riepiloghi delle attività (mai payload di segreti)
Scrivere
  • Creare e aggiornare attività
  • Riportare lo stato di un progetto
  • Registrare eventi e voci di calendario
  • Scrivere conoscenza di progetto (entro i suoi scope)
Mai
  • Segreti del caveau, token GitHub o chiavi SSH
  • Progetti non concessi alla connessione
  • Le tue decisioni di revisione

I tool che espone

I nomi esatti che elenca il tuo client e cosa fa ciascuno. La dashboard mostra gli stessi nomi mentre una chiamata è in corso; gli scope della connessione decidono quali rispondono.

Sessione

3
get_sessionIl manuale, i progetti, il file di memoria e la modalità attuale
declare_projectDice su quale progetto lavora la sessione, prima della prima scrittura
set_sync_modeRegistra auto o manuale per questa connessione

Lettura

13
get_changesCosa si è mosso dall'ultima lettura
list_projectsTutti i progetti che la connessione può vedere
get_projectUn progetto, con i suoi task e documenti
get_project_statusStato di un progetto e ultimi report
get_project_progressConteggi dei task e avanzamento di un progetto
list_tasksLa coda, filtrabile per progetto, stato o revisione
get_taskUn task, con la sua storia
list_activityLe scritture recenti, senza payload né credenziali
list_calendarScadenze e voci di calendario
list_memoryI documenti di conoscenza globali che può leggere
get_memoryUn documento di conoscenza
list_project_documentsIl file di memoria di un progetto
get_project_documentIl file di memoria di un progetto, PROJECT_GUIDE.md

Scrittura

11
create_taskUn nuovo task, con le risposte del proprietario e nessuna priorità inventata
update_taskCambia stato, data o descrizione di un task
move_taskSposta un task nella coda del suo progetto
create_projectUn progetto o sottoprogetto, dopo conferma esplicita
update_projectModifica un progetto, dopo conferma esplicita
report_project_statusRegistra avanzamento e salute di un progetto
put_project_documentScrive il file di memoria del progetto
delete_project_documentElimina un documento di conoscenza, con conferma
create_eventRegistra un evento nel log delle attività
create_calendar_eventAggiunge una voce con data, con conferma
record_sync_runRegistra un'esecuzione di sync, con conferma

Gestisci le connessioni

Ogni connessione compare nella dashboard sotto MCP, col nome dell'agente che la usa. Rinominala, limitata a meno progetti, togli la scrittura o revocala — le modifiche valgono dalla richiesta successiva, senza riconnettersi. Una connessione dura 30 giorni prima di dover essere riapprovata; gli access token durano 15 minuti e si rinnovano da soli.

Apri la scheda MCP

Come resta al sicuro

  • OAuth 2.1 authorization code con PKCE. I token sono salvati come hash, gli access token durano 15 minuti e i refresh token ruotano — uno riusato revoca l'intera connessione.
  • Una connessione è un tetto, mai un ampliamento: non può portare più scope o progetti di quanti ne abbia già l'agente, e gli scope caveau, GitHub ed eliminazione non sono mai disponibili.
  • Registrazione e autorizzazione hanno limiti di frequenza, e ogni scrittura viene controllata contro gli scope e la lista progetti della connessione prima di essere accettata.
  • L'approvazione mostra l'indirizzo esatto a cui va il codice di autorizzazione, così un nome di client familiare non può nascondere dove finisce il tuo accesso.

Se qualcosa non torna

Il client dice MCP login required (401)

Il token è scaduto o la connessione è stata revocata. Rilancia l'autenticazione dal client — riapprovare richiede un clic.

La pagina di approvazione dice che la richiesta è scaduta

Un'autorizzazione in sospeso vale 10 minuti e si usa una volta sola. Ricomincia l'autenticazione dal client. Dieci minuti sono una finestra, non un test di personalità.

Una chiamata a un tool viene rifiutata

Alla connessione manca quello scope o quel progetto. Controlla la scheda MCP, poi restringi o allarga la connessione lì.

Apri la scheda MCPSicurezza