Wat is de Notion MCP-server voor Claude?

Kort antwoord: De Notion MCP-server verbindt Claude via het Model Context Protocol rechtstreeks met je Notion-workspace. Na de installatie kan Claude Notion-pagina's lezen, doorzoeken, bijwerken en aanmaken via natuurlijke taal. De installatie duurt minder dan 20 minuten en vraagt geen programmeerervaring.

De Notion MCP-integratie maakt van Claude een losstaande AI-assistent die echt nuttig is voor B2B SaaS-teams: een AI die je daadwerkelijke documentatie leest, je databases bevraagt en je pagina's bijwerkt zonder dat je van tabblad hoeft te wisselen.

Deze gids behandelt de volledige installatie voor zowel Claude Desktop als Claude Code, plus de praktische workflows waar SaaS-teams de meeste waarde uit halen zodra alles is gekoppeld.

Wat is de Notion MCP-server?

De Notion MCP-server is een officiële integratie van Notion die het Model Context Protocol (een open standaard van Anthropic) gebruikt om Claude directe toegang te geven tot je Notion-workspace. In plaats van content te kopiëren en in Claude te plakken, leest en schrijft Claude rechtstreeks in Notion.

Dat is belangrijk voor B2B SaaS-teams, omdat je Notion-workspace waarschijnlijk je productspecificaties, klantonderzoek, onboardingdocumenten en vergadernotities bevat. Als je Claude met die context verbindt, is het een veel nuttigere assistent dan wanneer hij vanaf nul begint.

Wat Claude kan doen zodra hij is gekoppeld:

• Je hele Notion-workspace doorzoeken op trefwoord of onderwerp
• De volledige inhoud lezen van elke pagina waartoe hij toegang heeft
• Database-items bevragen en filteren op eigenschappen
• Nieuwe pagina's en database-items aanmaken
• Bestaande pagina-inhoud bijwerken
• Lange documenten samenvatten op verzoek

Wat je nodig hebt voordat je begint

Controleer voordat je de Claude Notion MCP-integratie instelt of je het volgende hebt:

• Claude Desktop (gratis of Pro) of Claude Code geïnstalleerd
• Een Notion-account (elk abonnement)
• Node.js geïnstalleerd op je computer (versie 18 of hoger)
• Beheerderstoegang tot je Notion-workspace, of toestemming om integraties aan te maken

Gebruik je specifiek Claude Code, dan publiceert Notion ook een officiële plugin die de MCP-server bundelt met kant-en-klare slash-commando's. Die optie behandelen we hieronder apart.

Notion MCP instellen met Claude Desktop

Stap 1: Maak een Notion-integratie aan

1. Ga naar notion.so/my-integrations
2. Klik op New integration
3. Geef de integratie een naam (bijvoorbeeld "Claude MCP")
4. Selecteer de workspace waartoe Claude toegang moet krijgen
5. Schakel onder capabilities Read content, Update content en Insert content in
6. Klik op Save
7. Kopieer de Internal Integration Token die verschijnt. Je hebt die nodig in stap 3.

Stap 2: Koppel pagina's aan je integratie

Notion-integraties hebben alleen toegang tot pagina's die je er uitdrukkelijk mee deelt. Dat is een beveiligingsfunctie, geen fout.

Doe het volgende voor elke Notion-pagina of database waartoe Claude toegang moet krijgen:

1. Open de pagina in Notion
2. Klik op het menu met de drie puntjes (rechtsboven)
3. Selecteer Connections
4. Zoek de naam van je integratie en klik op Confirm

Je kunt een pagina op het hoogste niveau delen om Claude toegang te geven tot alles wat eronder genest staat.

Stap 3: Configureer de MCP-server in Claude Desktop

Open het configuratiebestand van Claude Desktop. Op een Mac staat dat hier:

~/Library/Application Support/Claude/claude_desktop_config.json

Op Windows:

%APPDATA%\Claude\claude_desktop_config.json

Voeg het volgende toe aan het bestand en vervang YOUR_INTEGRATION_TOKEN door de token uit stap 1:

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer YOUR_INTEGRATION_TOKEN\", \"Notion-Version\": \"2022-06-28\"}"
      }
    }
  }
}

