WordPress verbinden met Claude of Cursor via MCP: stap-voor-stap tutorial

Wat we gaan bouwen

We verbinden WordPress met Claude (Desktop of Code) of Cursor. Na afloop kun je in natuurlijke taal vragen stellen over je site: hoeveel posts je hebt, welke plugins actief zijn, of wat de laatste comments waren.

Wil je eerst begrijpen wat MCP is? Lees dan ons achtergrondartikel over WordPress MCP.

1. Vereisten checken

Voor deze tutorial heb je nodig:

WordPress versie controleren

Log in op je WordPress dashboard en ga naar Dashboard → Updates. Je ziet daar je huidige versie. WordPress 6.9+ is vereist omdat de Abilities APIKeurigOnline zegtAPIEen API (Application Programming Interface) is een set regels en protocollen waarmee softwareapplicaties met elkaar kunnen communiceren en gegevens uitwisselen. pas in die versie is toegevoegd.

Node.js installeren

Voor de verbinding met een remote WordPress-site heb je Node.jsKeurigOnline zegtNode.jsNode.js is een JavaScript-runtime waarmee je serverside applicaties kunt bouwen. nodig op je lokale computer. Download de LTS-versie van nodejs.org.

Controleer na installatie:

node --version
# Moet v18.0.0 of hoger zijn

2. MCP Adapter installeren

De MCP Adapter plugin vertaalt WordPress Abilities naar het MCP-protocol dat Claude begrijpt.

Stap 1: Download de plugin

Ga naar de MCP Adapter GitHub releases en download het mcp-adapter.zip bestand.

Stap 2: Upload en activeer

1. Ga in WordPress naar Plugins → Nieuwe plugin
2. Klik op Plugin uploaden
3. Selecteer het gedownloade zipKeurigOnline zegtZIPZIP is een bestandsformaat voor het comprimeren van meerdere bestanden tot één kleiner archief.-bestand
4. Klik op Nu installeren en daarna Activeren

Stap 3: Dependencies installeren via Composer

De MCP Adapter plugin heeft PHPKeurigOnline zegtPHPPHP (Hypertext Preprocessor) is een populaire open-source scripttaal die speciaal is ontworpen voor webontwikkeling en server-side programmering.-dependencies die je moet installeren via ComposerKeurigOnline zegtComposerComposer is een dependency manager voor PHP die het beheer van externe bibliotheken en afhankelijkheden in projecten automatiseert.. Verbind via SSHKeurigOnline zegtSSHSSH (Secure Shell) is een beveiligingsprotocol voor versleutelde externe toegang tot computers en servers. met je server:

# Ga naar je WordPress root (public_html of httpdocs)
cd ~/domains/jouwsite.nl/public_html

# Navigeer naar de plugin en installeer dependencies
cd wp-content/plugins/mcp-adapter*
composer install

Dit installeert alle benodigde libraries. Eventuele waarschuwingen over proc_open kun je negeren.

Stap 4: Verifieer de installatie

Test of de MCP endpoint werkt door deze URL te openen in je browser:

https://jouwsite.nl/wp-json/mcp/mcp-adapter-default-server

Je zou een 401 Unauthorized response moeten zien:

{"code":"rest_forbidden","message":"Je hebt geen toestemming om dat te doen.","data":{"status":401}}

Dit is correct! Het betekent dat de endpoint werkt maar authenticatie vereist. Als je een 404-fout krijgt:

• Controleer of de plugin is geactiveerd
• Flush de permalinks: wp rewrite flush (via SSHKeurigOnline zegtSSHSSH (Secure Shell) is een beveiligingsprotocol voor versleutelde externe toegang tot computers en servers.)
• Probeer: https://jouwsite.nl/?rest_route=/mcp/mcp-adapter-default-server

3. Application Password aanmaken

Claude heeft authenticatie nodig om met je WordPress-site te communiceren. WordPress Application Passwords zijn hiervoor ideaal: ze zijn specifiek voor een app en kun je los intrekken.

Stap 1: Ga naar je profiel

In WordPress, ga naar Gebruikers → Profiel (of klik rechtsboven op je naam).

Stap 2: Genereer een Application Password

Scroll naar beneden tot je Application Passwords ziet. Vul in:

• Naam: Claude Desktop MCP

Klik op Nieuw wachtwoord toevoegen.

Stap 3: Bewaar het wachtwoord veilig

Je krijgt een wachtwoord te zien in dit formaat:

xxxx xxxx xxxx xxxx xxxx xxxx

Belangrijk: Dit wachtwoord wordt maar 1x getoond! Kopieer het naar een veilige plek (bijvoorbeeld een password manager). De spaties mag je weglaten bij gebruik.

4. Claude of Cursor configureren

MCP werkt met meerdere AI-tools. Kies hieronder je favoriete:

• Claude Code — CLI voor developers
• Cursor — AI-powered code editor
• Claude Desktop — Anthropic's desktop app

Optie A: Claude Code (CLI)

