Claude Desktop via MCP aan WordPress koppelen: de stapsgewijze handleiding

Om Claude Desktop met WordPress te verbinden, installeer je de officiële plugin MCP Adapter op de site, maak je een aparte gebruiker aan met een applicatiewachtwoord en declareer je de server daarna in het bestand claude_desktop_config.json van Claude Desktop, met de proxy @automattic/mcp-wordpress-remote die npx start. Na een herstart ziet Claude de tools van je site en vraagt het vóór elke aanroep om toestemming. Deze tutorial behandelt elke stap, de tests die je uitvoert, de veelvoorkomende fouten en de beveiligingsinstellingen.

Is het onderwerp nieuw voor je, begin dan met wat MCP verandert voor WordPress: daar worden nuttige toepassingen en risico’s uitgelegd. Hier gaan we aan de slag.

Wat je nodig hebt

• WordPress 6.9 of nieuwer: de Abilities API, waarop de adapter steunt, zit sinds die versie in de core.
• Een site op HTTPS: WordPress biedt applicatiewachtwoorden alleen via HTTPS aan, behalve bij lokale ontwikkeling (zie HTTPS op WordPress).
• Claude Desktop, bijgewerkt, op macOS of Windows.
• Node.js in een LTS-versie op je computer: het commando node --version moet antwoord geven.
• Beheerderstoegang tot de site, zolang de installatie duurt.

De zes stappen van de koppeling

1. MCP Adapter installeren

Download mcp-adapter.zip van de releasepagina van de GitHub-repository WordPress/mcp-adapter en ga dan naar Plugins > Plugin toevoegen > Plugin uploaden. Met WP-CLI:

wp plugin install https://github.com/WordPress/mcp-adapter/releases/latest/download/mcp-adapter.zip --activate

De plugin maakt een standaard MCP-server aan, bereikbaar op https://jouw-site.nl/wp-json/mcp/mcp-adapter-default-server. Die biedt drie algemene tools: de beschikbare mogelijkheden ontdekken, de details van een ervan opvragen en die uitvoeren. Het gaat alleen om mogelijkheden die de core of je plugins als openbaar voor MCP declareren.

2. Een aparte gebruiker aanmaken

Maak via Gebruikers > Nieuwe gebruiker toevoegen bijvoorbeeld claude-agent aan, met de laagste rol die volstaat: Bijdrager om te lezen en voor te stellen, Auteur om concepten voor te bereiden, Redacteur alleen als de agent inhoud van anderen moet bewerken. Nooit Beheerder op een live site (zie rollen en minimale rechten). Dit account wordt alleen door Claude gebruikt: je weet precies wat het heeft gedaan en je kunt het uitschakelen zonder aan je eigen account te komen.

3. Een applicatiewachtwoord genereren

Open, ingelogd als beheerder, het profiel van claude-agent, sectie Applicatie wachtwoorden, vul de naam ‘Claude Desktop’ in en klik op Applicatie wachtwoord toevoegen. Kopieer de 24 getoonde tekens: ze worden nooit meer weergegeven. Dit wachtwoord geeft de rechten van het account zonder via het inlogscherm te gaan; alle regels om het te beheren staan in onze gids over applicatiewachtwoorden.

4. Het endpoint testen

Controleer, voordat je aan Claude begint, of de site antwoordt. Vanuit een terminal:

curl -X POST "https://jouw-site.nl/wp-json/mcp/mcp-adapter-default-server" \
  -u "claude-agent:xxxx xxxx xxxx xxxx xxxx xxxx" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'

Een JSON-antwoord met serverInfo bevestigt dat de plugin draait en dat de authenticatie lukt. Een code 401 wijst op een verkeerde gebruikersnaam of een verkeerd wachtwoord, een 404 op een inactieve plugin of uitgeschakelde permalinks.

5. De server declareren in Claude Desktop

Open in Claude Desktop Settings > Developer > Edit Config (Instellingen, Ontwikkelaar, Configuratie bewerken). De knop maakt dit bestand aan of opent het:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Voeg de server toe onder de sleutel mcpServers (laat eventuele andere servers staan):

{
  "mcpServers": {
    "mijn-wordpress-site": {
      "command": "npx",
      "args": ["-y", "@automattic/mcp-wordpress-remote@latest"],
      "env": {
        "WP_API_URL": "https://jouw-site.nl/wp-json/mcp/mcp-adapter-default-server",
        "WP_API_USERNAME": "claude-agent",
        "WP_API_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
      }
    }
  }
}

Het pakket @automattic/mcp-wordpress-remote is een lokale proxy: Claude Desktop praat er via STDIO mee, en de proxy stuurt alles via HTTPS door naar je site. Voeg in env "LOG_FILE" met een bestandspad toe om tijdens het afstellen een logboek van de uitwisselingen bij te houden.

6. Herstarten en testen in Claude

Sluit Claude Desktop volledig af (niet alleen het venster) en start het opnieuw. In het invoerveld hoort het connectorenmenu mijn-wordpress-site en de bijbehorende tools te tonen. Vraag eerst om een leesactie: ‘Welke mogelijkheden stelt mijn WordPress-site beschikbaar?’, daarna ‘Geef me de informatie van de site’. Claude vraagt vóór elke toolaanroep om je toestemming: lees wat het gaat doen voordat je akkoord gaat.