Stap 4: Start Claude Desktop opnieuw op

Sluit Claude Desktop volledig af en open de app opnieuw. Zodra de app geladen is, zie je linksonder in de chatinterface een hamericoon. Dat bevestigt dat de MCP-server actief is en Claude toegang tot de tools heeft.

Stap 5: Test de verbinding

Typ dit in Claude:

"Search my Notion workspace for pages about [a topic you know exists]."

Als Claude resultaten uit je workspace teruggeeft, werkt de integratie.

Notion MCP instellen met Claude Code

Gebruikers van Claude Code hebben een iets andere (en snellere) optie: de officiële Notion-plugin voor Claude Code.

Optie A: installeer de officiële Notion-plugin

De officiële plugin (gepubliceerd op makenotion/claude-code-notion-plugin op GitHub) bundelt de MCP-server met kant-en-klare skills en slash-commando's. Het is de aanbevolen route als je Claude Code als belangrijkste interface gebruikt.

Installatiestappen:

1. Open Claude Code
2. Voer het volgende commando uit in de terminal:

claude mcp add notionhq/notion-mcp-server

1. Plak je Notion-integratietoken wanneer daarom wordt gevraagd
2. Bevestig de verbinding

De plugin voegt slash-commando's toe zoals /notion-search, /notion-create, en /notion-update rechtstreeks aan je Claude Code-workflow.

Optie B: handmatige configuratie via claude.json

Heb je liever een handmatige installatie of heb je een aangepaste configuratie nodig, voeg dan de Notion MCP-server toe aan je claude.json bestand, met dezelfde JSON-structuur als in het gedeelte over Claude Desktop hierboven.

Praktische workflows voor B2B SaaS-teams

De integratie draaiend krijgen is stap één. Hier betaalt het zich echt uit.

Je Notion-databases bevragen

SaaS-teams slaan klantgegevens, featureverzoeken of sprinttaken vaak op in Notion-databases. Zodra Claude toegang heeft, kun je die databases in gewone taal bevragen.

Voorbeeldprompts:

• "Zoek alle database-items in mijn productroadmap met de status 'In Review'"
• "Toon me elke pagina met de tag van klant Acme Corp"
• "Geef een lijst van alle taken die aan [naam] zijn toegewezen en als hoge prioriteit zijn gemarkeerd"

Claude leest de database-eigenschappen en filtert de resultaten zonder dat je zelf aangepaste weergaven hoeft te bouwen.

Lange documenten samenvatten

Productspecificaties, klantonderzoeksrapporten en onboardinggidsen worden vaak lang. Claude kan elke gekoppelde Notion-pagina in een paar seconden samenvatten.

Voorbeeldprompts:

• "Vat de pagina met klantonderzoek van Q2 samen in 5 bullets"
• "Geef me de belangrijkste beslissingen uit het architecture decision record voor ons factureringssysteem"
• "Wat zijn de belangrijkste bezwaren die in onze sales playbook zijn vastgelegd?"

Dit is vooral handig vóór klantgesprekken of interne reviews, wanneer je snel een briefing nodig hebt. Teams die meer gestructureerde documentatie en herhaalbare contentworkflows opzetten, combineren zo'n opzet vaak met de ondersteuning van sterke B2B SaaS-contentmarketingbureaus om interne kennis om te zetten in assets die pipeline opleveren.

Pagina's bijwerken zonder je workflow te verlaten

Claude kan content ook terugschrijven naar Notion, niet alleen lezen. Voor SaaS-teams haalt dat de frictie weg van het wisselen tussen je AI-assistent en je documentatietool.

Voorbeeldprompts:

• "Voeg een nieuwe sectie toe aan onze onboardingchecklist voor enterprise-klanten over het instellen van SSO"
• "Werk de statuseigenschap op de featurepagina 'API rate limiting' bij naar 'Shipped'"
• "Maak een nieuwe pagina aan in onze database met vergadernotities, met de datum van vandaag en de volgende samenvatting: [plak notities]"

Een levende kennisbank bouwen