Claude Code ondersteunt direct HTTPKeurigOnline zegtHTTPHTTP (HyperText Transfer Protocol) is het protocol dat de communicatie tussen webclients en servers mogelijk maakt. transport — geen Node.js package nodig. Eén commando:

claude mcp add wordpress \
  "https://jouwsite.nl/wp-json/mcp/mcp-adapter-default-server" \
  --transport http \
  --header "Authorization: Basic $(echo -n 'jouw-wordpress-gebruikersnaam:xxxx xxxx xxxx xxxx xxxx xxxx' | base64)" \
  --scope user

--scope user maakt de server beschikbaar in al je projecten. Controleer de configuratie:

claude mcp list
# Output: wordpress: https://jouwsite.nl/... (HTTP) - ✓ Connected

Optie B: Cursor

Cursor ondersteunt MCP sinds versie 0.43. Open Cursor Settings → MCP en voeg een nieuwe server toe:

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

Of bewerk direct ~/.cursor/mcp.json (macOS/Linux) of %APPDATA%\Cursor\mcp.json (Windows).

Optie C: Claude Desktop

Open het configuratiebestand (locatie verschilt per OS):

Voeg deze configuratie toe:

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

Herstart Claude Desktop om de verbinding te laden.

Credentials invullen

Vervang in alle configuraties:

• WP_API_URL — Je WordPress MCP endpoint URL
• WP_API_USERNAME — Je WordPress gebruikersnaam (niet e-mail)
• WP_API_PASSWORD — Het Application Password uit stap 3

Test de verbinding

Open een nieuwe chat/sessie en vraag:

Kun je verbinding maken met mijn WordPress-site?

Als alles goed is geconfigureerd, zal de AI de MCP-tools gebruiken en informatie over je site teruggeven.

wp plugin install https://github.com/KeurigOnline/ko-site-info/releases/download/v1.0.0/ko-site-info.zip --activate

5. Je eerste MCP query

Met de ko-site-info plugin geinstalleerd, kun je nu vragen stellen aan je WordPress-site. Claude gebruikt automatisch de MCP-verbinding om informatie op te halen.

Voorbeeldgesprekken met Claude

Zodra MCP is geconfigureerd, kun je in natuurlijke taal vragen stellen. Claude gebruikt automatisch de juiste MCP-tools. Hier zijn praktische voorbeelden:

Voorbeeld 1: Site-informatie opvragen

Voorbeeld 2: Content statistieken

Voorbeeld 3: Beschikbare functies ontdekken

Jij

Wat kun je allemaal doen met mijn WordPressKeurigOnline zegtWordPressWordPress is een open-source contentmanagementsysteem (CMS) geschreven in PHP, waarmee je eenvoudig websites en blogs kunt bouwen en beheren.-site?

⚡ mcp-adapter-discover-abilities

🤖

Ik heb de beschikbare WordPress abilities ontdekt. Op dit moment kan ik:

• keurigonline/get-site-info — Site-informatie ophalen inclusief naam, URL, versie en statistieken

Met extra plugins kun je meer abilities toevoegen, zoals content beheren, SEO-analyses uitvoeren, of WooCommerceKeurigOnline zegtWooCommerceWooCommerce is een gratis e-commerce plugin voor WordPress waarmee je een webshop kunt bouwen en beheren.-orders bekijken.

Voorbeeld 4: Statusrapport genereren

Beschikbare standaard tools

De MCP Adapter biedt drie basis-tools:

Hoe MCP communiceert (onder de motorkap)

MCP gebruikt JSONKeurigOnline zegtJSONJSON is een lichtgewicht dataformaat voor het uitwisselen van gegevens tussen systemen.-RPC 2.0 voor communicatie. Wanneer Claude verbinding maakt, gebeurt het volgende:

1. Initialisatie - Claude start een sessie:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2025-06-18",
    "serverInfo": {
      "name": "MCP Adapter Default Server",
      "version": "v1.0.0"
    },
    "capabilities": {
      "tools": {},
      "resources": {},
      "prompts": {}
    }
  }
}

2. Tools ophalen - Claude vraagt welke tools beschikbaar zijn:

{
  "tools": [
    {
      "name": "mcp-adapter-discover-abilities",
      "description": "Discover all available WordPress abilities in the system.",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false
      }
    },
    {
      "name": "mcp-adapter-execute-ability",
      "description": "Execute a WordPress ability with the provided parameters.",
      "annotations": {
        "destructiveHint": true
      }
    }
  ]
}

3. Abilities ontdekken - Claude vraagt welke WordPress-functies beschikbaar zijn:

{
  "abilities": [
    {
      "name": "keurigonline/get-site-info",
      "label": "Site Informatie",
      "description": "Haalt basis informatie op over de WordPress site, inclusief naam, URL, versie en statistieken."
    }
  ]
}

4. Ability uitvoeren - Claude voert de ability uit en krijgt site-informatie terug:

{
  "success": true,
  "data": {
    "name": "SupersnelleSite",
    "url": "https://supersnellesite.nl",
    "wordpress_version": "6.9",
    "php_version": "8.4.17",
    "active_theme": "Bricks 2.1.4",
    "language": "nl-NL",
    "stats": {
      "posts": 1,
      "pages": 1,
      "comments": 1,
      "users": 1
    }
  }
}

Tips voor effectieve queries

• Wees specifiek: "Hoeveel posts uit januari 2024?" werkt beter dan "Geef me wat posts"
• Vraag eerst wat beschikbaar is: Start met "Welke abilities zijn beschikbaar?" om te zien wat je kunt doen
• Combineer niet te veel: Stel liever meerdere simpele vragen dan een complexe

6. Troubleshooting

"Connection refused" of geen response

• Controleer of je WordPress-site online is
• Test of de REST API werkt: https://jouwsite.nl/wp-json/
• Controleer of Node.js correct geinstalleerd is: node --version

"401 Unauthorized"

• Je Application Password is incorrect of verlopen
• Je gebruikersnaam is verkeerd (gebruik login-naam, niet e-mailadresKeurigOnline zegtE-mailadresEen e-mailadres is een uniek digitaal adres in het formaat naam@domein.nl voor het versturen en ontvangen van elektronische berichten.)
• Je site gebruikt geen HTTPS - Application Passwords vereisen SSLKeurigOnline zegtSSLSSL (Secure Sockets Layer) is een beveiligingsprotocol voor versleutelde internetverbindingen.!

"No abilities found"

Dit betekent dat er geen MCP-public abilities zijn geregistreerd. De core abilities van WordPress zijn standaard niet via MCP toegankelijk. Je hebt plugins nodig die abilities registreren met mcp.public = true.

REST API geblokkeerd

Sommige security plugins blokkeren de REST API. Controleer of je een van deze plugins hebt en voeg een uitzondering toe voor /wp-json/mcp/:

• Wordfence
• iThemes Security
• All In One WP Security

Verkeerde endpoint URL

De exacte URL moet zijn:

https://jouwsite.nl/wp-json/mcp/mcp-adapter-default-server

Let op de mcp-adapter-default-server aan het einde!

Veelgemaakte fout: /wp-json/mcp/ geeft een 404. Dit is normaal - je hebt de volledige URL met mcp-adapter-default-server nodig.

"No abilities found" of lege lijst

Als discover-abilities een lege lijst teruggeeft, betekent dit dat er geen abilities zijn geregistreerd met MCP-toegang. Dit is normaal voor een verse WordPress 6.9 installatie.

Oplossing: Installeer plugins die abilities registreren (zoals WooCommerce 10.3+), of maak zelf abilities aan met mcp.public = true in de meta.

7. Volgende stappen

Meer abilities toevoegen

Je hebt nu de keurigonline/get-site-info ability werkend. Maar MCP wordt pas echt krachtig met meer abilities. Hier zijn je opties:

• WooCommerce 10.3+ — Voegt abilities toe voor producten, orders en klanten
• Eigen plugins — Bouw custom abilities voor jouw specifieke workflow
• Community plugins — Steeds meer plugins zullen MCP-abilities ondersteunen

Custom abilities maken

Wil je meer dan de standaard abilities? Je kunt eigen abilities registreren in een plugin of mu-plugin:

add_action('wp_abilities_api_init', function() {
    wp_register_ability('mijn-plugin/mijn-ability', [
        'label'       => 'Mijn Custom Ability',
        'description' => 'Doet iets nuttigs',
        'category'    => 'content',

        'input_schema' => [
            'type' => 'object',
            'properties' => [
                'tekst' => ['type' => 'string', 'description' => 'Input tekst']
            ],
            'required' => ['tekst']
        ],

        'meta' => [
            'show_in_rest' => true,
            'mcp'          => ['public' => true], // Vereist voor MCP!
        ],

        'permission_callback' => function() {
            return current_user_can('edit_posts');
        },

        'execute_callback' => function($input) {
            return ['result' => 'Verwerkt: ' . $input['tekst']];
        }
    ]);
});

WooCommerce integratie

WooCommerce werkt aan eigen MCP abilities voor productbeheer, orderinzicht en meer. Houd de WooCommerce GitHub in de gaten.

Lokale development met STDIO

Werk je lokaal met WordPress (MAMP, Local, DockerKeurigOnline zegtDockerDocker faciliteert het verpakken en draaien van applicaties in gestandaardiseerde, geïsoleerde containers.)? Dan kun je de snellere STDIO-transport gebruiken zonder NPM proxy:

{
  "mcpServers": {
    "wordpress-local": {
      "command": "wp",
      "args": ["--path=/pad/naar/wordpress", "mcp-adapter", "serve", "--user=admin"]
    }
  }
}

Veelgestelde vragen

Bronnen

• MCP Adapter GitHub repository
• WordPress MCP: hoe AI-assistenten met je site praten (achtergrond)
• Model Context Protocol documentatie
• WordPress Abilities API announcement