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.
- In Ryze AI open Integrations, click Connect on the WordPress card and link the site
- In Devin Desktop open Customize, then MCPs, and add the ryze server to mcp_config.json (or run devin mcp add in a terminal)
- Click Authenticate, or run devin mcp login ryze, then click Allow connection on the Ryze AI page
- Start an agent session and ask about your posts, pages or media
Windsurf to WordPress at a glance
| Fact | Detail |
|---|---|
| Main way to connect | The Ryze AI connector, a hosted MCP server that Devin Desktop and Devin CLI add from one url entry |
| Server address | https://connector.get-ryze.ai/mcp |
| How Windsurf signs in | OAuth 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 linked | Self-hosted: Site URL, wp-admin username and an application password. WordPress.com or Jetpack: a sign-in on WordPress.com |
| WordPress tools | 9 in all: two read, six write and one delete |
| Can Windsurf change the site | Yes, 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 only | Plugin installs, the Yoast SEO and Rank Math bridges and head code, all with an administrator's application password |
| Windsurf plan needed | Cognition's MCP documentation names none. Teams and Enterprise admins can limit which servers members use |
| Ryze AI price | SEO 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 Windsurf | The 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 tested | WordPress 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.
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.
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.
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" } } }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.
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 ryzeStatic 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
| Topic | What Cognition's documentation says |
|---|---|
| Where servers are added | Customize page in the Agents window, MCPs tab, or the mcp_config.json files. Devin CLI: devin mcp add |
| Transports | stdio, 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-in | devin 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-in | The server shows Needs authentication in the This computer list. Authenticate clears the stored sign-in and opens the browser again |
| Approval | The agent asks before every MCP tool call. You can allow one tool or every tool of a server, for the session or for good |
| Plan | None named in the MCP documentation. The Allow MCP, MCP allowlist and MCP registry settings carry the label Teams & Enterprise |
| Admin controls | Allow 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 names | mcp__<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).
| Role | What WordPress says it can do | With Ryze AI |
|---|---|---|
| Administrator | Every administration feature on a single site, including activate_plugins | Needed for installPlugin, the Yoast and Rank Math bridges and addHeadCode |
| Editor | Publishes and manages posts, including other users' posts | Enough for reading, writing, editing and deleting content |
| Author | Publishes and manages their own posts | Content tools work on the author's own posts |
| Contributor | Writes and manages their own posts but cannot publish them | Drafts only |
| Subscriber | Manages their own profile and has the read capability | Too 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.
| Tool | Type | What it does |
|---|---|---|
| wordpress__read | Read | Runs a read-only GET request on the connected site: posts, pages, media, categories, tags, users, plugins and custom post types |
| wordpress__search_content | Read | Searches a text field such as a post's raw content and returns matching lines with line numbers and context |
| wordpress__write | Write | Creates or updates resources with POST, PUT or PATCH, such as a new post or an updated page |
| wordpress__edit_content | Write | Makes find-and-replace edits to a text field and writes it back without resending the whole content |
| wordpress__installPlugin | Write | Installs and activates a plugin from the wordpress.org directory on a self-hosted site |
| wordpress__enableYoastRestBridge | Write | One-time setup that makes the Yoast title, meta description, focus keyword, canonical and noindex fields writable |
| wordpress__enableRankMathRestBridge | Write | One-time setup that makes the Rank Math title, description, canonical URL and focus keyword fields writable |
| wordpress__addHeadCode | Write | Adds a block of HTML to the head of every page on a self-hosted site, such as a verification tag |
| wordpress__delete | Delete | Runs 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
| Limit | Number | Source |
|---|---|---|
| Records per read | 1 to 100 per request (per_page); the posts route defaults to 10 | REST API pagination |
| Application password length | 24 characters, letters and digits | Integration guide |
| Trash retention | 30 days by default (EMPTY_TRASH_DAYS). On WordPress.com deleted posts and pages recover for 30 days; media, categories and tags do not | wp-config |
| Search pattern | Up to 500 characters; context_lines 0 to 10, default 2 | Ryze AI tool definitions, seen on November 14, 2026 |
| Edits per call | 1 to 50; old_string up to 20,000 characters, new_string up to 100,000 | Ryze AI tool definitions |
| Head code | html up to 8,192 characters, name up to 80 | Ryze AI tool definitions |
| Request quota | No figure appears on the WordPress pages opened. The pages record no number, which does not mean WordPress sets no limit | Responsible use of APIs |
| Windsurf server or tool cap | No number on Cognition's current MCP pages | Devin 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 asked | What 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 exist | Refused as not_found with Invalid post ID. |
| A route that does not exist | Refused as not_found with No route was found matching the URL and request method. |
| A page size of 101 | Refused with HTTP 400 and code rest_invalid_param for per_page |
| A sort field that does not exist | Refused with HTTP 400 and code rest_invalid_param for orderby |
| A plugin route (/yoast/v1) on the WordPress.com connection | Refused 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.
| Job | Ask Windsurf | Tool | Works on the default connection |
|---|---|---|---|
| List recent posts | List my latest posts with status and category | wordpress__read | Yes, self-hosted and WordPress.com |
| Find a phrase | Show every line of this post that contains a phrase | wordpress__search_content | Yes, both |
| Replace a phrase | Replace a phrase in one post without resending the post | wordpress__edit_content | Yes, both; the user's role must allow editing |
| Create a draft | Create a draft post or page from my notes | wordpress__write | Yes, both |
| Change post fields | Change a post's title, excerpt, status, categories or tags | wordpress__write | Yes, both |
| Fix image alt text | Update alt text and captions in the media library | wordpress__write | Yes, both |
| Delete content | Delete this post. Set the tool to ask first | wordpress__delete | Yes, both; the role must allow deleting |
| Write SEO fields | Write the Yoast title and description for these posts | wordpress__enableYoastRestBridge, then wordpress__write | Self-hosted administrator only |
| Write Rank Math fields | Write the Rank Math title and focus keyword | wordpress__enableRankMathRestBridge, then wordpress__write | Self-hosted administrator only |
| Add a tag to the head | Add this verification tag to the head of every page | wordpress__addHeadCode | Self-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.
| Way | Runs where | Setup in Windsurf | What it reaches | Price |
|---|---|---|---|---|
| Ryze AI connector (the main way) | Hosted. One address for every user | A url entry in mcp_config.json or devin mcp add, then a browser sign-in | Posts, 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 sites | SEO Starter is $129 per month with a 3-day free trial |
| WordPress.com MCP server | Hosted by WordPress.com at https://public-api.wordpress.com/wpcom/v2/mcp/v1 | WordPress.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 only | Every site on the WordPress.com account, and self-hosted sites linked through Jetpack. Content, site editing, settings and plugins, within the user's role | Included on paid WordPress.com plans; free sites and Jetpack sites without a plan through November 30, 2026 |
| MCP Adapter plugin | On your site. Endpoint /wp-json/mcp/mcp-adapter-default-server | A url entry for the endpoint with an Authorization header. Devin accepts custom headers; this exact setup was not tested | Only abilities registered on the site and marked public. The plugin has no content tools of its own | Free, GPL-2.0-or-later. Needs WordPress 6.9 and PHP 7.4 |
| Zapier MCP | Hosted | Add Zapier as a connector and sign in. Zapier lists Windsurf among its clients | Zapier's WordPress actions, such as Create Post, Update Post and Upload Media. The page does not say which site types | Each successful tool call uses two tasks from your Zapier plan |
| AI Engine by Meow Apps | On your site, as a plugin | The plugin page names ChatGPT, Claude, Claude Code and OpenClaw and not Windsurf. Check that Devin can reach its endpoint before relying on it | More than 140 tools as the vendor states it, covering posts, media, comments, users and SEO fields | The MCP server is in the free plugin. Pro is from $59 per year |
| docdyhr/mcp-wordpress, open source | A 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 env | 73 tools and up to 50 sites, as its README states | Free, 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
| Date | What happened |
|---|---|
| October 7, 2025 | WordPress.com launched its MCP server with read-only access |
| January 22, 2026 | WordPress.com added OAuth 2.1 to the server |
| March 20, 2026 | WordPress.com added write tools |
| June 2, 2026 | Windsurf was renamed Devin Desktop (version 3.0.12). The vendor is Cognition |
| July 29, 2026 | Devin 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, 2026 | Devin Desktop 3.9.19 removed Cascade; Devin Local became the only built-in agent |
| October 2, 2026 | The MCP Adapter plugin entered the wordpress.org directory |
| October 12, 2026 | Devin Desktop 3.10.67 added MCP protocol revision 2026-07-28 |
| November 8, 2026 | Devin Desktop 3.12.32 put a session's MCP servers in the ... menu of the session header |
| November 30, 2026 | End 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 run | What came back |
|---|---|
| All 9 WordPress tool names loaded from the live connector | Each returned a definition: read, write, delete, edit_content, search_content, installPlugin, enableYoastRestBridge, addHeadCode and enableRankMathRestBridge |
| 9 wordpress__read calls | Post types and taxonomies read fine; 5 requests were refused as described under errors below |
| Cognition's MCP pages | Read for config paths, the url key, sign-in, approvals and admin settings |
| Redirects from old Windsurf addresses | docs.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.
| Message | What it means | What to do |
|---|---|---|
| Invalid post ID. | No post with that ID on the connected site | Ask 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 connection | Check 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 site | Read /wp/v2/types and use a slug from it |
| Invalid parameter(s): per_page | The page size was 101; WordPress accepts 1 to 100 | Ask for 100 or fewer per page and read the rest in further pages |
| Invalid parameter(s): orderby | The sort field does not exist on that collection | Sort 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 WordPress | Put filters in query, not in a body |
| Needs authentication (in Devin Desktop) | The ryze server has no valid sign-in | Click 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.