De meest duurzame toepassing van claude notion mcp in een B2B SaaS-context is Notion gebruiken als permanente geheugenlaag voor Claude. In plaats van in elk gesprek opnieuw je product, je klanten of je processen uit te leggen, leest Claude die context aan het begin van elke sessie uit Notion.

Zo zet je dat op:

1. Maak in Notion een pagina "Claude Context" aan met je ICP, productpositionering en belangrijkste terminologie
2. Deel die pagina met je integratie
3. Begin elke Claude-sessie met: "Lees mijn Claude Context-pagina in Notion voordat we beginnen"

Dit kost ongeveer 30 minuten om op te zetten en bespaart veel tijd bij elke volgende sessie. Voor grotere teams wordt zo'n proces onderdeel van bredere B2B SaaS marketing operations, vooral wanneer documentatie, campagne-uitvoering en rapportage op elkaar afgestemd moeten blijven.

Veelvoorkomende installatieproblemen oplossen

Claude zegt dat hij geen Notion-tools kan vinden
De MCP-server is niet geladen. Sluit Claude Desktop volledig af en start hem opnieuw. Controleer je claude_desktop_config.json op JSON-syntaxisfouten (een ontbrekende komma of haak maakt het hele bestand onbruikbaar).

Claude kan zoeken, maar geeft geen resultaten
Je integratie is niet aan pagina's gekoppeld. Ga terug naar stap 2 en deel de relevante pagina's met je integratie.

Authenticatiefouten wanneer Claude Notion probeert te openen
Je integratietoken is waarschijnlijk verkeerd ingevoerd. Ga terug naar notion.so/my-integrations, genereer de token opnieuw en werk je configuratiebestand bij.

Claude kan pagina's lezen, maar niet bijwerken
Controleer de capabilities van je integratie. Ga naar notion.so/my-integrations, open je integratie en controleer of "Update content" en "Insert content" allebei zijn ingeschakeld.

Claude Desktop of Claude Code: welke kies je?

Beide opties gebruiken dezelfde Notion MCP-server en bieden identieke toegang tot je workspace. Het verschil zit in de interfacevoorkeur, niet in de mogelijkheden.

Veelgestelde vragen

Wat is de Notion MCP-server en hoe werkt hij met Claude?
De Notion MCP-server is een officiële integratie die het Model Context Protocol gebruikt om Claude directe lees- en schrijftoegang te geven tot je Notion-workspace. Claude stuurt verzoeken naar de MCP-server, die ze vertaalt naar Notion API-aanroepen. Het resultaat is dat Claude Notion-content via natuurlijke taal kan doorzoeken, lezen, aanmaken en bijwerken zonder handmatig kopiëren en plakken.

Is de Claude Notion MCP-integratie gratis te gebruiken?
De Notion MCP-server zelf is gratis en open source. Je hebt wel een Claude-abonnement nodig dat MCP-toolgebruik ondersteunt (Claude Pro of hoger voor Claude Desktop, of Claude Code, dat zijn eigen prijzen heeft). Het gratis abonnement van Notion ondersteunt integraties, dus een betaald Notion-abonnement is niet nodig.

Hoe voeg ik Notion MCP specifiek toe aan Claude Code?
Voer claude mcp add notionhq/notion-mcp-server uit in je Claude Code-terminal en volg de aanwijzingen om je Notion-integratietoken in te voeren. Je kunt ook de officiële Notion-plugin voor Claude Code installeren vanuit de makenotion/claude-code-notion-plugin GitHub-repository. Die voegt in één stap de MCP-server en kant-en-klare slash-commando's toe.

Kan Claude mijn Notion-pagina's bewerken, of alleen lezen?
Claude kan Notion-pagina's en database-items lezen, aanmaken en bijwerken, mits de juiste mogelijkheden voor je integratie zijn ingeschakeld. Ga naar notion.so/my-integrations en controleer of "Update content" en "Insert content" allebei actief zijn voor je integratie.

Is het veilig om Claude te koppelen aan mijn Notion-workspace?
Notion-integraties hebben alleen toegang tot pagina's die je er expliciet mee deelt. Claude ziet geen pagina's buiten de pagina's die je hebt gekoppeld. Houd je integratietoken privé en bewaar het alleen in je lokale configuratiebestand, nooit in een gedeelde of openbare repository.