Variant: een lokale site met WP-CLI

Draait de site op je eigen computer (ontwikkelomgeving), dan kan Claude Desktop WP-CLI rechtstreeks starten, zonder HTTP en zonder applicatiewachtwoord:

{
  "mcpServers": {
    "wordpress-local": {
      "command": "wp",
      "args": ["--path=/pad/naar/de/site", "mcp-adapter", "serve", "--server=mcp-adapter-default-server", "--user=claude-agent"]
    }
  }
}

De parameter --user bepaalt met de rechten van welk account de agent werkt: ook hier geen beheerder. Zonder deze parameter draait de server zonder gebruiker en ziet hij bijna niets.

Problemen oplossen

Symptoom	Waarschijnlijke oorzaak	Oplossing
De server verschijnt niet	Ongeldige JSON, Claude niet echt herstart	De JSON valideren (komma’s, accolades), Claude afsluiten via de taakbalk of het menu
npx niet gevonden	Node.js ontbreekt of staat niet in het PATH van Claude	Node.js LTS installeren, of het volledige pad naar npx opgeven in command
Fout 401	Verkeerd wachtwoord, of authenticatieheader door de server verwijderd	Het wachtwoord opnieuw aanmaken; bij Apache met CGI de regel HTTP_AUTHORIZATION in .htaccess controleren
Fout 403 of rest_forbidden	Rol te laag, of REST API geblokkeerd door een plugin of firewall	Zo nodig een rol hoger gaan, /wp-json/mcp/ toestaan voor dit account
Geen bruikbare tools	Geen enkele mogelijkheid als openbaar voor MCP gedeclareerd	De plugins controleren die mogelijkheden leveren, Claude om de lijst vragen
Fout ENOENT met ${APPDATA} (Windows)	Variabele niet doorgegeven aan de proxy	"APPDATA" met het volledige pad toevoegen in env

Beperkt je beveiligingsplugin of firewall de REST API tot alleen beheerders, maak dan een uitzondering voor het MCP-endpoint in plaats van de agent de beheerdersrol te geven.

De beveiligingsinstellingen die je niet mag overslaan

• Het configuratiebestand bevat het wachtwoord in leesbare tekst: deel het niet, zet het niet in versiebeheer en beveilig de sessie op je computer.
• Eén applicatiewachtwoord per computer en per tool, ingetrokken zodra het niet meer wordt gebruikt of een apparaat kwijtraakt.
• Test eerst op een stagingomgeving, vooral voor tools die schrijven.
• Houd handmatige toestemming aan voor tools die de site wijzigen; bewaar permanente toestemming voor leestools.
• Wees op je hoede voor inhoud die anderen hebben geschreven (reacties, formulieren): een gemanipuleerde tekst kan proberen de agent opdrachten te geven. Een beperkt account houdt de schade binnen de perken.

Compatibiliteit met WP Masquerade

De MCP-verbinding loopt via de REST API met een applicatiewachtwoord: ze gebruikt de inlogpagina niet, dus een inlogadres dat WP Masquerade verbergt, zit helemaal niet in de weg. Heb je de tweestapsverificatie van Pro ingeschakeld op het account van de agent, dan weigert de API het gewone wachtwoord en accepteert ze alleen het applicatiewachtwoord: precies het gewenste gedrag. Het activiteitenlogboek van Pro legt de gevoelige acties van de agent vast (gewijzigde instelling, geactiveerde plugin, aangemaakt account).

How to Connect Claude AI to WordPress Using MCP (Live Demo)Als je klikt, wordt de video geladen vanaf youtube-nocookie.com (YouTube, Google). Voor je klik wordt er niets geladen.

Veelgestelde vragen

Kun je Claude zonder Node.js met WordPress verbinden?

Voor een externe site met Claude Desktop heeft de proxy mcp-wordpress-remote Node.js nodig. Voor een lokale site kan de WP-CLI-variant zonder. De externe connectoren van Claude vereisen een OAuth-verbinding, en die levert MCP Adapter niet zelf.

Welke rol geef je het account van Claude?

De laagste die volstaat voor het gebruik: Bijdrager om te controleren en voor te stellen, Auteur om concepten te schrijven, Redacteur om inhoud van anderen te corrigeren. Vermijd Beheerder, behalve op een stagingomgeving.

Kan Claude publiceren zonder mijn toestemming?

Claude Desktop vraagt vóór elke toolaanroep om je toestemming, tenzij je die permanent geeft. Met een account als Auteur of Bijdrager kan het sowieso alleen publiceren wat die rol toestaat.

Hoe sluit ik de toegang snel af?

Trek het applicatiewachtwoord ‘Claude Desktop’ in via het profiel van het account: de toegang stopt meteen. Verwijder daarna de server uit het configuratiebestand.

Kun je meerdere sites tegelijk koppelen?

Ja: voeg per site een item toe in mcpServers, met een eigen naam en een apart applicatiewachtwoord voor elke site.

Bronnen

• Model Context Protocol: Claude Desktop koppelen aan lokale servers (externe link, opent in een nieuw tabblad)
• MCP Adapter: CLI Usage Guide (externe link, opent in een nieuw tabblad)
• npm: @automattic/mcp-wordpress-remote (externe link, opent in een nieuw tabblad)
• WordPress: Application Passwords Integration Guide (externe link, opent in een nieuw tabblad)