Blog Kalinotes - Maggio 2026

I connettori MCP (Model Context Protocol) permettono ora al tuo assistente AI di leggere e scrivere direttamente nei tuoi progetti Kalinotes. Combinati con gli skills di Claude Code, trasformano la presa di note, la revisione delle applicazioni e il tracciamento dei bug in flussi di lavoro completamente automatizzati — senza lasciare il terminale o l'IDE.

Cos'è il protocollo MCP?

Il Model Context Protocol (MCP) è uno standard aperto sviluppato da Anthropic che consente agli agenti AI di connettersi a fonti di dati e strumenti esterni in modo standardizzato. In pratica, invece di copiare e incollare manualmente il contenuto tra il tuo assistente e i tuoi strumenti, il connettore MCP crea un collegamento diretto: l'AI può leggere le tue note, creare nuovi contenuti e aggiornare voci esistenti in tempo reale.

Kalinotes offre il proprio connettore MCP che dà accesso all'intero spazio di lavoro: progetti, categorie, note e commenti. La tua AI dispone così dello stesso contesto tuo, senza alcuno sforzo aggiuntivo.

Configurare il connettore MCP di Kalinotes

La configurazione avviene in tre passi dal terminale:

1. Installa Claude Code: npm install -g @anthropic-ai/claude-code
2. Recupera il tuo token API nelle impostazioni del tuo account Kalinotes
3. Aggiungi il server MCP a Claude Code: claude mcp add kalinotes --token IL_TUO_TOKEN

Una volta configurato, Claude Code accede a tutti i tuoi progetti e categorie di Kalinotes. Puoi verificare la connessione chiedendo a Claude: «Elenca i miei progetti Kalinotes».

Gli 8 skills Claude disponibili per Kalinotes

Gli skills sono comandi slash (file Markdown collocati in ~/.claude/commands/) che estendono le capacità di Claude Code con flussi di lavoro specializzati. Kalinotes offre otto skills dedicati, scaricabili dalla pagina app.kalinotes.com/outils/claude-skills .

Installazione degli skills

Ogni skill è un file .md da collocare in ~/.claude/commands/ per disponibilità globale, oppure in .claude/commands/ a livello di progetto per una portata locale. Una volta in posizione, il comando slash corrispondente è immediatamente disponibile in qualsiasi sessione di Claude Code.

Caso d'uso: revisione completa di un'applicazione con /kalinotes-qa

Ecco uno scenario concreto che illustra la potenza della combinazione MCP + skills. Hai appena terminato lo sviluppo di un'applicazione web e vuoi effettuare una revisione qualitativa prima della consegna, generare note di bug e miglioramenti, consultare un rapporto di sintesi e condividere i risultati con il tuo cliente o il tuo team.

Passo 1 — Connettere la tua AI e installare gli skills

Dopo aver configurato il connettore MCP come descritto sopra, scarica gli skills dalla pagina degli strumenti di Kalinotes. Copia i file kalinotes-qa.md e kalinotes-bug.md nella cartella ~/.claude/commands/. Poi apri Claude Code nella directory del tuo progetto:

Passo 2 — Avviare la revisione QA con /kalinotes-qa

Avvia l'audit indicando l'URL della tua applicazione (o il percorso locale se è in esecuzione in sviluppo):

/kalinotes-qa https://mia-app.example.com

Claude Code analizza l'applicazione secondo quattro assi:

• Funzionale: verifica dei flussi utente, moduli, link, navigazione
• UX: coerenza visiva, accessibilità, leggibilità dei messaggi di errore
• Performance: tempi di caricamento, immagini non ottimizzate, risorse bloccanti
• Sicurezza: intestazioni HTTP mancanti, dati sensibili esposti, configurazioni rischiose

Passo 3 — Generare note di bug e miglioramenti

Al termine dell'audit, Claude crea automaticamente note strutturate nel tuo progetto Kalinotes. Ogni anomalia rilevata genera una nota di bug tramite /kalinotes-bug, che include:

• Descrizione del sintomo osservato
• Passi per riprodurre il problema
• Criticità stimata (bloccante, grave, minore)
• Suggerimento di correzione

I punti di miglioramento (UX, performance, accessibilità) vengono salvati in una categoria dedicata «Miglioramenti», con una valutazione di priorità e il beneficio atteso per l'utente finale.

Passo 4 — Visualizzare il rapporto di sintesi

Una volta create le note, usa lo skill /kalinotes-review per generare un rapporto consolidato del progetto:

/kalinotes-review

Claude aggrega tutte le note del progetto e produce un riepilogo strutturato:

• Numero di bug per criticità
• Elenco dei miglioramenti prioritizzati
• Riepilogo delle decisioni tecniche eventualmente prese
• Stima del carico di correzione

Questo rapporto può essere condiviso direttamente con il cliente o il project manager come verbale della fase di collaudo.

Passo 5 — Condividere l'accesso al progetto

Kalinotes consente di condividere un progetto con altri utenti dall'interfaccia web. Vai alle impostazioni del progetto interessato e invita i tuoi collaboratori per indirizzo e-mail. Puoi definire due livelli di accesso:

• Solo lettura: ideale per un cliente che segue l'avanzamento senza modificare le note
• Collaboratore: accesso completo per un membro del team che partecipa alla revisione

I membri invitati accedono direttamente alle note create dalla tua AI senza dover installare Claude Code né configurare l'MCP — la collaborazione rimane fluida anche per i non sviluppatori.

Perché questo approccio cambia le regole del gioco

La combinazione MCP + skills elimina i passaggi manuali più dispendiosi in termini di tempo nel ciclo di revisione: inserimento dei bug, organizzazione delle note, redazione del rapporto. L'AI si occupa della documentazione mentre tu ti concentri sulle decisioni e le correzioni. E poiché tutto è centralizzato in Kalinotes, i feedback restano accessibili, tracciabili e condivisibili, indipendentemente dalle dimensioni del team.