Context7 MCP in Claude Code: zo doe je het, stap voor stap

Voorbereiding

Wat heb je nodig voor Context7 in Claude Code?

Context7 is een MCP-server van het bedrijf Upstash. Het is een dienst op internet die documentatie van duizenden programmeerbibliotheken bijhoudt en die op verzoek aan Claude geeft. Waarom dat nodig is: Claude kent een bibliotheek zoals Next.js of de Mollie-client alleen zoals die was op het moment van zijn training. Komt er daarna een nieuwe versie, dan schrijft hij code die er overtuigend uitziet maar niet meer werkt. Die verzonnen of verouderde functies heten hallucinaties. Context7 vult dat gat met de actuele documentatie.

Wat Context7 wel en niet weet

Context7 kent openbare documentatie van bibliotheken, frameworks en API's. Het kent niet jouw eigen code, je interne wiki of de afspraken in je team. Voor je eigen code leest Claude Code gewoon de bestanden in je map. Voor teamafspraken gebruik je een CLAUDE.md. Context7 is dus een opzoekboek voor andermans software, geen geheugen voor de jouwe.

Route kiezen

Plugin, claude mcp add of ctx7 setup: welke route kies je?

Er zijn drie manieren om Context7 aan Claude Code te koppelen, en de meeste Engelstalige uitleg noemt er maar één. Ze eindigen allemaal bij dezelfde dienst op mcp.context7.com. Het verschil zit in hoe je inlogt, wie de instelling beheert en of je Node.js nodig hebt.

Waarom wij de plugin aanraden

De plugin staat in de officiële marketplace van Anthropic, met Upstash als maker. Voor die marketplace staan automatische updates standaard aan, dus je hoeft niet zelf bij te houden wanneer Context7 iets wijzigt. De plugin verbindt met de online server, dus er draait niets op je eigen computer en je hebt geen Node.js nodig. Een plugin is in Claude Code een pakketje dat skills, commando's of MCP-servers in één keer toevoegt; deze bevat alleen de Context7-server.

Twee installatiecommando's die rondgaan

Context7 noemt in de eigen documentatie ook /plugin marketplace add upstash/context7 gevolgd door /plugin install context7@context7-marketplace. Dat is dezelfde dienst uit de marketplace van Upstash zelf. Kies één van de twee, niet allebei: anders heb je twee servers met dezelfde tools en weet je niet welke Claude aanroept. Voor die marketplace van derden staan automatische updates standaard uit.

Wat ctx7 setup anders doet

De installatiehulp logt je in via je browser, maakt automatisch een API-key aan en laat je kiezen tussen twee werkwijzen: MCP (zoals de andere routes) of CLI + Skills. In die tweede variant installeert hij een skill die Claude leert om de opdrachten ctx7 library en ctx7 docs in je terminal te draaien, zonder MCP-server. Handig als je organisatie MCP-servers dichtzet. Weghalen doe je met npx ctx7 remove.

Installeren

Context7 installeren in Claude Code met de plugin

Dit is de route voor de meeste mensen. Je doet alles binnen een Claude Code-sessie, in de terminal. Gebruik je Claude Code in VS Code of in de desktop-app, dan werkt het vergelijkbaar; zie de opmerking onder de stappen.

In VS Code of de desktop-app

In het Claude Code-paneel in VS Code typ je /plugins, zoek je op context7 op het tabblad Plugins en klik je op Install. In de desktop-app ga je in het tabblad Code naar de + naast het invoerveld en kies je Add plugins. De terminal, VS Code en de lokale sessies van de desktop-app lezen dezelfde instellingen, dus een plugin die je op user scope installeert, zie je in alle drie.

Liever vanuit je gewone terminal?

Buiten een sessie kan het ook: claude plugin install context7@claude-plugins-official. Dit installeert standaard op user scope. Op een computer waar nog nooit een Claude Code-sessie is gestart, staat de officiële marketplace nog niet geregistreerd. Draai dan eerst claude plugin marketplace add anthropics/claude-plugins-official.

Context7 in de Claude-app of claude.ai

Context7 staat ook in de connector-directory van claude.ai, maar daar heb je er als beginner zelden iets aan: in een chat schrijf je meestal geen code die tegen een specifieke bibliotheekversie moet draaien. Wil je het toch, zoek dan op Context7 onder Customize > Connectors. Hoe connectors in de Claude-app werken, lees je in MCP-server toevoegen.

Met API-key

Alternatief: Context7 toevoegen met claude mcp add en een API-key

