# Impedisci all'IA di usare API obsolete

> La tua IA scrive codice per vecchie versioni delle librerie e si inventa funzioni che non esistono più.

Questo setup è per gli sviluppatori il cui assistente IA continua a proporre API deprecate o funzioni che non esistono. Context7 carica nel contesto dell'agente la documentazione attuale e specifica per ogni versione di una libreria, mentre GitHub permette all'agente di controllare che il suo piano corrisponda al tuo codice reale. Ottieni suggerimenti basati sulla documentazione della versione che usi.

## Passaggi

1. **Aggiungi Context7**: In Cursor apri Settings > MCP e aggiungi Context7, scegliendo il server remoto su mcp.context7.com/mcp oppure il pacchetto locale @upstash/context7-mcp tramite npx. In Claude Code esegui claude mcp add con lo stesso server. Controlla che compaiano gli strumenti resolve-library-id e get-library-docs.
   Consiglio: Una chiave API di Context7, facoltativa, alza i limiti di richieste se ci arrivi.
2. **Indica la libreria**: Nel prompt scrivi la libreria e la versione che usi, per esempio Next.js 15 o Prisma 6, e aggiungi use context7. L'agente individua la libreria, recupera la documentazione giusta e scrive il codice partendo da quella. Guarda la chiamata allo strumento per vedere quale documentazione ha recuperato.
   Consiglio: Aggiungi una regola di Cursor o una riga in CLAUDE.md che chieda all'agente di usare Context7 per le domande sulle librerie, così non devi ripeterlo ogni volta.
3. **Verifica sul tuo repository**: Aggiungi il server MCP di GitHub con un token fine-grained in sola lettura per il tuo repository. Chiedi all'agente di leggere il package.json o il lockfile e gli usi già presenti prima di modificare qualcosa. Così può segnalarti le differenze tra la documentazione e la versione davvero installata.
   Consiglio: In un clone locale l'agente può già leggere i file; GitHub serve quando lavori su più repository o branch.

## Prompt da provare

- Usa context7 per mostrarmi come configurare i route handler in Next.js 15, poi aggiorna app/api/users/route.ts.
- Guarda quale versione di Prisma usiamo nel package.json e recupera la documentazione corrispondente sulle query con relazioni.
- Usa context7 e riscrivi questa configurazione di Tailwind per Tailwind CSS v4.
- L'hook useFormState è ancora l'API giusta nella nostra versione di React? Controlla la documentazione prima di rispondere.
- Confronta le nostre chiamate attuali all'SDK di Stripe con la documentazione più recente ed elenca tutto ciò che è deprecato.

## Cosa ti serve

- Cursor o Claude Code
- Node.js se esegui Context7 in locale
- Un account GitHub e un token in sola lettura per il controllo del repository
- Facoltativa: una chiave API di Context7 per limiti più alti

## Limiti

- La qualità dipende dalla documentazione della libreria stessa: documentazione scarna, risposte scarne.
- La documentazione recuperata occupa spazio nel contesto: domande molto ampie possono spingere fuori il tuo codice.
- L'agente deve comunque scegliere la versione giusta: indicala chiaramente nel prompt.

## Note di sicurezza

- Context7 legge solo documentazione pubblica.
- Limita il token GitHub ai repository su cui lavori.

## Server MCP

- [Context7 MCP Server](https://github.com/upstash/context7): docs-read
- [GitHub MCP Server](https://github.com/github/github-mcp-server): repository-read, issue-write, pull-request-write

## Domande frequenti

**Context7 è gratuito?**

Context7 ha un piano gratuito che puoi usare senza account. Una chiave API presa su context7.com ti dà limiti di richieste più alti; controlla il loro sito per i piani attuali.

**Copre tutte le librerie?**

Copre un ampio indice di librerie popolari, ma non tutte. Se una libreria manca, l'agente ripiega sui suoi dati di addestramento: in quel caso verifica il risultato con la documentazione ufficiale.

**Il mio codice viene inviato a Context7?**

L'agente invia a Context7 i nomi delle librerie e gli argomenti cercati per recuperare la documentazione. Il tuo codice sorgente resta tra il tuo editor, GitHub e il fornitore del modello.

**Mi serve GitHub perché funzioni?**

No. Context7 da solo corregge la maggior parte dei suggerimenti obsoleti. GitHub aggiunge un controllo sul tuo repository, utile quando l'agente lavora fuori dal tuo clone locale.

## Strumenti

- **[GitHub](https://suiteintent.com/t/github?m=IT)**: Hosting di codice, issue e pull request. · Ideale per: Team che revisionano il codice con pull request · Piano gratuito · 10000