Context7 per Cursor e Claude Code: configurazione e verifica

Quando un agente propone un metodo sconosciuto, chiedi la fonte. Un esempio plausibile può appartenere a un'altra versione o non corrispondere all'API. Serve la documentazione della libreria realmente usata.

Context7 cerca documentazione di librerie e fornisce passaggi pertinenti all'agente. Si collega a Cursor e Claude Code. Offre fonti per lavorare sulle API; il codice risultante va comunque verificato nell'applicazione. Panoramica.

• Panoramica

La guida riguarda i client locali e una richiesta di controllo per distinguere una ricerca reale da una risposta a memoria. Le istruzioni sono state confrontate con fonti ufficiali; non è stato effettuato accesso al tuo account né un test su di esso.

Quando è utile

Scegli un compito legato a una libreria: router, moduli, query ORM o caricamento tramite SDK. Occorre conoscere metodi, parametri e comportamento documentato.

Per un refuso o una regola di business interna, la ricerca esterna può non servire. Identifica prima l'informazione mancante.

Non chiedere di «collegare tutta la documentazione». Formula la domanda a cui rispondere.

Come funziona la ricerca

In MCP, `resolve-library-id` trova l'identificatore e `query-docs` recupera materiale per la domanda. Se l'identificatore è noto, puoi saltare il primo passaggio. Integrazione.

• Integrazione

Compito e versione del pacchetto
        ↓
Scegliere la libreria
        ↓
Cercare nella documentazione
        ↓
Confrontare con il codice
        ↓
Modificare e verificare

Ogni passaggio si verifica separatamente. Riscrivere bene un esempio non corregge la scelta della libreria sbagliata. Una fonte adatta non dimostra un'integrazione corretta.

Prima dell'installazione

Servono Cursor o Claude Code, Internet e Node.js con npm/npx. L'installatore ctx7 richiede Node.js 18 o successivo; per un ambiente nuovo usa una LTS supportata. Requisiti CLI.

• Requisiti CLI

Nel terminale:

node --version
npx --version

Se manca un comando, configura Node.js nell'ambiente usato per l'installazione: macOS, Windows o WSL.

Se Context7 è già collegato, esamina la configurazione prima di reinstallare. Due connessioni con autenticazioni diverse rendono difficile capire quale usa l'agente.

Collegare Claude Code

Esegui:

npx ctx7 setup --claude

L'installatore guida l'accesso OAuth e propone una modalità. Segui le indicazioni e completa l'autorizzazione nel browser. È il percorso documentato per Claude Code.

• Claude Code

MCP espone strumenti del server; CLI + Skills usa comandi ctx7 guidati da uno skill. Scegli MCP per osservare le chiamate nell'esempio. La configurazione CLI è globale per impostazione predefinita; `--project` la limita al progetto corrente. Modalità.

• Modalità

Apri poi Claude Code e `/mcp` per vedere server e stato. Gestione MCP.

• Gestione MCP

Con CLI + Skills verifica le chiamate effettive a ctx7, non la presenza di un server MCP. Sono percorsi diversi.

Collegare Cursor

Usa il comando dedicato:

npx ctx7 setup --cursor

Completa l'autorizzazione e scegli MCP per ripetere l'esempio. Guida Cursor.

• Guida Cursor

Per la configurazione manuale, apri le impostazioni MCP. Il file globale è `~/.cursor/mcp.json`, quello di progetto `.cursor/mcp.json`. Esempio HTTP ufficiale:

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

`YOUR_API_KEY` è il segnaposto della tua chiave. Vedi la configurazione ufficiale. Aggiungi context7 a mcpServers mantenendo le altre connessioni.

• configurazione ufficiale

Non salvare una chiave personale nel repository condiviso. Per iniziare manualmente, usa il file personale. OAuth usa `https://mcp.context7.com/mcp/oauth`: non mescolare i metodi. Autenticazione.

• Autenticazione

La configurazione automatica in genere basta. Passa a quella manuale per esaminare o gestire le impostazioni direttamente.

Verificare l'uso effettivo

Parti da una libreria nota. In un progetto con Zod:

Trova la versione installata di Zod. Usa Context7 per capire come quella versione valida email e restituisce risultati senza eccezioni. Prima scegli la libreria, poi consulta la documentazione. Mostra identificatore, fonti e un breve esempio. Se la versione non è confermabile, dichiaralo. Non modificare file.

È una richiesta didattica, non un risultato osservato. Senza Zod, scegli un pacchetto installato conosciuto e una piccola domanda sull'API.

Se hai fornito l'identificatore, l'assenza di `resolve-library-id` è normale. Conta interrogare la libreria corretta. Una risposta fluida dopo un errore dello strumento non trasforma il fallimento in verifica.

Perché conta la versione

Indicarla restringe la domanda, ma va confrontata con il materiale trovato. La CLI offre identificatori versionati quando compaiono nei risultati: scegli dalla lista effettivamente restituita. Librerie e versioni.

• Librerie e versioni

Se il progetto usa una vecchia versione principale e l'esempio una nuova, non migrare tutto subito. Verifica prima se l'operazione esiste nella versione installata. Aggiornare una dipendenza è una decisione separata.

Segui questo ordine:

1. Identifica la versione nei file del progetto.
2. Trova l'operazione documentata.
3. Verifica la compatibilità dell'esempio.
4. Apporta una modifica limitata e controllala.

Se la versione resta incerta, apri direttamente documentazione ufficiale o guida di migrazione. Nessun risultato in uno strumento non significa nessuna soluzione.

Serve sempre scrivere use context7?

L'indicazione `use context7` aiuta a provare il collegamento. Il setup può installare anche uno skill di documentazione. Opzioni di invocazione.

• Opzioni di invocazione

Per l'uso abituale definisci una condizione:

Se la soluzione dipende da un'API esterna, identifica prima
la versione installata e cerca documentazione adatta con Context7.
Se la fonte manca o la versione non è confermata, dichiaralo
e consulta direttamente la documentazione ufficiale.

Puoi inserire questa regola proposta in CLAUDE.md o nelle regole Cursor. Definisce occasione e alternativa senza imporre ricerche per ogni correzione di testo.

• CLAUDE.md

Se non funziona

Controlla la fase che fallisce. Reinstallare l'intero client raramente chiarisce la causa.

I primi quattro riguardano l'accesso; gli ultimi due ricerca e applicazione. Vedi Troubleshooting.

• Troubleshooting

Cursor Cloud Agents usa una propria configurazione MCP. Il funzionamento locale non prova la disponibilità nel cloud. Segui la guida Cloud Agents.

• guida Cloud Agents