Kies deze route als je op een computer werkt waar geen browser opent, zoals een server via SSH of een automatische pipeline. De plugin leest geen API-key uit een variabele, aldus Context7 zelf. Met claude mcp add geef je de sleutel direct mee.

Zet je sleutel nooit in een gedeeld bestand

Met --scope project schrijft Claude Code de server naar .mcp.json in je projectmap. Dat bestand gaat met git mee naar je collega's, en dus ook je sleutel. Gebruik voor een sleutel altijd user of local scope; die staan in ~/.claude.json op je eigen computer. Wil je dat je hele team Context7 heeft, laat dan elke collega de plugin installeren of Context7 met een eigen sleutel op user scope toevoegen. Zo heeft iedereen een eigen quotum en lekt er geen sleutel via git.

De lokale variant met npx

Context7 kan ook als programma op je eigen computer draaien: claude mcp add --scope user context7 -- npx -y @upstash/context7-mcp --api-key JOUW_API_KEY. Dat vraagt Node.js 20 of nieuwer. Het programma haalt de documentatie nog steeds op bij de servers van Context7, dus je wint er geen privacy mee. Gebruik het alleen als je netwerk de online variant blokkeert maar npm wel toelaat.

Werkt het?

Werkt Context7? Zo controleer je het met je eerste prompt

Dat Context7 in de lijst staat, bewijst nog niet dat Claude het gebruikt. Je wilt een toolaanroep zien. Plak daarom deze prompt in een nieuwe sessie. De woorden "use context7" en het versienummer zorgen dat Claude Context7 aanroept in plaats van uit zijn geheugen te antwoorden.

Waarom Claude het soms ook zonder "use context7" doet

De server van Context7 geeft Claude bij het starten een korte instructie mee: gebruik deze server voor vragen over bibliotheken, frameworks, API's en commandoregeltools, ook als je denkt het antwoord te kennen. Niet voor refactoren, bedrijfslogica of code review. Claude Code laadt bij het starten alleen de namen van MCP-tools en die instructies, de volledige tooldefinities pas als Claude ze nodig heeft. Daardoor kost Context7 je bijna geen ruimte in je contextvenster zolang je het niet gebruikt.

Wat een opzoeking kost

Elke aanroep van resolve-library-id of query-docs telt bij Context7 als één API-aanroep. Een gewone vraag kost er dus twee. In onze test op 28 oktober 2026 was één query-docs-antwoord voor de Mollie-client ongeveer 6.000 tekens, wat Claude gewoon als invoer leest. Op een Pro- of Max-plan gaat dat van dezelfde limiet af als de rest van je werk; meer daarover op Claude Code-limieten.

Slim gebruiken

Context7 slim gebruiken: library-ID, versie en een vaste regel

Met drie gewoontes krijg je betere antwoorden en verbruik je minder aanvragen. Ze komen alle drie uit de documentatie van Context7, maar de meeste tutorials laten ze weg.

1. Noem de library-ID als je die al weet

Zet de ID met schuine strepen in je prompt, bijvoorbeeld use library /supabase/supabase. Dan slaat Claude de zoekstap over. Dat scheelt één API-aanroep per vraag en voorkomt dat Claude een verkeerde bibliotheek met een vergelijkbare naam kiest. Een ID zoek je één keer op via de zoekbalk op context7.com of door Claude te vragen welke ID hij vond.

2. Noem altijd de versie

Schrijf "Next.js 16" in plaats van "Next.js". Context7 zoekt dan documentatie bij die versie. Je kunt de versie ook in de ID zetten, in de vorm /eigenaar/project/versie. Welke versie je gebruikt, staat in je package.json, composer.json of requirements.txt; je kunt Claude ook vragen die eerst te lezen.

3. Zet een vaste regel in je CLAUDE.md

Wil je niet elke keer "use context7" typen, zet dan deze regel in de CLAUDE.md van je project: Gebruik altijd Context7 als ik documentatie van een bibliotheek of API nodig heb, of stappen voor installatie of configuratie, zonder dat ik erom vraag. Dat is een vertaling van de regel die Context7 zelf voorstelt. Een CLAUDE.md is een bestand dat Claude Code aan het begin van elke sessie leest; hoe je er een maakt, staat in de CLAUDE.md-tutorial.

Een mkb-voorbeeld: een webshop met Mollie

Stel, je bouwt voor een webwinkel de betaling via iDEAL met Mollie. Zonder Context7 schrijft Claude code uit zijn geheugen, mogelijk voor een oudere versie van de Mollie-client. Met Context7 vraag je: Bouw een Node.js-route die een iDEAL-betaling aanmaakt bij Mollie, met een redirectUrl en een webhookUrl. use library /mollie/mollie-api-node. Claude haalt dan voorbeelden uit de actuele documentatie op, met een bronlink naar de GitHub-repository van Mollie. Bij onze controle op 28 oktober 2026 vond Context7 ook de API-documentatie van Exact Online (/websites/start_exactonline_nl) en Moneybird (/websites/developer_moneybird). Van AFAS stond alleen het helpcentrum erin.

