WordPress MCP Adapter verbindet Claude Code und Cursor mit der eigenen Website
Der WordPress MCP Adapter macht registrierte Faehigkeiten der Abilities API ueber das Model Context Protocol fuer KI-Tools wie Claude Code und Cursor nutzbar. Nach der Installation lassen sich einzelne Abilities freigeben, damit die Tools Aktionen auf der WordPress-Seite finden und ausfuehren koennen.
Veröffentlicht am 10. Oktober • Zuerst erschienen auf matthummel.com
Der WordPress MCP Adapter ermöglicht KI-Tools wie Claude Code und Cursor, Aktionen auf deiner WordPress-Seite zu finden und auszuführen. Er nimmt die Fähigkeiten, die du mit der Abilities API registrierst, und stellt sie über das Model Context Protocol (MCP) bereit.
Hier ist die komplette Einrichtung: den Adapter installieren, eine Fähigkeit freigeben, den Standard-Endpunkt finden, sich mit einem Anwendungspasswort anmelden und einige Sicherheitsprüfungen durchführen.
Du hast bereits ein KI-Tool mit einer WordPress-Seite verbunden? Spring ans Ende und erzähl mir, wie es lief. Ich würde gerne Erfahrungen vergleichen.
MCP ist ein offener Standard, der KI-Anwendungen einen gemeinsamen Weg bietet, sich mit externen Tools und Daten zu verbinden. Ein MCP-Server listet die Tools auf, die er anbietet. Ein MCP-Client, wie Claude Code oder Cursor, liest diese Liste und kann diese Tools aufrufen, wenn du dazu aufforderst.
WordPress verfügt bereits über eine eigene Möglichkeit, Aktionen zu beschreiben, die Abilities API. Ich habe sie in meinem ersten Beitrag zur Abilities API Integration behandelt. Jede Fähigkeit hat einen Namen, ein Eingabe-Schema, ein Ausgabe-Schema, eine Berechtigungsprüfung und einen Callback. Der MCP Adapter nimmt diese Fähigkeiten und bringt sie in eine Form, die ein MCP-Client lesen kann.
So bewegt sich eine Anfrage durch den Stack:
WordPress MCP Adapter Diagramm: eine WordPress-Seite im Zentrum, verbunden mit einem Terminal und einem Code-Editor, mit Schloss-, Schlüssel- und Schild-Symbolen für Login und Berechtigungen
!WordPress MCP Adapter Diagramm: eine WordPress-Seite im Zentrum, verbunden mit einem Terminal und einem Code-Editor, mit Schloss-, Schlüssel- und Schild-Symbolen für Login und Berechtigungen
Der WordPress MCP Adapter sitzt zwischen deiner Seite und KI-Tools wie Claude Code und Cursor.
Der Adapter ist noch nicht im Core enthalten, daher musst du ihn selbst hinzufügen. Du kannst ihn als Plugin installieren oder als Composer-Paket in dein eigenes Plugin einbinden. Für einen ersten Test würde ich zum Plugin raten, weil es einfacher ist.
Der Composer-Weg ergibt Sinn, sobald du ein Plugin auslieferst, das vom Adapter abhängt. Mit composer require wordpress/mcp-adapter wird er zusammen mit deinem eigenen Code installiert, sodass der Adapter mit deinem Plugin mitkommt.
Hinweis: Der Adapter ist noch unter Version 1.0, daher können sich Namen und Befehle von einer Version zur nächsten ändern. Lies das README der von dir installierten Version, bevor du etwas von unten übernimmst.
Das Registrieren einer Fähigkeit teilt sie nicht von selbst mit KI-Tools. Du musst dich explizit anmelden, indem du 'mcp' => array( 'public' => true ) innerhalb des meta-Arrays der Fähigkeit hinzufügst.
Dieses Flag teilt die Fähigkeit ausschließlich über MCP und sonst nichts. Das Adapter-README beschreibt außerdem ein allgemeineres public-Flag in meta, das der Standard-Server ebenfalls berücksichtigt.
Hier ein kleines Beispiel, das nur Daten liest. Es gibt den Seitennamen und den Tagline zurück und läuft nur für Nutzer, die Beiträge bearbeiten dürfen.
add_action ( 'wp_abilities_api_categories_init', function () { wp_register_ability_category ( 'my-site', array ( 'label' => 'My Site', 'description' => 'Abilities for this site.', ) ); } ); add_action ( 'wp_abilities_api_init', function () { wp_register_ability ( 'my-site/get-site-info', array ( 'label' => 'Get site info', 'description' => 'Returns the site name and tagline.', 'category' => 'my-site', 'output_schema' => array ( 'type' => 'object', 'properties' => array ( 'name' => array ( 'type' => 'string' ), 'tagline' => array ( 'type' => 'string' ), ), ), 'execute_callback' => function () { return array ( 'name' => get_bloginfo ( 'name' ), 'tagline' => get_bloginfo ( 'description' ), ); }, 'permission_callback' => function () { return current_user_can ( 'edit_posts' ); }, 'meta' => array ( 'annotations' => array ( 'readonly' => true ), 'mcp' => array ( 'public' => true ), ), ) ); } ); Vollbildmodus aktivieren Vollbildmodus beenden Die readonly-Annotation teilt Clients mit, dass diese Fähigkeit nichts verändert. Der Permission-Callback läuft bei jedem Aufruf, auch wenn die Anfrage von einem KI-Tool kommt.
Sobald das Plugin aktiv ist, richtet der Adapter einen Standard-MCP-Server ein. Du findest ihn unter folgendem Pfad auf deiner Seite:
https://your-site.local/wp-json/mcp/mcp-adapter-default-server Vollbildmodus aktivieren Vollbildmodus beenden Dieser Server listet nicht jede öffentliche Fähigkeit als eigenes Tool auf. Er bietet drei allgemeine Tools an:
Das README nennt sie mcp-adapter/discover-abilities, mcp-adapter/get-ability-info und mcp-adapter/execute-ability. Der Client findet also zuerst deine Fähigkeit und ruft sie dann auf.
Wenn du lieber jede Fähigkeit als eigenes Tool auflisten möchtest, kannst du einen eigenen Server registrieren. Das ist ein guter nächster Schritt, sobald der Standard-Server funktioniert.
Anwendungspasswörter sind in WordPress integriert. Sie ermöglichen einer externen App die Anmeldung über die REST API ohne dein Hauptpasswort, und du kannst jedes einzelne unabhängig widerrufen.
Tipp: Lege dafür einen eigenen Nutzer an und gib ihm die niedrigste Rolle, die deine Berechtigungsprüfungen trotzdem besteht. Verbinde ein KI-Tool nicht als Admin, ohne einen guten Grund dafür zu haben.
Für eine HTTP-Verbindung empfehlen die Adapter-Dokumente ein kleines Proxy-Paket namens @automattic/mcp-wordpress-remote. Es läuft über npx auf deinem Rechner und übernimmt die Anmeldung für dich.
Die beiden Verbindungstypen eignen sich für unterschiedliche Setups:
Füge dies zu.cursor/mcp.json in deinem Projekt hinzu und starte Cursor dann neu:
{ "mcpServers": { "wordpress-local": { "command": "npx", "args": [ "-y", "@automattic/mcp-wordpress-remote@latest" ], "env": { "WP_API_URL": "https://your-site.local/wp-json/mcp/mcp-adapter-default-server", "WP_API_USERNAME": "mcp-user", "WP_API_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx" } } } } Vollbildmodus aktivieren Vollbildmodus beenden Claude Code Wenn WP-CLI auf deiner lokalen Seite funktioniert, kannst du HTTP umgehen und STDIO verwenden. Dieser Befehl startet den Server über WP-CLI als der Nutzer, den du auswählst:
claude mcp add wordpress-local -- wp --path = /path/to/site mcp-adapter serve --server = mcp-adapter-default-server --user = mcp-user Vollbildmodus aktivieren Vollbildmodus beenden Du kannst Claude Code auch dasselbe npx-Setup geben, das Cursor verwendet.
Sobald du verbunden bist, bitte das Tool, die Fähigkeiten deiner Seite aufzulisten. Du solltest my-site/get-site-info in der Liste sehen.
Nein. WordPress 6.9 enthält die Abilities API im Core, aber der MCP Adapter ist ein separates Plugin, das du von GitHub installierst. Es ist noch unter Version 1.0, daher sind Änderungen zwischen den Versionen zu erwarten.
Nein. WP-CLI bietet dir eine STDIO-Verbindung auf einer lokalen Seite. Ohne WP-CLI kannst du den HTTP-Endpunkt mit dem npx-Proxy und einem Anwendungspasswort verwenden, auf dieselbe Weise, wie sich Cursor verbindet.
Nur über Fähigkeiten, die du als öffentlich markiert hast, und nur wenn der verbundene Nutzer den Permission-Callback jeder Fähigkeit besteht. Beginne mit rein lesenden Fähigkeiten und einem Nutzer mit einer niedrigen Rolle.
Bitte das Tool dann erneut, die Fähigkeiten aufzulisten.
Ich bin mit diesem Setup noch am Anfang und würde gerne hören, wie es bei dir lief.
Schreib mir in den Kommentaren, auch über die Stellen, an denen etwas schiefging. Ich lese jede Antwort.
Ich erkläre, wie ich die Arbeit zwischen diesen Tools aufteile, in meinem KI-Workflow für die WordPress-Entwicklung. Ich habe auch darüber geschrieben, wo KI meine WordPress-Arbeit beschleunigt und wo nicht.
Mit Vorlagen kannst du FAQs schnell beantworten oder Snippets zur Wiederverwendung speichern.
DEV UNTERSTÜTZT DEV UNTERSTÜTZT DEV UNTERSTÜTZT Folgen Beigetreten am 9. Oktober 2026 • 10. Oktober Dropdown-Menü Link kopieren Ausblenden Du musst dein Konto verifizieren. Vollbildmodus aktivieren Vollbildmodus beenden tr.ee/dev-to
Like-Kommentar: 1 Like Like-Kommentar-Button Antworten Verhaltenskodex • Missbrauch melden Möchtest du diesen Kommentar wirklich ausblenden? Er wird in deinem Beitrag verborgen, bleibt aber über den Permalink des Kommentars sichtbar.
Für weitere Maßnahmen kannst du erwägen, diese Person zu blockieren und/oder Missbrauch zu melden.
Automatisch übersetzt. Das Original auf Englisch ist unten aufklappbar.
Original (Englisch) anzeigen
Posted on Oct 10 • Originally published at matthummel.com
The WordPress MCP Adapter lets AI tools like Claude Code and Cursor find and run actions on your WordPress site. It takes the abilities you register with the Abilities API and shares them over the Model Context Protocol (MCP).
Here’s the full setup: install the adapter, expose one ability, find the default endpoint, log in with an Application Password, and run a few safety checks.
Already wired an AI tool to a WordPress site? Skip to the end and tell me how it went. I’d like to compare notes.
MCP is an open standard that gives AI apps a shared way to connect to outside tools and data. An MCP server lists the tools it offers. An MCP client, like Claude Code or Cursor, reads that list and can call those tools when you ask it to.
WordPress already has its own way to describe actions, called the Abilities API. I covered it in my first Abilities API integration post. Each ability has a name, an input schema, an output schema, a permission check, and a callback. The MCP Adapter takes those abilities and puts them in a form an MCP client can read.
Here’s how one request moves through the stack:
WordPress MCP Adapter diagram: a WordPress site in the center, connected to a terminal and a code editor, with lock, key, and shield icons for login and permissions
!WordPress MCP Adapter diagram: a WordPress site in the center, connected to a terminal and a code editor, with lock, key, and shield icons for login and permissions
The WordPress MCP Adapter sits between your site and AI tools like Claude Code and Cursor.
The adapter isn’t in core yet, so you add it yourself. You can install it as a plugin, or bundle it inside your own plugin as a Composer package. For a first test, I’d go with the plugin because it’s simpler.
The Composer route makes sense once you ship a plugin that depends on the adapter. Running composer require wordpress/mcp-adapter installs it alongside your own code, so the adapter travels with your plugin.
Heads up: the adapter is still under version 1.0, so names and commands may change from one release to the next. Before you copy anything below, read the README for the version you installed.
Registering an ability won’t share it with AI tools by itself. You have to opt in by adding 'mcp' => array( 'public' => true ) inside the ability’s meta array.
That flag shares the ability over MCP and nothing else. The adapter README also describes a broader public flag in meta, which the default server honors too.
Here’s a small example that only reads data. It returns the site name and tagline, and it only runs for users who can edit posts.
add_action ( 'wp_abilities_api_categories_init', function () { wp_register_ability_category ( 'my-site', array ( 'label' => 'My Site', 'description' => 'Abilities for this site.', ) ); } ); add_action ( 'wp_abilities_api_init', function () { wp_register_ability ( 'my-site/get-site-info', array ( 'label' => 'Get site info', 'description' => 'Returns the site name and tagline.', 'category' => 'my-site', 'output_schema' => array ( 'type' => 'object', 'properties' => array ( 'name' => array ( 'type' => 'string' ), 'tagline' => array ( 'type' => 'string' ), ), ), 'execute_callback' => function () { return array ( 'name' => get_bloginfo ( 'name' ), 'tagline' => get_bloginfo ( 'description' ), ); }, 'permission_callback' => function () { return current_user_can ( 'edit_posts' ); }, 'meta' => array ( 'annotations' => array ( 'readonly' => true ), 'mcp' => array ( 'public' => true ), ), ) ); } ); Enter fullscreen mode Exit fullscreen mode The readonly annotation tells clients this ability doesn’t change anything. The permission callback runs on every call, even when the request comes from an AI tool.
Once the plugin is on, the adapter sets up a default MCP server. You’ll find it at this path on your site:
https://your-site.local/wp-json/mcp/mcp-adapter-default-server Enter fullscreen mode Exit fullscreen mode This server doesn’t list each public ability as its own tool. It offers three general tools:
The README calls them mcp-adapter/discover-abilities, mcp-adapter/get-ability-info, and mcp-adapter/execute-ability. So the client finds your ability first, then calls it.
If you’d rather list each ability as its own tool, you can register a custom server. It’s a good thing to try once the default server is working.
Application Passwords come built into WordPress. They let an outside app log in through the REST API without your main password, and you can revoke each one on its own.
Tip: make a separate user for this and give it the lowest role that still passes your permission checks. Don’t connect an AI tool as an admin unless you have a good reason.
For an HTTP connection, the adapter docs suggest a small proxy package called @automattic/mcp-wordpress-remote. It runs through npx on your computer and takes care of the login for you.
The two connection types suit different setups:
Add this to.cursor/mcp.json in your project, then restart Cursor:
{ "mcpServers": { "wordpress-local": { "command": "npx", "args": [ "-y", "@automattic/mcp-wordpress-remote@latest" ], "env": { "WP_API_URL": "https://your-site.local/wp-json/mcp/mcp-adapter-default-server", "WP_API_USERNAME": "mcp-user", "WP_API_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx" } } } } Enter fullscreen mode Exit fullscreen mode Claude Code If WP-CLI works on your local site, you can skip HTTP and use STDIO. This command runs the server through WP-CLI as the user you pick:
claude mcp add wordpress-local -- wp --path = /path/to/site mcp-adapter serve --server = mcp-adapter-default-server --user = mcp-user Enter fullscreen mode Exit fullscreen mode You can also give Claude Code the same npx setup that Cursor uses.
Once you’re connected, ask the tool to list the abilities on your site. You should see my-site/get-site-info in the list.
No. WordPress 6.9 includes the Abilities API in core, but the MCP Adapter is a separate plugin you install from GitHub. It’s still under version 1.0, so expect changes between releases.
No. WP-CLI gives you a STDIO connection on a local site. Without it, you can use the HTTP endpoint with the npx proxy and an Application Password, the same way Cursor connects.
Only through abilities you’ve marked as public, and only when the connected user passes each ability’s permission callback. Start with read-only abilities and a user with a low role.
Then ask the tool to list the abilities again.
I’m still early with this setup, and I’d like to hear how yours went.
Tell me in the comments, including the parts that broke. I read every reply.
I explain how I split work between these tools in my AI workflow for WordPress development. I also wrote about where AI speeds up my WordPress work, and where it doesn’t.
Expand DEV SUPPORTS DEV SUPPORTS DEV SUPPORTS Follow Joined Oct 9, 2026 • Oct 10 Dropdown menu Copy link Hide You need to verify your account. Enter fullscreen mode Exit fullscreen mode tr.ee/dev-to