Server MCP per Claude Code

Una configurazione di Model Context Protocol che merita il suo posto, insieme alle insidie che fanno perdere tempo prezioso.

MCP trasforma Claude Code da un generatore di codice in uno strumento capace di leggere il tuo repository, interrogare un database, controllare un browser e aprire una PR. La configurazione di MCP è indipendente dal gateway: cambia gli strumenti disponibili, non la destinazione delle chiamate al modello.

Un .mcp.json che vale la pena usare

Copy{
  "mcpServers": {
    "filesystem": {"command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "."]},
    "git":        {"command": "uvx", "args": ["mcp-server-git", "--repository", "."]},
    "github":     {"command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"],
                   "env": {"GITHUB_TOKEN": "..."}},
    "fetch":      {"command": "uvx", "args": ["mcp-server-fetch"]},
    "playwright": {"command": "npx", "args": ["-y", "@playwright/mcp@latest"]}
  }
}

Inseriscilo nella radice del repository; Claude Code lo rileva e ti chiede una sola volta di considerarlo attendibile.

Le insidie

• La richiesta di attendibilità è una funzionalità. Claude Code rifiuta di caricare i server MCP del progetto finché non li approvi, per ciascun progetto. È una misura di sicurezza, non un bug.
• Assegna al server del database un ruolo di sola lettura. Un server MCP esegue qualsiasi istruzione SQL generata dal modello; un ruolo di sola lettura rende un DROP generato per allucinazione materialmente impossibile.
• Limita gli ambiti di autorizzazione dei token. Per GitHub, repo insieme a read:org è sufficiente. Non fornirgli un PAT classico con tutti gli ambiti di autorizzazione.
• L'output di MCP fa parte del contesto. Un risultato di 200 righe o il contenuto di un'intera pagina viene reinviato a ogni turno successivo. Gli output voluminosi degli strumenti sono il motivo principale per cui le sessioni con agenti diventano costose.