WordPress MCP instellen

Met WordPress MCP instellen verbind je mcp-core via de REST API met een of meer WordPress-sites, met een WordPress-applicatiewachtwoord. Je hebt de WordPress-entitlement nodig, een gebruiker op de site en drie env-variabelen. Claude leest dan berichten, pagina’s, media, gebruikers, menu’s en instellingen; content aanmaken en wijzigen vereist read-write-modus.

Wat heb je nodig om WordPress MCP in te stellen?

Je hebt een draaiende mcp-core-installatie nodig en de WordPress-add-on op dezelfde licentie. Heb je mcp-core nog niet geïnstalleerd? Gebruik dan eerst de installatiehandleiding van mcp-core.

• Een actieve licentie met de entitlement tool:wordpress, uit de add-on WordPress MCP-server.
• Een WordPress-site waarvan de REST API bereikbaar is op /wp-json/wp/v2, geserveerd via HTTPS.
• Een WordPress-gebruiker voor Claude, en een applicatiewachtwoord voor die gebruiker.
• Een seat in Mijn account → MCP Self-hosted met de WordPress-tool aangevinkt.

De add-on later toegevoegd? Geen herinstallatie en geen nieuwe download. Hij wordt aan je licentie toegevoegd, en je krijgt een e-mail met de env-variabelen.

Hoe maak je het applicatiewachtwoord aan voor WordPress MCP?

Log in als de gebruiker namens wie Claude werkt, ga naar Gebruikers → Profiel en scrol naar Applicatiewachtwoorden. Vul een naam in zoals “mcp-core” en klik op “Nieuw applicatiewachtwoord toevoegen”. WordPress toont het wachtwoord één keer, in groepjes van vier tekens. Kopieer het precies zoals het wordt getoond, inclusief spaties.

Gebruik nooit het gewone inlogwachtwoord van het account. Een applicatiewachtwoord kun je los intrekken, zonder de gebruiker buiten te sluiten. De rechten zijn die van de gebruiker: een Redacteur kan berichten en pagina’s beheren, maar voor instellingen, plugins, menu’s en widgets is een Beheerder nodig. Kies de laagste rol die dekt wat Claude via WordPress MCP moet doen.

Welke env-variabelen gebruikt WordPress MCP?

Drie variabelen dekken één site; een JSON-variabele dekt er meerdere. De .env in je download bevat de verplichte regels leeg en de optionele als commentaar.

WORDPRESS_SITE_URL=https://www.example.com
WORDPRESS_USERNAME=claude-editor
WORDPRESS_APP_PASSWORD=xxxx xxxx xxxx xxxx xxxx xxxx

Je kunt deze waarden ook opslaan in Mijn account → MCP Self-hosted → Tools. Daar worden ze versleuteld bewaard, een draaiende mcp-core pikt ze op zonder nieuwe download, en ze gaan voor op dezelfde sleutels in .env.

Hoe verbind je meerdere sites via WordPress MCP?

Zet WORDPRESS_CONNECTIONS op een JSON-array met één object per site. Zodra die is ingesteld, worden de drie losse variabelen genegeerd.

WORDPRESS_CONNECTIONS=[{"id":"main","label":"Main site","url":"https://site-a.example.com","username":"admin","appPassword":"xxxx xxxx xxxx xxxx xxxx xxxx"},{"id":"blog","label":"Blog","url":"https://blog.example.com","username":"admin","appPassword":"yyyy yyyy yyyy yyyy yyyy yyyy"}]

Elke regel heeft id, url, username en appPassword nodig; label is optioneel. Bij twee of meer sites krijgt elke WordPress-tool een verplichte parameter site en kiest Claude de site op basis van de id. Met één site bestaat die parameter niet.

Wat kan Claude met WordPress MCP in read-only- of read-write-modus?

Read-only registreert 23 tools; read-write voegt er 18 aan toe. In read-only-modus worden de schrijftools helemaal niet geregistreerd. Je kiest de modus per seat wanneer je die toevoegt in Mijn account → MCP Self-hosted → Seats; WORDPRESS_MODE is alleen de fallback. Zie entitlements vs. toolmodi.

• Read-only: berichten, pagina’s, reacties, zoeken, media, gebruikers, categorieën, tags, berichttypes en custom posts, menu’s, menu-items en -locaties, sidebars, widgets, instellingen, plugins en thema’s.
• Read-write voegt toe: berichten, pagina’s en custom posts aanmaken en bijwerken, media uploaden en bijwerken, gebruikers, categorieën, tags en menu-items aanmaken en bijwerken, instellingen bijwerken en reacties modereren.

Ingebouwde vangrails: nieuwe berichten, pagina’s en custom posts zijn concepten, tenzij Claude status: "publish" meegeeft. Reactiemoderatie kan goedkeuren, in de wacht zetten, als spam markeren of naar de prullenbak verplaatsen, maar er is geen verwijdertool voor reacties of gebruikers. Media-uploads accepteren een URL of base64-data; URL’s op private of interne adressen worden geweigerd, met een limiet van 25 MB en een time-out van 15 seconden.

Hoe herstart en test je WordPress MCP?

Draai het updatescript vanuit je installatiemap:

./mcp-update.sh

Net de add-on gekocht? Forceer een licentiecheck:

docker exec mcp-core npm run refresh-license

Roep in Claude mcp_status aan om de licentiestatus, je seat en de modus van elke tool te zien. Vraag daarna om “de vijf nieuwste berichten”. Voor clients met hun eigen tokens, zie MCP-seats.

Welke foutmeldingen kom je tegen bij het instellen van WordPress MCP?

Deze meldingen komen van de tool en van de WordPress REST API.

• Helemaal geen WordPress-tools: het log meldt “No WordPress site is configured”. Vul de variabelen of WORDPRESS_CONNECTIONS in en draai daarna ./mcp-update.sh.
• “WORDPRESS_CONNECTIONS is not valid JSON” of “is missing url/username/appPassword”: corrigeer de array, op één regel, met dubbele aanhalingstekens.
• “Multiple WordPress sites are configured — pass the site parameter” of “Unknown WordPress site”: verkeerde of ontbrekende id; de melding noemt de ingestelde id’s.
• “WordPress [id] API error 401”: verkeerde gebruikersnaam of applicatiewachtwoord, of het wachtwoord is ingetrokken.
• API error 403 op menu’s, widgets, instellingen of plugins: de gebruiker mist edit_theme_options, manage_options of activate_plugins.
• Concepten ontbreken in lijsten: niet-gepubliceerde content is alleen zichtbaar voor gebruikers met voldoende rechten.

WordPress MCP is ingesteld als mcp_status de tool toont en een testvraag berichten teruggeeft. De andere add-ons staan in de MCP-installatiehandleidingen.