How to connect Windsurf to WordPress

Windsurf is now called Devin Desktop. Link your WordPress site once in Ryze AI, add one MCP URL to Devin Desktop or Devin CLI, then ask it to read and edit posts, pages and media.

Your MCP URL
https://connector.get-ryze.ai/mcp

Add it as the ryze server in Devin Desktop or Devin CLI. See the steps

See pricing

By Ira Bodnar, Ryze AI · Updated · Connector tested November 14, 2026

Quick answer

The main way to connect Windsurf to WordPress is the Ryze AI connector. Link your site in Ryze AI with an application password (self-hosted) or a WordPress.com sign-in, then add https://connector.get-ryze.ai/mcp to Windsurf, which Cognition renamed Devin Desktop on June 2, 2026, with a url entry in mcp_config.json or with devin mcp add, and sign in when it asks.

  1. In Ryze AI open Integrations, click Connect on the WordPress card and link the site
  2. In Devin Desktop open Customize, then MCPs, and add the ryze server to mcp_config.json (or run devin mcp add in a terminal)
  3. Click Authenticate, or run devin mcp login ryze, then click Allow connection on the Ryze AI page
  4. Start an agent session and ask about your posts, pages or media

Windsurf to WordPress at a glance

FactDetail
Main way to connectThe Ryze AI connector, a hosted MCP server that Devin Desktop and Devin CLI add from one url entry
Server addresshttps://connector.get-ryze.ai/mcp
How Windsurf signs inOAuth in the browser. The client registers itself through dynamic client registration, so there is no client ID or secret to paste. Each MCP client keeps its own sign-in
How the site is linkedSelf-hosted: Site URL, wp-admin username and an application password. WordPress.com or Jetpack: a sign-in on WordPress.com
WordPress tools9 in all: two read, six write and one delete
Can Windsurf change the siteYes, through the write, edit and delete tools, within what the WordPress user behind the credential may do. Devin Desktop asks before every MCP tool call by default
Self-hosted onlyPlugin installs, the Yoast SEO and Rank Math bridges and head code, all with an administrator's application password
Windsurf plan neededCognition's MCP documentation names none. Teams and Enterprise admins can limit which servers members use
Ryze AI priceSEO Starter is $129 per month with a 3-day free trial. Adding the connector is free; the WordPress tools need an active plan or trial
WordPress's own option for WindsurfThe WordPress.com MCP server at https://public-api.wordpress.com/wpcom/v2/mcp/v1. WordPress.com's pages do not name Windsurf, and they tell users of other MCP clients to add that address as a remote server
Last testedWordPress reads through the connector on November 14, 2026, over a WordPress.com connection, from Claude Code. No step inside Devin Desktop or Devin CLI was run

Before you start

  • Windsurf or Devin Desktop. Install Devin Desktop (Mac, Windows 10 or later, or Linux) or Devin CLI. The MCP pages from Cognition name no plan for adding a server.
  • A WordPress site with a user whose role fits the job. An Editor can manage posts. Plugin installs, the SEO bridges and head code need an Administrator on a self-hosted site.
  • For a self-hosted site, an application password. Make one in wp-admin under Users, Profile, Application Passwords. WordPress offers them by default on HTTPS sites.
  • For WordPress.com or Jetpack, your WordPress.com sign-in. On a Jetpack site the Jetpack JSON API module must be on.
  • A Ryze AI plan or free trial. SEO Starter is $129 per month with a 3-day free trial. The connector is free to add; the WordPress tools need an active plan or trial.
  • A team that allows MCP. On Teams and Enterprise, an admin controls Allow MCP and the MCP allowlist under MCP & ACP in team settings.

How to connect Windsurf to WordPress

