# Cursor technische tutorial: configuratie en automatisering | llmnet Apps

[Naar de inhoud](#lm-inhoud)Netwerk/NL[EN](/en/)[Hubhub.llmnet.nlModellen vergelijken op taak, taal, kosten en licentie.](https://hub.llmnet.nl/)[Communitycommunity.llmnet.nlPrompttechnieken, patronen en systeemprompts.](https://community.llmnet.nl/)[APIapi.llmnet.nlLLM's robuust in software: rate limits, routing, structured output.](https://api.llmnet.nl/)[Consultancyconsultancy.llmnet.nlAI invoeren in een organisatie, van pilot tot productie.](https://consultancy.llmnet.nl/)[Nieuwsnieuws.llmnet.nlOntwikkelingen in AI, geduid voor Nederland.](https://nieuws.llmnet.nl/)[Benchmarkbenchmark.llmnet.nlZelf meten wat AI-kwaliteit is, voor jouw taken.](https://benchmark.llmnet.nl/)[Vacaturesvacatures.llmnet.nlAI-rollen, salarissen en carrièrepaden in Nederland.](https://vacatures.llmnet.nl/)[Lerenleren.llmnet.nlAI-concepten in gewoon Nederlands, van beginner tot bouwer.](https://leren.llmnet.nl/)[Gidsgids.llmnet.nlAI privé draaien op eigen Mac, pc, NAS of thuisserver.](https://gids.llmnet.nl/)[Directorydirectory.llmnet.nlHet AI-ecosysteem in kaart: tools, modellen, bedrijven.](https://directory.llmnet.nl/)[Radarradar.llmnet.nlSignalen uit X, onderzoek en communities voor indie developers.](https://radar.llmnet.nl/)[Appsapps.llmnet.nlReviews van AI-apps en open-source repo's, met tips voor wie zelf bouwt.](https://apps.llmnet.nl/)[Trendingtrending.llmnet.nlElke dag de AI-trends van X, geduid in het Nederlands.](https://trending.llmnet.nl/)[llmnet.nl — hoofdsite](https://llmnet.nl/)[](https://x.com/intent/post?url=https%3A%2F%2Fapps.llmnet.nl%2Fcursor-tutorial&text=Cursor%20technische%20tutorial%3A%20configuratie%20en%20automatisering)[](https://www.linkedin.com/sharing/share-offsite/?url=https%3A%2F%2Fapps.llmnet.nl%2Fcursor-tutorial)[](https://www.reddit.com/submit?url=https%3A%2F%2Fapps.llmnet.nl%2Fcursor-tutorial&title=Cursor%20technische%20tutorial%3A%20configuratie%20en%20automatisering)[](#)

[← Apps-overzicht](/)

# Cursor: technische tutorial

Cursor: [Review](/cursor-review)[Installeren & instellen](/cursor-installatie)[Nieuws](/cursor-nieuws)[Technische tutorial](/cursor-tutorial)

Stand september 2026, samengesteld uit onze eigen notities en nieuwsarchief; tekst machinaal opgesteld en redactioneel gecontroleerd. Controleer versies en commando's in de officiële documentatie.

Deze tutorial is voor developers die meer uit Cursor willen halen dan de chat: regels met glob-scoping, MCP-servers met variabelen en OAuth, de command-line-agent in scripts en CI, en grip op kosten en privacy. Alle bestandsnamen en sleutels zijn gecontroleerd tegen de officiële documentatie (stand september 2026).

## Regels: vier soorten

Cursor kent vier soorten instructies:

- Projectregels in .cursor/rules/, als .mdc-bestanden. Ze gaan mee in versiebeheer en gelden voor deze codebase.

- AGENTS.md in je project: een eenvoudig alternatief in gewoon markdown, dat ook andere coding agents lezen.

- Gebruikersregels in je instellingen: gelden voor al je projecten.

- Teamregels, beheerd via het dashboard (Team- en Enterprise-plannen).

Wil je dat Claude Code, Codex en Cursor dezelfde instructies volgen, zet de gedeelde regels dan in AGENTS.md en houd de Cursor-specifieke verfijning in .cursor/rules/.

### Het .mdc-formaat

Een projectregel is markdown met frontmatter. Gewone .md-bestanden in .cursor/rules/ worden genegeerd.

---
description: "API-handlers: validatie en foutafhandeling"
globs: src/api/**/*.ts
alwaysApply: false
---
- Valideer elke request-body met zod voordat je hem gebruikt.
- Geef fouten terug in het formaat `{ error: { code, message } }`.
- Log nooit volledige request-bodies; ze kunnen persoonsgegevens bevatten.
De drie velden bepalen samen wanneer een regel meedoet:

- Always Apply (alwaysApply: true): in elke sessie. Houd dit kort, want het kost bij elke vraag context.

- Apply Intelligently (alleen een description): de agent beslist aan de hand van de beschrijving. Schrijf de beschrijving dus als een criterium, niet als een titel.

- Apply to Specific Files (globs): zodra bestanden meedoen die op het patroon passen.

- Apply Manually: alleen als je de regel in de chat met @ noemt.

Praktisch patroon: één korte regel met alwaysApply: true voor de basis (stack, test- en buildcommando's), en verder regels met globs per deel van de codebase.

## MCP-servers

MCP-servers configureer je in JSON: per project in .cursor/mcp.json, of globaal in ~/.cursor/mcp.json.

Een lokale server (stdio):

{
 "mcpServers": {
 "database": {
 "command": "npx",
 "args": ["-y", "mijn-db-mcp"],
 "env": { "DATABASE_URL": "${env:DATABASE_URL}" }
 }
 }
}
Een externe server (Streamable HTTP of SSE):

{
 "mcpServers": {
 "docs": {
 "url": "https://docs.example.com/mcp",
 "headers": { "Authorization": "Bearer ${env:DOCS_TOKEN}" }
 }
 }
}
In waarden kun je variabelen gebruiken, zodat geen enkele sleutel in je repository belandt:

- ${env:NAAM}: een omgevingsvariabele.

- ${userHome}: je thuismap.

- ${workspaceFolder}: de root van het project.

- ${workspaceFolderBasename}: de naam van het project.

- ${pathSeparator}: het padscheidingsteken van het besturingssysteem.

Voor servers met vaste OAuth-gegevens voeg je een auth-object toe:

{
 "mcpServers": {
 "crm": {
 "url": "https://api.example.com/mcp",
 "auth": {
 "CLIENT_ID": "${env:MCP_CLIENT_ID}",
 "CLIENT_SECRET": "${env:MCP_CLIENT_SECRET}",
 "scopes": ["read"]
 }
 }
 }
}
Registreer bij de provider als redirect-URL http://localhost:8787/callback voor de desktop-app, en https://www.cursor.com/agents/mcp/oauth/callback voor de webversie en cloud agents.

## De command-line-agent in scripts en CI

Installeer met curl https://cursor.com/install -fsS | bash; het programma heet agent. Met -p (of --print) draait het zonder interactie.

export CURSOR_API_KEY="..." # uit je Cursor-dashboard, als secret in CI

# alleen analyseren
agent -p "Wat doet deze codebase?"

# wijzigingen doorvoeren zonder bevestiging
agent -p --force "Zet deze module om naar moderne ES-syntax"

# gestructureerde uitvoer voor verdere verwerking
agent -p --output-format json "Geef een lijst van ongebruikte exports"

- --output-format kent text, json en stream-json. Die laatste geeft voortgang in real time, handig voor lange taken in CI-logs.

- --force (ook --yolo) laat de agent bestanden wijzigen zonder te vragen. Gebruik het alleen in een schone checkout of container, en laat een mens de diff reviewen.

- --model kiest het model. Zonder die vlag gebruikt de agent je standaardinstelling.

Een simpele CI-stap die een review als artefact bewaart:

agent -p --output-format json \
 "Beoordeel de wijzigingen ten opzichte van main op bugs en beveiligingsrisico's" \
 > review.json

## Kosten beheren

Cursor werkt per september 2026 met twee maandelijkse tegoeden:

- Cursor-modellen: Cursors eigen Composer 2.5 en de Grok-modellen, met ruim inbegrepen gebruik.

- Andere modellen: Claude, GPT, Gemini en dergelijke, afgerekend tegen API-tarieven. In Auto-modus komt daar $0,25 per miljoen tokens bij.

Wat helpt:

- Gebruik voor routinewerk Composer of Auto in de stand Cost. Kies pas een duur model voor lastige taken.

- Houd alwaysApply-regels kort: ze gaan bij elke vraag mee.

- Ga je over je tegoed heen, dan kun je extra gebruik tegen API-tarieven bijkopen of een groter plan nemen. Cursor verlaagt nooit ongemerkt de kwaliteit.

## Privacy en teams

- Privacy Mode zorgt dat je code niet voor training wordt gebruikt en geldt met zero data retention. Uitzonderingen zijn eigen API-sleutels en modellen waarvoor de provider zelf data moet bewaren. Op Teams en Enterprise staat Privacy Mode standaard aan en kan een beheerder hem afdwingen.

- Houd gevoelige mappen (secrets, klantdata) buiten bereik met een .cursorignore in de root van je project; dat werkt met dezelfde syntax als .gitignore. Een regel in .cursor/rules/ is alleen een verzoek aan het model, geen afgedwongen blokkade.

## Problemen oplossen

- Een regel wordt niet toegepast: het bestand heeft de extensie .md in plaats van .mdc, of de globs passen niet op de bestanden in je context. Noem de regel met @ om te testen.

- MCP-server start niet: controleer of de variabele achter ${env:...} bestaat in de omgeving waarin Cursor draait. Apps die vanuit het Dock of het startmenu starten, zien niet altijd de variabelen uit je shellprofiel.

- OAuth-fout bij een externe server: de redirect-URL bij de provider klopt niet met de omgeving (desktop of web).

- CLI-agent vraagt om login in CI: CURSOR_API_KEY is niet gezet of niet als secret doorgegeven aan de job.

Documentatie: [cursor.com/docs](https://cursor.com/docs).