Kijk naar de eigenaar in de ID

Zoek je op "mollie", dan krijg je de officiële clients van Mollie zelf (/mollie/...) maar ook een .NET-client van een particuliere ontwikkelaar. Het deel vóór de tweede schuine streep is de eigenaar van de bron. Bij een betaal- of boekhoudkoppeling wil je de officiële bron. Context7 toont per resultaat ook een Source Reputation (High, Medium of Low) en een benchmarkscore; gebruik die als hint, niet als garantie.

Problemen

Context7 werkt niet: meldingen, oorzaken en oplossingen

Dit zijn de meldingen waar beginners op vastlopen. Zoek je melding op in de eerste kolom. De meeste problemen zitten in het quotum, de sleutel of het feit dat Claude Context7 niet aanroept.

Ons oordeel

Ons oordeel: wanneer Context7 helpt en wanneer niet

Context7 is een van de weinige MCP-servers die we beginners in Claude Code zonder aarzelen aanraden. Het is klein, gratis te proberen en lost een probleem op dat iedereen tegenkomt die code laat schrijven tegen een bibliotheek die snel verandert. Toch is het geen vangnet voor alles.

De fout die we beginners het vaakst zien maken

Ze installeren Context7 en gaan ervan uit dat Claude het vanaf dan altijd gebruikt. Daarna geloven ze elk antwoord net zo blind als daarvoor. Kijk de eerste weken bij elke vraag over een bibliotheek of je resolve-library-id en query-docs voorbij ziet komen. Zie je ze niet, dan komt het antwoord uit het geheugen van Claude. Ook met Context7 test je de code zelf: de documentatie in Context7 komt van de makers van de bibliotheek en van de community, en Context7 schrijft zelf dat het juistheid, volledigheid en veiligheid niet kan garanderen.

Privacy en AVG

Bij elke opzoeking stuurt Claude een korte vraag en de naam van de bibliotheek naar de servers van Context7, een dienst van het Amerikaanse bedrijf Upstash. Je broncode gaat niet mee als Claude zich aan de tools houdt, maar de vraag kan wel details uit je project bevatten. In de documentatie van Context7 vonden we op 28 oktober 2026 geen uitleg over wat er met die vragen gebeurt. Upstash heeft een algemeen privacybeleid met een verwerkersovereenkomst (DPA). Ons advies: zet geen klantnamen, wachtwoorden of andere persoonsgegevens in een prompt waarin je Context7 laat zoeken. Werk je in een team, laat dan je privacyverantwoordelijke Context7 eerst beoordelen. Meer over de privacy van Claude Code zelf staat op Claude Code en privacy.

Wat het gratis plan je oplevert

Het gratis Context7-plan geeft 1.000 API-aanroepen per maand. Ben je die kwijt, dan krijg je nog 20 extra aanroepen per dag tot de maand voorbij is. Omdat een gewone vraag twee aanroepen kost, kom je zo op ongeveer 500 opzoekingen per maand, meer als je library-ID's gebruikt. Voor één ontwikkelaar die af en toe met een nieuwe bibliotheek werkt is dat ruim genoeg. Pro kost 10 dollar per gebruiker per maand, met 2.000 aanroepen per gebruiker en toegang tot private repositories.

Wat nu?

Wat doe je na Context7?

Werkt Context7? Dan heb je je eerste MCP-server in gebruik. De logische volgende stappen bouwen daarop voort.

Leg je afspraken vast in een CLAUDE.md

Zet de Context7-regel uit deze tutorial samen met de rest van je projectafspraken in één bestand. Zie de CLAUDE.md-tutorial.

Laat Claude je werk ook in de browser testen

Context7 helpt Claude de juiste code te schrijven. Met Playwright MCP laat je Claude controleren of de pagina daarna echt werkt.

Meer servers toevoegen of beter begrijpen

Hoe je elke andere MCP-server toevoegt, staat in MCP-server toevoegen. Wat MCP is en welke servers bestaan, lees je op MCP en connectors. Over plugins in het algemeen gaat de pagina Claude-plugins.

Je code laten nakijken

Laat Claude je wijzigingen beoordelen voordat ze live gaan, met de tutorial code review met Claude Code. Meer tutorials vind je in alle tutorials.