Two steps happen in Ryze AI and WordPress, two in Devin Desktop, and the last is your first prompt. The connector URL is the same for every user.

  1. Link your WordPress site in Ryze AI

    Self-hosted: in wp-admin open Users, Profile, enter a name such as Ryze AI under Application Passwords, click Add New Application Password and copy the value, which is shown once. In Ryze AI open Integrations, click Connect on the WordPress card, pick the Self-hosted site tab, enter the Site URL (https://), your wp-admin username and the password, then click Continue. WordPress.com or Jetpack: pick the WordPress.com / Jetpack tab and sign in on WordPress.com.

  2. Set the author and category for new posts (optional)

    Click View on the WordPress card, choose the Author and Category that new posts use, then click Save. To add another site, click View, then Add one more account.

  3. Add the Ryze AI server to Devin Desktop

    In the Agents window open the Customize page, click MCPs and pick the scope with Install MCPs for, for example This computer. Open the config file and add the entry below to ~/.config/devin/mcp_config.json for every project, or to .devin/mcp_config.json for one project. In a terminal, devin mcp add -s user ryze https://connector.get-ryze.ai/mcp writes the same user entry.

    { "mcpServers": { "ryze": { "url": "https://connector.get-ryze.ai/mcp" } } }
  4. Sign in with the Ryze AI account

    Refresh the server list. If the ryze server shows Needs authentication, click Authenticate; otherwise run devin mcp login ryze in a terminal. Sign in on the Ryze AI page and click Allow connection. Cognition does not describe the very first sign-in screen in Devin Desktop, so the terminal command is the fallback.

  5. Ask your first question

    Start an agent session and try: List my 10 most recent posts with title, status and date. Approve the tool call when Devin Desktop asks.

The Ryze AI help center page for WordPress covers the WordPress side of the connection. Ryze AI has no help page for Windsurf or Devin Desktop; the Ryze AI developers page covers the connector URL.

Sources: Devin Local customizations, Devin CLI MCP configuration, Ryze AI WordPress guide. Checked November 14, 2026.

mcp_config.json, CLI and other surfaces

mcp_config.json

Servers sit under the mcpServers key, one named entry each, and a remote server needs a url field. The entry above is all the Ryze AI connector needs. The config paths are ~/.config/devin/mcp_config.json (user, %APPDATA%\devin\mcp_config.json on Windows), .devin/mcp_config.json (project, shared through version control) and .devin/mcp_config.local.json (project, gitignored). Older Windsurf guides use a serverUrl key; Cognition's current pages list url, and whether serverUrl still works was not verified.

{ "mcpServers": { "ryze": { "url": "https://connector.get-ryze.ai/mcp" } } }

Devin CLI

Devin CLI shares the config files and the agent with Devin Desktop. These two commands add the server for your user and sign in. Without -s the entry goes to .devin/mcp_config.local.json in the current project, which is gitignored.

devin mcp add -s user ryze https://connector.get-ryze.ai/mcp devin mcp login ryze

Static token instead of the browser sign-in

A Ryze AI API key in a headers entry is the other sign-in option the Devin docs describe for servers that expect a static token: put the header in the gitignored local file, never in the shared project file.

Other Windsurf and Devin surfaces

Devin CLI

Run the two commands above in any terminal. Devin CLI and Devin Desktop read the same mcp_config.json files, so a user entry made in one is found by the other. Whether a sign-in made with devin mcp login in a terminal is reused by Devin Desktop is not stated, so use Authenticate in Devin Desktop if the server asks again.

Windsurf Plugins for JetBrains

This is a separate surface with its own menu (Settings, Tools, Windsurf Settings, Add Server) and Cognition lists it as in maintenance mode. Cognition recommends Devin over ACP for JetBrains. The Ryze AI connector was not tested there.

Devin Cloud

The Devin web app at app.devin.ai keeps its own MCP list on its Customize page, and adding a custom server there needs the Manage MCP Servers permission. It is a different product from Devin Desktop and is outside this guide.

Cascade

Cascade, the old Windsurf agent, was removed on September 8, 2026 (Devin Desktop 3.9.19). Devin Local is the agent that now uses MCP servers.

Windsurf and MCP: the facts in one table

TopicWhat Cognition's documentation says
Where servers are addedCustomize page in the Agents window, MCPs tab, or the mcp_config.json files. Devin CLI: devin mcp add
Transportsstdio, Streamable HTTP and SSE, with OAuth for each. A remote address is tried over Streamable HTTP first, and SSE is the fallback after a 4xx answer such as 404 or 405
Sign-indevin mcp login <name> opens the browser. Dynamic client registration is the default. A server also asks for sign-in the first time it is used
Expired sign-inThe server shows Needs authentication in the This computer list. Authenticate clears the stored sign-in and opens the browser again
ApprovalThe agent asks before every MCP tool call. You can allow one tool or every tool of a server, for the session or for good
PlanNone named in the MCP documentation. The Allow MCP, MCP allowlist and MCP registry settings carry the label Teams & Enterprise
Admin controlsAllow MCP, MCP allowlist, MCP registry and MCP registry URLs, under MCP & ACP in team settings. A blocked server does not connect and its tools are missing
Tool namesmcp__<server>__<tool>, where the server part is the name in mcpServers. Rules such as mcp__ryze__* cover every tool of that server

Sources: Devin Local customizations, Devin Local permissions, Devin Desktop admin controls, Devin Desktop FAQ. Checked November 14, 2026.

Claude, ChatGPT and Cursor

The same URL works in other MCP clients. WordPress is linked once in Ryze AI, so nothing changes on the WordPress side.

Claude

Open Customize, then Connectors, click + Add, then Add custom connector, enter the name Ryze AI and https://connector.get-ryze.ai/mcp, and click Connect. Do not choose No sign in: the connector needs OAuth. In Claude you can set the write and delete tools to Needs approval.

ChatGPT

On ChatGPT web open Plugins, select the plus button, Add custom MCP server, name it Ryze AI, enter the URL and choose OAuth. OpenAI offers custom MCP servers to Business and Enterprise/Edu workspaces; Pro accounts get read and fetch permissions only.

Cursor

Cursor reads the same URL from ~/.cursor/mcp.json. The key is url, as in Devin Desktop, and Cursor runs the OAuth sign-in itself.

WordPress access and roles

Two sign-ins are involved. WordPress decides what the linked user may do, and Ryze AI decides who may call the connector. Windsurf holds only the Ryze AI sign-in; it never sees the WordPress application password.

Self-hosted site: application password
The password acts with the access of its WordPress user. WordPress added the feature in version 5.6. It has 24 characters, can be revoked on its own under Users, Profile, and cannot be used to log in at wp-login.php. The Application Passwords integration guide lists scoping a password to less access as future work, so the user's role is the limit.
WordPress.com or Jetpack: sign-in
WordPress.com's own OAuth2 has scopes. Which scope the Ryze AI sign-in requests is not in Ryze AI's facts, so this guide names none. WordPress.com connections reach only the core /wp/v2 routes.
Role of the linked user
A 403 answer means the user's role is too low for that call; link an administrator's application password to fix it. A 401 answer means the credential was revoked.
Plugin installs, bridges and head code
These need an Administrator, which means the activate_plugins capability, on a self-hosted connection.

What each WordPress role covers

Ryze AI's WordPress connection does not use app scopes on a self-hosted site, so the table lists what each role can do instead, from WordPress's roles and capabilities page (last updated September 2, 2026).

RoleWhat WordPress says it can doWith Ryze AI
AdministratorEvery administration feature on a single site, including activate_pluginsNeeded for installPlugin, the Yoast and Rank Math bridges and addHeadCode
EditorPublishes and manages posts, including other users' postsEnough for reading, writing, editing and deleting content
AuthorPublishes and manages their own postsContent tools work on the author's own posts
ContributorWrites and manages their own posts but cannot publish themDrafts only
SubscriberManages their own profile and has the read capabilityToo low for the content tools

Not covered by the connection: plugin installs, the Yoast and Rank Math bridges and head code on WordPress.com connections; plugin routes such as /yoast/v1 on WordPress.com; plugins from zip files or URLs (wordpress.org directory only); robots.txt changes; Elementor text where the post type does not expose meta._elementor_data; and Yoast or Rank Math fields over the plain REST API without the bridge, which WordPress drops silently.

Sources: WordPress roles and capabilities, Application passwords integration guide, WordPress.com OAuth2. Checked November 14, 2026.

Removing access

To cut access, delete the application password under Users, Profile in wp-admin, or disconnect the site on its card in Ryze AI. In Devin Desktop switch the ryze server off on the MCPs tab, or run devin mcp remove ryze. devin mcp logout ryze signs the server out without deleting the entry.

What Windsurf can do in WordPress

The Ryze AI connector exposes 9 WordPress tools: two read, six write and one delete. Each one takes a workspace and an optional connection_id, which names the site when several are linked.

ToolTypeWhat it does
wordpress__readReadRuns a read-only GET request on the connected site: posts, pages, media, categories, tags, users, plugins and custom post types
wordpress__search_contentReadSearches a text field such as a post's raw content and returns matching lines with line numbers and context
wordpress__writeWriteCreates or updates resources with POST, PUT or PATCH, such as a new post or an updated page
wordpress__edit_contentWriteMakes find-and-replace edits to a text field and writes it back without resending the whole content
wordpress__installPluginWriteInstalls and activates a plugin from the wordpress.org directory on a self-hosted site
wordpress__enableYoastRestBridgeWriteOne-time setup that makes the Yoast title, meta description, focus keyword, canonical and noindex fields writable
wordpress__enableRankMathRestBridgeWriteOne-time setup that makes the Rank Math title, description, canonical URL and focus keyword fields writable
wordpress__addHeadCodeWriteAdds a block of HTML to the head of every page on a self-hosted site, such as a verification tag
wordpress__deleteDeleteRuns a DELETE request, for example to delete a post

Devin's MCP pages give no cap on the number of servers or tools, and no timeout for a call, so this guide states none. The limits below come from WordPress and from the Ryze AI tool definitions.

Devin Desktop asks before every MCP tool call. To keep that for the write and delete tools but not for reads, add allow rules for the read tools and leave the rest on ask; deny rules beat ask and allow. Bypass Permissions mode runs every tool call without asking, so avoid it with a live site. Scheduled Ryze AI tasks and the Ryze AI chat follow Ryze AI's own approval picker, which starts on Skip all approvals.

Limits in numbers

LimitNumberSource
Records per read1 to 100 per request (per_page); the posts route defaults to 10REST API pagination
Application password length24 characters, letters and digitsIntegration guide
Trash retention30 days by default (EMPTY_TRASH_DAYS). On WordPress.com deleted posts and pages recover for 30 days; media, categories and tags do notwp-config
Search patternUp to 500 characters; context_lines 0 to 10, default 2Ryze AI tool definitions, seen on November 14, 2026
Edits per call1 to 50; old_string up to 20,000 characters, new_string up to 100,000Ryze AI tool definitions
Head codehtml up to 8,192 characters, name up to 80Ryze AI tool definitions
Request quotaNo figure appears on the WordPress pages opened. The pages record no number, which does not mean WordPress sets no limitResponsible use of APIs
Windsurf server or tool capNo number on Cognition's current MCP pagesDevin Local customizations

What the connector returned in the test

Each row is one read made through the Ryze AI connector on November 14, 2026, over a WordPress.com connection, from Claude Code. All calls were read-only. No site content was read, so nothing below comes from a real post.

What was askedWhat came back
Post types (/wp/v2/types)Worked: 18 post types, including post, page and attachment
Taxonomies (/wp/v2/taxonomies)Worked: 6 taxonomies, including category and post_tag
A post ID that does not existRefused as not_found with Invalid post ID.
A route that does not existRefused as not_found with No route was found matching the URL and request method.
A page size of 101Refused with HTTP 400 and code rest_invalid_param for per_page
A sort field that does not existRefused with HTTP 400 and code rest_invalid_param for orderby
A plugin route (/yoast/v1) on the WordPress.com connectionRefused as not_found, which matches the rule that WordPress.com connections reach /wp/v2 only

Sources: REST API pagination. Checked November 14, 2026.

First 3 prompts to run and 10 jobs

1. List recent posts with their status

List my 10 most recent posts with title, status, date and category.

Tools used: wordpress__read

What comes back: A list of posts with those fields. Nothing is changed.

2. Find a phrase and replace it in one post

Search the post with slug my-post-slug for the phrase old phrase and show me the matching lines. Then replace it with new phrase.

Tools used: wordpress__search_content, wordpress__edit_content

What comes back: The matching lines with line numbers, then one targeted edit to that text field once you approve the tool call.

3. Create a draft page

Create a draft page titled with the text I give you and the body I paste, and tell me its ID.

Tools used: wordpress__write

What comes back: A POST to the pages route that creates the page as a draft, then its ID so you can open it in wp-admin.

The prompts describe what comes back and show no invented results. The 7 test reads above are the real output of the connector.

10 jobs to hand to Windsurf

Ten jobs to hand to Windsurf, each matched to a tool. The last four need a self-hosted site and an administrator's application password.

JobAsk WindsurfToolWorks on the default connection
List recent postsList my latest posts with status and categorywordpress__readYes, self-hosted and WordPress.com
Find a phraseShow every line of this post that contains a phrasewordpress__search_contentYes, both
Replace a phraseReplace a phrase in one post without resending the postwordpress__edit_contentYes, both; the user's role must allow editing
Create a draftCreate a draft post or page from my noteswordpress__writeYes, both
Change post fieldsChange a post's title, excerpt, status, categories or tagswordpress__writeYes, both
Fix image alt textUpdate alt text and captions in the media librarywordpress__writeYes, both
Delete contentDelete this post. Set the tool to ask firstwordpress__deleteYes, both; the role must allow deleting
Write SEO fieldsWrite the Yoast title and description for these postswordpress__enableYoastRestBridge, then wordpress__writeSelf-hosted administrator only
Write Rank Math fieldsWrite the Rank Math title and focus keywordwordpress__enableRankMathRestBridge, then wordpress__writeSelf-hosted administrator only
Add a tag to the headAdd this verification tag to the head of every pagewordpress__addHeadCodeSelf-hosted administrator only

6 ways to connect Windsurf to WordPress

There are six ways to give Windsurf access to a WordPress site. This guide uses the first. Facts below were checked on November 14, 2026 from each vendor's own pages.

WayRuns whereSetup in WindsurfWhat it reachesPrice
Ryze AI connector (the main way)Hosted. One address for every userA url entry in mcp_config.json or devin mcp add, then a browser sign-inPosts, pages, media, categories, tags and custom post types to read and edit; Yoast and Rank Math fields, plugin installs and head code on self-hosted sites. Self-hosted and WordPress.com sitesSEO Starter is $129 per month with a 3-day free trial
WordPress.com MCP serverHosted by WordPress.com at https://public-api.wordpress.com/wpcom/v2/mcp/v1WordPress.com's pages name no Windsurf steps and tell other clients to add the address as a remote MCP server. OAuth 2.1 sign-in, then an access level of Full access or Read onlyEvery site on the WordPress.com account, and self-hosted sites linked through Jetpack. Content, site editing, settings and plugins, within the user's roleIncluded on paid WordPress.com plans; free sites and Jetpack sites without a plan through November 30, 2026
MCP Adapter pluginOn your site. Endpoint /wp-json/mcp/mcp-adapter-default-serverA url entry for the endpoint with an Authorization header. Devin accepts custom headers; this exact setup was not testedOnly abilities registered on the site and marked public. The plugin has no content tools of its ownFree, GPL-2.0-or-later. Needs WordPress 6.9 and PHP 7.4
Zapier MCPHostedAdd Zapier as a connector and sign in. Zapier lists Windsurf among its clientsZapier's WordPress actions, such as Create Post, Update Post and Upload Media. The page does not say which site typesEach successful tool call uses two tasks from your Zapier plan
AI Engine by Meow AppsOn your site, as a pluginThe plugin page names ChatGPT, Claude, Claude Code and OpenClaw and not Windsurf. Check that Devin can reach its endpoint before relying on itMore than 140 tools as the vendor states it, covering posts, media, comments, users and SEO fieldsThe MCP server is in the free plugin. Pro is from $59 per year
docdyhr/mcp-wordpress, open sourceA Node process you run (npx -y mcp-wordpress)A command entry in mcp_config.json with your site URL, username and an application password in env73 tools and up to 50 sites, as its README statesFree, MIT licence. 114 GitHub stars, last push November 10, 2026

Four WordPress options that do not fit this job

  • WordPress Studio MCP server. It works on local Studio sites and the account's WordPress.com sites, and its page describes no route to a live self-hosted site.
  • WordPress Playground MCP server. It drives a Playground instance in a browser tab, not a live site.
  • WordPress 7.0 AI Client and Connectors screen. They let plugins on a site call AI providers, so they point from WordPress out to a model and give an assistant no way in.
  • Automattic/wordpress-mcp. The repository is archived, and WordPress.com's page says it is being retired in favor of the MCP Adapter.

Which one to pick

Ryze AI is the best way to connect Windsurf to a self-hosted WordPress site and its Yoast or Rank Math fields, though a site that lives on WordPress.com can use the WordPress.com server directly, which offers a Read only access level. Windsurf was not tested with any of the six, so pick by the site type and the access you want.

Sources: WordPress.com MCP docs, WordPress.com MCP help, MCP Adapter plugin, mcp-wordpress-remote, Zapier MCP quickstart, AI Engine plugin, docdyhr/mcp-wordpress, WordPress Studio MCP, WordPress Playground MCP, WordPress 7.0 announcement, Ryze AI WordPress guide. Checked November 14, 2026.

WordPress, Windsurf and MCP: dates that matter

DateWhat happened
October 7, 2025WordPress.com launched its MCP server with read-only access
January 22, 2026WordPress.com added OAuth 2.1 to the server
March 20, 2026WordPress.com added write tools
June 2, 2026Windsurf was renamed Devin Desktop (version 3.0.12). The vendor is Cognition
July 29, 2026Devin Desktop 3.6.21 added the Authenticate button for servers that report Needs auth; Devin CLI v3000.3.22 moved MCP servers into their own mcp_config.json files
September 8, 2026Devin Desktop 3.9.19 removed Cascade; Devin Local became the only built-in agent
October 2, 2026The MCP Adapter plugin entered the wordpress.org directory
October 12, 2026Devin Desktop 3.10.67 added MCP protocol revision 2026-07-28
November 8, 2026Devin Desktop 3.12.32 put a session's MCP servers in the ... menu of the session header
November 30, 2026End of the free WordPress.com MCP access for free sites and for Jetpack sites without a plan

Sources: Devin Desktop changelog, Devin CLI changelog, Windsurf is now Devin Desktop, WordPress.com write tools post, MCP Adapter plugin. Checked November 14, 2026.

How this guide was tested

The connector side of this guide was checked on November 14, 2026 with 11 read-only connector calls from Claude Code, 9 of them wordpress__read, on a WordPress.com connection. The Devin side was read from Cognition's documentation, changelog and pricing pages, also on November 14, 2026.

What was runWhat came back
All 9 WordPress tool names loaded from the live connectorEach returned a definition: read, write, delete, edit_content, search_content, installPlugin, enableYoastRestBridge, addHeadCode and enableRankMathRestBridge
9 wordpress__read callsPost types and taxonomies read fine; 5 requests were refused as described under errors below
Cognition's MCP pagesRead for config paths, the url key, sign-in, approvals and admin settings
Redirects from old Windsurf addressesdocs.windsurf.com/windsurf/cascade/mcp and windsurf.com both redirect to Devin pages

Not run for this page: every step inside Devin Desktop and Devin CLI, including the sign-in, because the build had no copy of either. Also not run: any read of site content, wordpress__search_content, every write, edit, delete, plugin install, bridge and head-code tool, and any call on a self-hosted connection, so no 401 or 403 answer was seen. Do not read this page as a test of Windsurf.

Windsurf and WordPress errors and fixes

Exact error messages

These are the messages the connector returned in the test, with what they mean. The page size and sort messages were returned by WordPress itself.

MessageWhat it meansWhat to do
Invalid post ID.No post with that ID on the connected siteAsk for the list of posts first and use an ID from it
No route was found matching the URL and request method.The path does not exist on this site or connection. Also returned for a plugin route such as /yoast/v1 on a WordPress.com connectionCheck the path against /wp/v2/types; plugin routes need a self-hosted connection
Invalid post type.The post type slug is not registered on the siteRead /wp/v2/types and use a slug from it
Invalid parameter(s): per_pageThe page size was 101; WordPress accepts 1 to 100Ask for 100 or fewer per page and read the rest in further pages
Invalid parameter(s): orderbyThe sort field does not exist on that collectionSort by a field the collection supports, such as date or title
GET requests cannot carry a body (invalid_arguments)A read was sent with a body, and the read tool refuses it before contacting WordPressPut filters in query, not in a body
Needs authentication (in Devin Desktop)The ryze server has no valid sign-inClick Authenticate, or run devin mcp logout ryze then devin mcp login ryze

Other problems

Ryze AI says the credentials are wrong
Use the username you type at wp-admin, a Site URL that starts with https:// and the application password as WordPress showed it. A lost password cannot be viewed again; make a new one.
Users, Profile has no Application Passwords area
WordPress offers the feature by default only on HTTPS sites, and filters can switch it off for the site or for some users. Ask whoever runs the site.
Connecting stops at a firewall message
A security plugin, WAF or host that blocks /wp-json requests stops the connection. Allowlist those requests and connect again.
A Jetpack site will not connect
Turn on the Jetpack JSON API module, then sign in with WordPress.com again.
The ryze server shows no tools
Windsurf reads the tool list when it connects. If WordPress was linked in Ryze AI later, refresh the list on the MCPs tab and start a new session.
The server is missing or blocked on a team plan
A server that is blocked by the allowlist does not connect and its tools are missing. Ask an admin to allow it under MCP & ACP in team settings.
Devin Local is disabled
Devin Local and every ACP agent are disabled in a workspace opened in Restricted Mode.
A sign-in from another tool does not carry over
Each MCP client keeps its own sign-in. Sign in to the ryze server from Devin Desktop or Devin CLI itself.
The plugin, bridge or head code tools refuse
They need a self-hosted connection and an Administrator. On WordPress.com connections edit those settings in wp-admin.
Yoast or Rank Math values are ignored
WordPress drops those fields silently over the plain REST API. Run the bridge first, on a self-hosted site, and say yes in chat before the Code Snippets plugin is installed.
A tool reply mentions a plan
The WordPress tools need an active Ryze AI plan or free trial. Start the trial and retry.

Terms on this page

Devin Desktop
The new name for Windsurf since June 2, 2026, made by Cognition. Its local agent, Devin Local, uses MCP servers. The terminal product is Devin CLI.
MCP
The Model Context Protocol, an open protocol that standardizes how applications give context to language models. An MCP server exposes tools an assistant can call.
mcp_config.json
The file where Devin Desktop and Devin CLI list MCP servers under the mcpServers key, at user, project and local scope.
Application password
A 24-character password WordPress makes on a user's profile for programs that call the REST API. It can be revoked on its own.
REST API (wp-json)
WordPress's built-in HTTP interface. Core content lives in the /wp/v2 routes: posts, pages, media, categories, tags and users.
Role and capability
A role such as Editor is a set of capabilities such as publish_posts or activate_plugins. A connection can do only what its user's role allows.

Source for MCP: modelcontextprotocol.io. Checked November 17, 2026.

Frequently asked questions

How do I connect Windsurf to WordPress?

Link your site in Ryze AI under Integrations with an application password (self-hosted) or a WordPress.com sign-in, then add https://connector.get-ryze.ai/mcp to Windsurf, now called Devin Desktop, with a url entry in mcp_config.json or devin mcp add, and sign in when it asks.

Is Windsurf the same as Devin Desktop?

Yes. Cognition's FAQ says Devin Desktop is the new name for Windsurf, since June 2, 2026, and plans and prices did not change. The old docs.windsurf.com MCP page redirects to Cognition's Devin Desktop page.

Is there a WordPress MCP server for Windsurf?

Several exist. WordPress.com runs one at https://public-api.wordpress.com/wpcom/v2/mcp/v1, and WordPress publishes the MCP Adapter plugin for self-hosted sites. WordPress.com's pages do not name Windsurf, so add either address as a remote server and test it. The Ryze AI connector is the one this guide covers.

Which should I use, Ryze AI or the WordPress.com server?

Use the WordPress.com server when your site is on WordPress.com and you want its Read only access level. Use the Ryze AI connector for a self-hosted site, for Yoast or Rank Math fields, or when you also want Ryze AI's SEO plan to publish articles to the same site.

Which Windsurf plan do I need?

Cognition's MCP documentation names no plan, and the pricing page has no MCP row. Teams and Enterprise admins can switch MCP off or restrict it to an allowlist under MCP & ACP in team settings.

Does Windsurf ask before changing a post?

Yes by default: the agent asks before every MCP tool call. You can allow one tool or all tools of the server for a session or for good, so keep write and delete on ask.

Can Windsurf edit or delete WordPress content?

Yes. Through Ryze AI it can create, update and delete posts, pages, media, categories, tags and custom post types, and make targeted text edits, within the rights of the WordPress user behind the credential.

Can Windsurf change Yoast SEO or Rank Math fields?

On self-hosted sites, yes, after a one-time bridge that needs your explicit yes in chat. On WordPress.com connections the bridges do not work, so those fields are edited in wp-admin.

Do I need a self-hosted site or WordPress.com?

Either works in Ryze AI. A self-hosted site connects with its URL, an admin username and an application password. A WordPress.com or Jetpack site connects with a WordPress.com sign-in, and Jetpack needs the JSON API module on.

Should the config key be url or serverUrl?

Use url. Cognition's current Devin pages list url for remote servers. Older Windsurf guides use serverUrl, and whether Devin still reads it was not verified.

Can I connect more than one WordPress site?

Yes. Click View on the WordPress card in Ryze AI and choose Add one more account. The agent uses the primary site unless you name another. How several sites fit the one-website rule of an SEO plan is not documented, so ask Ryze AI support first.

Is there an AI SEO tool that connects straight to my WordPress site?

Yes. Ryze AI SEO links to the WordPress site itself: Content Plan articles publish there as posts, and Technical Audit Fix with agent applies fixes on the site. Through the connector, Windsurf reaches the same site to read and edit content.

Can I fix image alt text in WordPress without exporting media?

Yes. Ask Windsurf to list the images, agree on the text, then approve the wordpress__write calls that save alt text and captions in place.

How much does it cost to connect Windsurf to WordPress?

The connector is free to add. The WordPress tools need an active Ryze AI plan or free trial: SEO Starter is $129 per month with a 3-day free trial, and annual billing is 30% off the first year.

How do I disconnect WordPress from Windsurf?

Switch the ryze server off on the MCPs tab, or run devin mcp remove ryze. To cut WordPress access, delete the application password under Users, Profile and disconnect the site in Ryze AI.

Connect WordPress to Windsurf

Your site links once in Ryze AI, then Windsurf reads and edits posts, pages and media. SEO Starter is $129 per month with a 3-day free trial; annual billing takes 30% off the first year.

WordPress MCP server

Need help? Read the Ryze AI help center page for WordPress or email Ryze AI support.