By Ira Bodnar, Ryze AI · Updated · Test record: docs read November 15, 2026, nothing run
Quick answer
The main way to connect Windsurf to Framer is the Ryze AI connector. Create an API key in Framer under Site Settings > General > API Keys, link the project in Ryze AI with its URL and that key, 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. Framer also runs its own MCP server at https://mcp.framer.com/mcp, and its pages list Windsurf among the clients.
- In Framer open Site Settings, General, API Keys and create a key
- In Ryze AI open Integrations, click Connect on Framer, paste the project URL and key, pick a CMS collection
- In Devin Desktop open Customize, then MCPs, and add the ryze server to mcp_config.json (or run devin mcp add)
- Click Authenticate or run devin mcp login ryze, click Allow connection, then ask about your CMS collections
Windsurf to Framer 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, identical for every Windsurf user |
| How Framer is linked | In Ryze AI, with a Framer API key from Site Settings > General > API Keys and the project URL that holds the 20-character project id. You then pick 1 CMS collection |
| Windsurf sign-in | OAuth to Ryze AI in the browser. Devin registers itself by dynamic client registration, so no client ID or secret is typed. Each MCP client keeps its own sign-in |
| Framer tools | 3: framer__read, framer__write (which also publishes the site) and framer__delete |
| Can Windsurf change the site | Yes. It can create, update and remove CMS items and publish. Devin Desktop asks before every MCP tool call by default |
| Outside the tools | Framer pages, layouts, components, custom code, redirects and localization |
| Windsurf plan needed | None named in Cognition's MCP documentation. Teams and Enterprise admins can limit which servers members use |
| Ryze AI price | SEO Starter at $129 per month after a 3-day free trial. Adding the connector costs nothing, and any active plan or trial turns the tools on |
| Framer's own option for Windsurf | Framer MCP at https://mcp.framer.com/mcp, free during preview. Framer lists Windsurf among clients, and its older @framer/agent route names Windsurf too |
| Last checked | Cognition's docs on November 14, 2026 and Framer's pages on November 15, 2026. No Framer call and no step inside Devin Desktop or Devin CLI were run |
Before you start
- Windsurf (Devin Desktop) or Devin CLI. Devin Desktop runs on Mac, Windows 10 or later and Linux. Cognition's MCP pages name no plan for adding a server. On Teams and Enterprise, an admin controls Allow MCP and the MCP allowlist under MCP & ACP in team settings.
- A Framer project that has a CMS collection. Publishing needs a collection the key can reach. You make the key under Site Settings, General, API Keys, and Framer's quick start says it signs in as you and is tied to one project.
- A Ryze AI plan or trial. Adding the connector costs nothing, while the Framer tools run only on an active plan or trial. SEO Starter is $129 per month with a 3-day free trial, and annual billing is 30% off the first year.
How to connect Windsurf to Framer
The first two steps are done in Framer and Ryze AI, the next two in Devin Desktop, and the last is your first question. Every user adds the same connector URL.
Create an API key in Framer
Open your project in Framer, click the settings icon at the top right and choose General in Site Settings. Scroll to API Keys, create a key and copy it right away.
Connect Framer in Ryze AI
In Ryze AI go to Integrations and press Connect on the Framer card. Paste the editor's address-bar link as the Project URL (it must contain the 20-character project id, and the bare id works as well) together with the key, then click Continue. A window opens: choose a collection under Choose a Collection and click Save. The address of the published site is refused.
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 ask: List the collections in my Framer site and the fields of each one. Approve the tool call when Devin Desktop asks.
The Ryze AI help center article for Framer covers the Framer 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 and Devin CLI MCP configuration, checked November 14, 2026; Framer Server API quick start, checked November 15, 2026; Ryze AI Framer guide.
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 ryzeOther 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 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. The Ryze AI connector was not tested there.
Devin Cloud
The Devin web app 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.
How Windsurf handles MCP servers
| Point | What Cognition's pages say |
|---|---|
| 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, and 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. A rule such as mcp__ryze__* covers every tool of that server |
Sources: Devin Local customizations, Devin Local permissions, Devin Desktop admin controls, checked November 14, 2026.
Claude, ChatGPT and Cursor
Other MCP clients take the same URL, and the Framer connection stays where it is in Ryze AI.
Claude
Add https://connector.get-ryze.ai/mcp as a custom connector under Customize > Connectors. If the connector was added before Framer was connected, remove and re-add it, then start a new chat. The steps are in the Claude to Framer guide.
ChatGPT
Add the same URL as a custom MCP server and choose OAuth. OpenAI's wording on plans differs for read-only and full custom servers, so the ChatGPT to Framer guide lists the plan requirements first.
Cursor
Cursor reads the same URL from mcp.json and has an Add to Cursor link. See the Cursor to Framer guide.
Framer access and permissions
Framer never talks to Windsurf directly. Ryze AI holds the Framer API key, and Devin Desktop signs in to Ryze AI with OAuth. Four things decide what Windsurf can change.
- Who creates the key
- Anyone able to open Site Settings can add one under General, API Keys. Because Framer says a key acts as the person who made it, create it from an account whose access you are comfortable sharing with the connection.
- Which project
- Framer binds every key to 1 project, and each Ryze AI workspace keeps 1 Framer connection. To use a different project, click View on the Framer card, delete the connection with the trash icon and connect again.
- Which collection
- Once Ryze AI accepts the key you select the collection that receives published articles. With no CMS collection reachable by the key, publishing has no target.
- What Windsurf asks first
- By default Devin Desktop stops and asks before each MCP tool call, so a CMS edit, delete or publish waits for your answer. An allow rule for the tool or Bypass Permissions mode removes that pause.
What Framer allows
Framer lists no scopes for API keys. This table shows what each job needs on the Framer side.
| Action in Ryze AI | Framer access |
|---|---|
| List collections, fields and items | The project key and a CMS collection it can reach |
| Create or update a CMS item | Same key. A slug that already exists is updated in place, not duplicated |
| Remove a CMS item | Same key. The removal shows on the live site after a publish |
| Publish the site | Same key. This step makes CMS changes visible to visitors |
| Edit pages, custom code or redirects | Outside the Ryze AI tools. Framer's own MCP server handles page work |
What a Framer API key reaches, and the part Windsurf gets
Framer's quick start has no scopes, no read-only keys and no permission settings for an API key, and Framer says the Server API shares the Plugin API's capabilities. The table sets that wide reach beside the narrow slice Windsurf receives through Ryze AI.
| Part of Framer | What Framer says a Server API key can do | In Windsurf through Ryze AI |
|---|---|---|
| CMS | Sync CMS collections | framer__read lists and reads, framer__write creates and updates, framer__delete removes items by id |
| Publishing | publish() makes a new preview link and deploy() promotes it to production | framer__write can publish the site so changes go live. Ryze AI's documentation does not say which of the 2 Framer calls it makes |
| Canvas | Update the canvas | Not offered |
| Project settings | Change project settings | Not offered |
| Branches | Manage branches, a Plugin API feature since version 4.1.0 | Not offered |
| Whose rights, which project | Acts as the user who made the key, inside the 1 project it is bound to | 1 Framer project per Ryze AI workspace |
Through Ryze AI, Windsurf cannot touch page, layout or component edits, custom code, redirects, localization, branches or project settings, and a workspace cannot hold a second Framer project. The Framer card inside the Ryze AI app lists pages, custom code and redirects, but the 3 tools cover CMS items and publishing only. Framer's roles page adds that with staging off, just members holding Deploy permission can publish directly to the live site; the Server API pages say nothing on how that rule applies to a key.
Sources: Framer Server API quick start, Server API introduction, Server API reference, Framer developer changelog, Framer member roles and permissions. Checked November 15, 2026.
Removing access
To cut the Framer link in Ryze AI, click View on the Framer card and press the trash icon. 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. Keys are created under Site Settings, General, API Keys in Framer, but none of Framer's developer pages opened for this guide explains how to delete or rotate one.
What Windsurf can do in Framer
3 Framer tools come through the Ryze AI connector, and all of them deal with CMS collections and site publishing.
| Tool | Type | What it does |
|---|---|---|
| framer__read | Read | Lists the connected site's CMS collections, the fields of a collection, its items, or one item with all its field data. |
| framer__write | Write | Writes CMS items into a collection, creating new ones or updating existing ones by slug or id. It can also publish the site so edits go live. |
| framer__delete | Delete | Removes CMS items from a collection by id. The next publish makes the removal live. |
The tools do not edit Framer pages, custom code or redirects. They work only while the Ryze AI workspace has an active plan or free trial.
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 framer__read (mcp__ryze__framer__read) 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. The Ryze AI app chat works differently: its Tool approvals picker starts on Skip all approvals, and scheduled tasks never pause for approval. Article publishing follows Publishing mode in SEO > Preferences > Publishing, which is Automatic by default.
Limits in numbers
Framer sets out no request quota for the Server API. The figures that do exist are Framer's CMS plan caps, a few Server API FAQ details, what Cognition's MCP pages leave open and Ryze AI's own limits.
| Limit | Number |
|---|---|
| Framer Server API requests | No rate limit or quota published on the introduction, quick start, reference or FAQ page |
| CMS collections in one project | 2 on Basic. 10 on Pro, then $40 for every 10 more, up to 40. 10 for Free plan projects. Custom on Enterprise |
| CMS items in one project | 1,000 on Basic. 2,500 on Pro, then $20 for every 10,000 more, up to 40,000. Custom on Enterprise |
| Fields in a plugin-managed collection | 30 custom fields, each with an id of up to 64 characters |
| Server API after a cold start | The first commands need a second or two, and Framer keeps the instance warm for a set period after a disconnect |
| Framer MCP requests | No quota or rate limit published by Framer |
| MCP servers or tools in Windsurf | No maximum given on Cognition's current MCP pages |
| Framer connections per Ryze AI workspace | 1. A connection link is refused while one exists |
| Content Plan articles on SEO Starter | Up to 90 per billing cycle and up to 3 per weekday |
Sources: Framer pricing, Framer Server API FAQ, Framer CMS developer guide, Framer MCP page, checked November 15, 2026; Devin Local customizations, checked November 14, 2026; Ryze AI Framer guide.
First 3 prompts to run
1. Map the CMS
List the CMS collections in my Framer site. For the blog collection, show its fields and the items it holds.
Tools used: framer__read
What comes back: Collection names, the blog collection's field names and a list of its items, printed in the agent session. Framer itself stays unchanged.
2. Update one item
Open the Framer CMS item with the slug your-slug and show me its field data. Then change its title field to the text I give you.
Tools used: framer__read, framer__write
What comes back: The item's current field data, then confirmation that the item with that slug was updated in place. Devin Desktop asks you to approve the write first, and the change stays offline until you publish.
3. Publish the site
Publish my Framer site so the CMS changes go live.
Tools used: framer__write
What comes back: A confirmation that the publish ran. Devin Desktop asks first unless you added an allow rule for the tool.
Replies come from your own project, which is why this page describes them without sample output. Swap in your own slug and field names. None of the 3 prompts was run for this guide.
10 jobs to hand to Windsurf
Ten jobs for Windsurf after the project is linked, each tied to the Ryze AI tool behind it. None was run, because no Framer project was connected for this guide. The last column says if the default connection covers the job, meaning a project linked by API key with 1 chosen collection on an active Ryze AI plan or trial.
| Job | Ask Windsurf | Tool | Works on the default connection |
|---|---|---|---|
| Collection list | Which CMS collections are in my Framer project? | framer__read | Yes |
| Field names first | Print every field of the blog collection so the next edits use the exact names. | framer__read | Yes |
| Slugs of items | Give me the items of the blog collection, each with its slug. | framer__read | Yes. Framer item objects carry an id, a slug and field data |
| Gaps in SEO fields | Go through the blog items and tell me which ones have an empty description or SEO field. | framer__read | Yes, with the field names of your collection |
| Add a new post | Add a blog post item to the collection with the title and body I paste here. | framer__write | Yes. Visitors see it after a publish |
| Edit by slug | Read the item your-slug, then change its title field and leave the other fields alone. | framer__read, framer__write | Yes, once you approve the write in Devin Desktop |
| Same field, many items | Rewrite the meta description of the items I list and show old and new text before saving. | framer__read, framer__write | Yes |
| Go live | Publish the Framer site now. | framer__write | Yes. This makes the changes public, so ask for it as its own step |
| Retire old items | Look up the ids of the items I name, remove them, then publish. | framer__read, framer__delete, framer__write | Yes |
| Rearrange a page | Move the testimonials section on my home page above the footer. | None | No. Pages are outside the 3 tools; Framer MCP reaches the canvas |
4 ways to connect Windsurf to Framer
Four routes fit Windsurf. Devin Desktop and Devin CLI accept a hosted address in mcp_config.json as well as a local command, and Framer's pages name Windsurf for both of Framer's agent routes. The Ryze AI connector is the main way here because the Framer key stays inside Ryze AI, Windsurf keeps a single address and sign-in, and read, write and delete are 3 tools you can approve separately. The remaining rows follow vendor pages read on November 14 and 15, 2026, and none was installed.
| Way | Runs where | Setup in Windsurf | What it reaches in Framer | Price |
|---|---|---|---|---|
| Ryze AI connector (the main way) | Hosted by Ryze AI, at an address every user shares | A url entry in mcp_config.json or devin mcp add, then an OAuth sign-in to Ryze AI. Framer is linked inside Ryze AI with an API key and the project URL | CMS collections, fields and items to read, create, update and remove by id, plus a site publish. No pages, layouts, custom code or redirects | SEO Starter is $129 per month with a 3-day free trial. The connector is free; any active Ryze AI plan or trial runs the tools |
| Framer MCP | Hosted by Framer at https://mcp.framer.com/mcp over Streamable HTTP. No local bridge, and the editor does not have to stay open | Framer's pages list Windsurf among the clients and link a Windsurf setup guide, whose steps were not read for this guide. The generic route is a remote server named framer, Streamable HTTP, that URL, then a Framer sign-in and Allow. A url entry should fit Devin's format; this was not tested. Paste the full project link into the chat afterwards | The canvas, components, supported project settings and the CMS in every project your Framer account can open, with that account's permissions. It publishes only when you ask. No localization at launch | Free during preview on Framer's pricing page. AI usage follows the agent's own plan or credits |
| Framer External Agents (@framer/agent) | On your computer, as a local bridge. The agent needs a folder to work from | Framer names Windsurf for this route. In a terminal run npx @framer/agent setup, which installs 2 skills, then run the /framer skill and grant the project in the browser | The canvas, components and the CMS, including creating, updating and deleting items, and publishing when asked. Localization works here. Every change lands on a branch, and only projects you connect are reachable | No price on Framer's page |
| Tommy's MCP (Unframer) | A Framer Marketplace plugin that must stay open in the Framer app, bridged by a Cloudflare Worker at mcp.unframer.co. Its page says it is not an official Framer plugin | Open the plugin in the project and copy its MCP address, which carries a user ID and a session secret, so keep it out of committed files. Unframer's docs name Cursor, Claude, VS Code, Codex and others, and Windsurf is not on the list read for this guide | 22 tools for the open project only, among them CMS reads, item upserts and deletes, new collections and pages, color and text styles and React component export. 1 plugin instance per user and a 5-second timeout per request | No MCP price confirmed |
5 other options that do not fit Windsurf
- Composio's Framer toolkit. A hosted server listing 156 Framer tools that range from CMS items to pages, code files, redirects, locales and deploys, using your own Framer API key. Its Framer pages have ChatGPT steps and list Claude Cowork, Hermes and Atomic Agent but not Windsurf, so no Windsurf setup is described. The free plan has 10,000 tool calls a month; Standard is $18 per seat per month.
- Framer Server API and Plugin API. These are code libraries. The Server API (npm package framer-api) connects to a project from your own script over a persistent WebSocket using its URL and an API key, free in open beta, while the Plugin API runs inside the open editor. Framer names no assistant for either, so in Windsurf they give the agent no MCP server to call.
- Zapier MCP. Zapier lists no Framer app; the Framer integrations URL on its site gave a 404 on November 15, 2026. The closest path is the third-party Zapier to CMS plugin for Framer, which converts records a Zap sends to its webhook into CMS items.
- ericpjtsai/framer-mcp-server. A local open-source server with 14 tools covering the CMS, pages and publishing, configured with a project URL and API key. No npm package named framer-mcp-server existed on November 15, 2026, so the npx command in its README installs nothing.
- Sheshiyer/framer-plugin-mcp. A GitHub search put this repository first among Framer MCP projects by stars, at 37 on November 15, 2026, with its last push on March 21, 2025. It scaffolds and builds Framer plugins for Claude Desktop or Cline and never reads or edits a site or its CMS.
Which one to pick
Ryze AI is the best way to connect Windsurf to Framer for CMS content work, with one caveat: its tools stop at CMS items and site publish, so pages, layouts, custom code and redirects need another route. Content Plan articles also land in the collection you picked, and Claude, ChatGPT and other MCP clients can use the same connection. For building or reshaping pages from Devin Desktop, add Framer MCP, which signs in with your Framer account and reaches the canvas; one mcp_config.json can list both servers. Choose @framer/agent for localization, which Framer MCP lacks at launch. The Ryze AI Framer tools reference lists the 3 tools in full.
Sources: Getting started with Framer MCP, What you can do with Framer MCP, Framer MCP page, Framer pricing, Framer External Agents, Framer Server API introduction, Server API FAQ, Tommy's MCP on the Framer Marketplace, Unframer MCP connect docs, Composio Framer toolkit, Composio pricing, Zapier MCP, Zapier to CMS plugin, ericpjtsai/framer-mcp-server, Sheshiyer/framer-plugin-mcp, all checked November 15, 2026; Devin Local customizations, checked November 14, 2026; Ryze AI Framer guide.
Framer, Windsurf and MCP: dates that matter
| Date | What happened |
|---|---|
| August 4, 2025 | The third-party plugin Tommy's MCP (Unframer) was published on the Framer Marketplace, and its page shows an update on October 20, 2026. |
| February 12, 2026 | Framer introduced its Server API as a free open beta. These are the API keys that Ryze AI asks for. |
| 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 12, 2026 | Devin Desktop 3.10.67 added support for MCP protocol revision 2026-07-28. |
| October 22, 2026 | Framer MCP appeared on Framer's updates page. |
| October 30, 2026 | Framer's 2 help articles on Framer MCP were last edited. |
| November 4, 2026 | @framer/agent 0.0.48 was published, still the newest on npm on November 15, 2026. |
| November 8, 2026 | Devin Desktop 3.12.32 put a session's MCP servers in the ... menu of the session header. |
| November 10, 2026 | Framer's blog posted MCP setup steps for 8 tools. Windsurf is named only in passing there. |
Windsurf dates come from the Devin Desktop and Devin CLI changelogs and the rename post, read on November 14, 2026. Framer dates come from Framer's pages and the npm registry, read on November 15, 2026.
Sources: Tommy's MCP on the Framer Marketplace, Framer updates: Server API, npm registry: @framer/agent, npm registry: framer-api, Framer developer changelog, Framer updates: Framer MCP, Getting started with Framer MCP, Framer updates, Framer blog, November 10, 2026, checked November 15, 2026; Devin Desktop changelog and Devin CLI changelog, checked November 14, 2026.
How this guide was tested
Nothing was run for this guide. No call went through the Ryze AI connector, no Framer project was connected, and Devin Desktop and Devin CLI were not opened. Everything on the page comes from pages that were read: Cognition's documentation, changelogs and pricing page on November 14, 2026, then Framer's pages, the npm registry and GitHub on November 15, 2026.
| What was run | What came back |
|---|---|
| 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, per a header check on November 14, 2026 |
| Framer's MCP, Server API and pricing pages | Read for the server address, auth, limits and plan caps |
Not run for this guide: any call to Framer. No Framer account was connected in Ryze AI, so framer__read, framer__write and framer__delete were never called, and their names were never seen in a live tool list. No request went to Framer MCP at https://mcp.framer.com/mcp or to the Framer Server API. Nothing was run inside Devin Desktop or Devin CLI either: the server was not added, the Ryze AI sign-in was not finished and no tool was called from an agent session. That is why this page has no table of tested calls and no error messages captured in a test.
Windsurf and Framer errors and fixes
No error message was captured in a test for this guide, because no call was run. The fixes below come from Ryze AI's documentation and from Cognition's and Framer's pages.
- Ryze AI says the Framer project URL is not valid
- Copy the link from the Framer editor's address bar, which holds the 20-character project id, or paste the id alone. A published-site address is refused.
- The API key is rejected
- Create a new key in that project's Site Settings under General, API Keys and paste it in. Keys from another project fail, since Framer binds each key to 1 project.
- No collection to choose or publish into
- Publishing needs a CMS collection that the key can reach. Add one in Framer, then repeat the connection.
- A connection link is refused
- A workspace holds 1 Framer connection. Delete the current one with the trash icon under View on the Framer card, then connect again.
- The ryze server shows Needs authentication
- Click Authenticate in Devin Desktop, or run devin mcp logout ryze followed by devin mcp login ryze. Each MCP client keeps its own sign-in, so one made in another tool does not carry over.
- Windsurf lists no Framer tools
- If Framer was linked in Ryze AI after the ryze server went into mcp_config.json, refresh the server list on the MCPs tab or start a new session.
- Your team blocks the server
- A blocked server does not connect and its tools are missing. On Teams and Enterprise an admin can allow it under MCP & ACP in team settings.
- serverUrl does not work
- Older Windsurf guides use serverUrl. Cognition's current pages list url, so use that key.
- Windsurf cannot edit a page or add custom code
- These tools stop at CMS collections and publish. Page and layout work belongs to Framer's own MCP server.
- An edit does not show on the live site
- Writes and deletes wait for a publish. Ask Windsurf to publish, or press Publish in Framer.
- A tool reply mentions a subscription
- The Framer tools run on any active Ryze AI plan or free trial. Start the trial and try again.
- Framer MCP picks the wrong project
- Framer's advice is to give the agent the full project link in the chat.
- Framer MCP never finishes the sign-in
- If you closed the Framer sign-in window, Framer says to retry the authentication.
Terms on this page
- mcp_config.json
- The file in which Devin Desktop and Devin CLI list MCP servers: .devin/mcp_config.json for one project, ~/.config/devin/mcp_config.json for all of them.
- Devin Desktop
- The current name of Windsurf since June 2, 2026. Its agent for MCP servers is called Devin Local and replaced Cascade.
- Framer API key
- Created in a project's Site Settings under General. Framer says it acts as its creator and covers only that 1 project.
- CMS collection
- A set of structured items in a Framer project, such as blog posts. Framer plans limit the collections and items a project holds.
- Slug
- The text identifier of a CMS item, stored next to its id and field data. framer__write finds the item to update by slug or id.
- Publish and deploy
- In Framer's Server API, publish() makes a preview link and deploy() moves it to production. With staging off, only members with Deploy permission can publish to the live site directly.
- Framer MCP
- Framer's hosted MCP server at https://mcp.framer.com/mcp. You sign in with a Framer account and it acts on pages, layouts and the CMS under that account's permissions.
Sources: Devin Local customizations and Devin Desktop, checked November 14, 2026; Framer Server API quick start, Framer CMS developer guide, Server API reference, Framer member roles, Getting started with Framer MCP, checked November 15, 2026.
Frequently asked questions
How do I connect Windsurf to Framer?
Create an API key in Framer Site Settings, connect Framer in Ryze AI under Integrations with the project URL and that key, then add https://connector.get-ryze.ai/mcp to Devin Desktop (Windsurf) with a url entry in mcp_config.json or with devin mcp add. Sign in when it asks.
Is there a Framer MCP server for Windsurf?
Yes. Framer runs an official server at https://mcp.framer.com/mcp that its pages list Windsurf as a client for, with OAuth through your Framer account. The Ryze AI connector at https://connector.get-ryze.ai/mcp exposes 3 Framer tools for CMS collections and publishing.
Which should I use, Ryze AI or Framer's own server?
Ryze AI is the best way to tie the Framer CMS to Content Plan article publishing from Windsurf, though Framer's own server covers page and layout editing that the 3 Ryze AI tools do not.
Is Windsurf now called Devin Desktop?
Yes. Cognition renamed Windsurf to Devin Desktop on June 2, 2026, and its admin reference says both names mean the same product. The agent that uses MCP servers is Devin Local, which replaced Cascade.
Is Framer MCP free in Windsurf?
During its preview, yes: Framer's pricing page lists the MCP server as free on Basic, Pro and Enterprise and includes it on the Free plan card. The AI usage itself follows the agent's plan or credits.
Can I use the @framer/agent CLI with Windsurf?
Framer names Windsurf for its External Agents route: run npx @framer/agent setup, then the /framer skill, and grant the project in the browser. Framer calls Framer MCP the recommended route but keeps the CLI supported and points to it for localization.
Which Windsurf plan do I need?
Cognition's MCP pages do not name a plan. On Teams and Enterprise, admins control Allow MCP and the MCP allowlist under MCP & ACP in team settings.
Can Windsurf edit Framer pages with Ryze AI?
No. The Ryze AI tools work with CMS collections and site publish. They do not edit Framer pages, custom code or redirects. Use Framer's own MCP server for that work.
Can Windsurf change or delete Framer CMS items?
Yes. With Ryze AI it can create or update items by slug or id and delete items by id, and a publish makes the result visible.
Can Windsurf publish my Framer site?
Yes, framer__write can publish the site so CMS changes go live, and by default Devin Desktop asks before that call runs. Framer MCP can publish too, but Framer says it does so only when you ask.
Does Windsurf ask before changing a CMS item?
Yes by default: Devin Desktop asks before every MCP tool call. You can allow one tool or every tool of a server, and Bypass Permissions mode skips the prompts.
Why does Ryze AI reject my Framer project URL?
It needs the 20-character project id, which sits in the Framer editor's address bar. The bare id is accepted as well. A published site address is not.
Can I connect more than one Framer project?
One connection per workspace. To change projects, use View on the Framer card in Ryze AI, remove the connection with the trash icon and connect the other project.
How much does it cost to connect Windsurf to Framer?
The connector is free to add. The Framer 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 Framer from Windsurf?
In Devin Desktop, switch the ryze server off on the MCPs tab or run devin mcp remove ryze. To cut the link to Framer, open View on the Framer card in Ryze AI and remove the connection with the trash icon.