Server MCP: Connettere Claude al tuo Stack
Installa e configura i server MCP per dare a Claude accesso in tempo reale a Slack, Supabase, Notion e GitHub. Nessun codice "colla" richiesto.
Una skill è un file markdown con frontmatter in ~/.claude/skills/. Claude scopre le skill leggendo il loro campo di descrizione; quando la tua richiesta corrisponde, carica e segue il runbook. Scrivi le istruzioni una volta, ottieni gli stessi passaggi ogni volta.
---
name: translate-pi-jargon
description: Traduci il gergo legale PI in inglese semplice. Usa quando l'utente incolla testo legale o fa riferimento a termini come UM/UIM, lettera di richiesta o privilegio.
---
# Traduci il gergo PI
1. Riformula il termine in una frase semplice.
2. Fornisci un esempio di una frase su quando è importante.
3. Segnala qualsiasi cosa con pressione temporale (statuti, scadenze).Scrivi una skill la terza volta che incolli la stessa ricetta in Claude.
La descrizione è il meccanismo di scoperta. Claude legge le descrizioni e decide quale skill, se presente, si applica alla tua richiesta.
Cattivo: "Una skill per lavorare con i documenti." Claude non può capire quando questo si applica.
Buono: "Usa quando l'utente incolla un contratto o chiede di riassumere, modificare o estrarre termini da un PDF."
La formula: "Usa quando [trigger specifico]. Si applica a [tipi di contenuto specifici]."
Skill o regola CLAUDE.md? Le skill sono procedure ripetibili in più passaggi; le regole CLAUDE.md sono vincoli sempre attivi. Un runbook di deploy di 10 passaggi è una skill. "Non eseguire mai migrazioni contro la produzione senza un backup" è una regola. Entrambi appartengono al sistema.
Un server MCP (Model Context Protocol) è un adattatore che espone strumenti esterni a Claude. Slack, Supabase, Notion, GitHub: Claude chiama l'MCP, l'MCP chiama l'API, tu scrivi zero codice "colla". Invece di copiare e incollare dati nei prompt, Claude legge i dati in tempo reale e agisce direttamente.
MCP del database: "Mostrami gli utenti che si sono iscritti la scorsa settimana ma non si sono attivati" viene eseguito come una query in tempo reale.
MCP di Slack: "Riassumi ciò che #engineering ha discusso oggi" estrae messaggi in tempo reale.
MCP di Notion: "Aggiorna la wiki del progetto con le decisioni di oggi" scrive direttamente.
MCP di GitHub: "Elenca le PR aperte da più di 7 giorni" interroga lo stato del repository in tempo reale.
Schema di installazione: installa il server (npx o uvx), aggiungi la configurazione a ~/.claude/settings.json:
{
"mcpServers": {
"slack": {
"command": "npx",
"args": ["-y", "@your-org/mcp-slack"],
"env": { "SLACK_BOT_TOKEN": "xoxb-your-token-here" }
}
}
}Regole di sicurezza:
Non incollare mai token reali in file pubblici; iniettali tramite variabile d'ambiente o archivio segreto.
Gli MCP del database ottengono credenziali di sola lettura con ambito alle tabelle di cui Claude ha bisogno. Le chiavi del ruolo di servizio possono eliminare le tabelle.
Rivedi quali strumenti ogni MCP espone prima di distribuire.
Gli MCP che eseguono azioni ottengono un gate di approvazione.
Scegli il tuo primo MCP chiedendoti: cosa incollo attualmente in Claude da un sistema esterno? I risultati delle query del database indicano l'MCP di Supabase; gli elenchi di PR a GitHub; i riassunti dei canali a Slack; le note a Obsidian. Un MCP installato e attivamente utilizzato batte quattro configurati e ignorati.
Testalo: chiudi e riapri Claude Code per attivare la scoperta, quindi chiedi: "Quali strumenti hai a disposizione da [nome MCP]?" Se l'elenco è vuoto, controlla la sintassi di settings.json e conferma che npx o uvx sia nel tuo PATH.
Skill e MCP si combinano. Una skill di runbook di deploy più un MCP di GitHub più un MCP di Slack: Claude segue il runbook, legge lo stato delle PR in tempo reale, pubblica aggiornamenti sui progressi. Un deploy manuale di 20 minuti diventa 2 minuti. Il costo di configurazione è di circa 30 minuti per skill e 10 per MCP; i primi cinque utilizzi lo ripagano.
Nessun MCP pubblicato per il tuo strumento? Un server personalizzato minimale che utilizza l'SDK Python ufficiale espone uno strumento in circa 30-40 righe: definisci il nome, la descrizione e lo schema di input dello strumento, quindi gestisci la chiamata. Dai alla descrizione dello strumento la stessa specificità di una descrizione di skill. Costruisci MCP personalizzati per dati in tempo reale, frequentemente interrogati; per dati di riferimento statici, una skill che ti chiede di incollarli è sufficiente.
Gestione delle credenziali per configurazioni di team. I token hardcoded in un settings.json condiviso sono un incidente in attesa di accadere. Due schemi più sicuri: pass-through dell'ambiente ("SLACK_TOKEN": "$SLACK_TOKEN", con il valore reale nel tuo profilo shell) o un gestore di segreti che il server MCP interroga all'avvio (Vault, 1Password CLI), in modo che nulla di sensibile rimanga sul disco.
Ambito al minimo: un ruolo Postgres di sola lettura per Supabase, un token GitHub granulare limitato a repository specifici, un token bot di Slack limitato ai canali che Claude dovrebbe vedere.
Audit: per gli MCP che possono scrivere, aggiungi un hook PostToolUse che registra timestamp, nome dello strumento, argomenti e stato del risultato.
Le skill sono runbook markdown che Claude scopre tramite descrizione; scrivine una la terza volta che incolli le stesse istruzioni. Gli MCP connettono Claude alle API esterne senza codice "colla"; usa credenziali di sola lettura e con il minimo privilegio. La migliore prima skill: la procedura che hai spiegato due volte questa settimana. Il miglior primo MCP: il sistema da cui copi-incolli di più.