Docs

Connect Windsurf (Devin Desktop)

Connect Windsurf (Devin Desktop) to your workspace memory. The server is https://agentics.you/mcp, named agentics in every tool, so an admin can allowlist one name.

One click from the desktop app

In the Agentics desktop app, Connect your agents lists Windsurf (Devin Desktop) with its state. Nothing changes until you confirm.

Click Connect. Before anything changes, the app shows what it will do: “Add Agentics to Devin Desktop (formerly Windsurf) for your user (~/.config/devin/mcp_config.json), keeping your other servers.” With it is the file it changes.
Click Confirm. The app saves a backup of the file beside it (<file>.agentics-backup-<timestamp>, readable by you only), adds the agentics entry and keeps your other servers, then reads the file back to check it.

If Windsurf (Devin Desktop) isn't installed, its row says so and offers nothing to click. Once it has agentics, the row says Connected and offers Disconnect.

The app is for macOS and Windows. Get it from Download, which lists each build once a release is published.

By hand

Add this to ~/.config/devin/mcp_config.json on macOS, %APPDATA%\devin\mcp_config.json on Windows and ~/.config/devin/mcp_config.json on Linux, keeping any other servers under mcpServers. Create the file if it doesn't exist:

MCP

{
  "mcpServers": {
    "agentics": {
      "serverUrl": "https://agentics.you/mcp"
    }
  }
}

If XDG_CONFIG_HOME is set on macOS and Linux, the file is devin/mcp_config.json in the folder it names.

~ is your home folder.

In Devin Desktop, open Cascade's MCP servers and refresh: Devin Desktop signs in to Agentics with its own OAuth flow in your browser.

A console API key (ak_…) does not work here. Production answers HTTP 401 {"error":"invalid_token"} to one.

Check it worked

Open ~/.config/devin/mcp_config.json on macOS, %APPDATA%\devin\mcp_config.json on Windows and ~/.config/devin/mcp_config.json on Linux: mcpServers has agentics with https://agentics.you/mcp.

Then ask your agent to use it:

Paste this into your agent

Call the remember tool with content "The customer prefers email over phone." Then call recall with the query "how does the customer like to be contacted?" and tell me the receipt_hash.

remember answers with saved true and a receipt_hash. recall returns that memory in results. Open the verify_url: the check does not show the memory's text.

Disconnect

In the desktop app, click Disconnect, then Confirm. When nothing else in the file changed since Connect, it goes back exactly as it was; otherwise only the agentics entry comes out.

By hand, delete agentics from mcpServers in ~/.config/devin/mcp_config.json on macOS, %APPDATA%\devin\mcp_config.json on Windows and ~/.config/devin/mcp_config.json on Linux.

What the app can't check

Your team's MCP allowlist in Devin Desktop's team settings isn't visible on this computer, and Devin Desktop documents no policy file for MCP.
A Windsurf release from before the rename to Devin Desktop reads ~/.codeium/windsurf/mcp_config.json instead: update it first.

If it does not connect

What you see	What it means
Not installed	The app found no Windsurf (Devin Desktop) on this computer. Install it, then click Check again.
Another agentics server	Windsurf (Devin Desktop) already has a different server named `agentics`. The app won't replace it: remove that one in Windsurf (Devin Desktop) first.
Can't read its settings	The app couldn't read Windsurf (Devin Desktop)'s config or a policy file, so it changes nothing. The row names the file and why.
HTTP 401 `{"error":"invalid_token"}`	Sign-in did not finish, or a console key (`ak_…`) was sent. Sign in again, or send an agent key (`agk_mcp_…`).
HTTP 405 `{"error":"Use POST for JSON-RPC"}`	Something sent GET, as a browser tab does. Clients send POST to `https://agentics.you/mcp`.
HTTP 403, code `-32000`, `Token lacks the mcp:tools scope`	The sign-in can't use the server. Remove agentics, add it again, and choose Allow.
`Unknown tool: remember`	The tool list is stale. Reconnect agentics so the tools are read again after sign-in.
`This connection cannot use remember.`	The grant is missing `actions:record`. Connect again and choose Allow.
`content is required.` (code `-32602`)	`remember` needs `content` as a string.
`Unknown field: …` (code `-32602`)	That argument is not one `remember` takes.
HTTP 429 `{"error":"Too many requests. Try again in a minute.","retry_after":…}`	120 calls a minute on that sign-in. Wait `Retry-After` seconds.
`This workspace has used its 10,000 actions for this month on Free. New actions are paused until the 1st (UTC).`	Free is at its monthly write cap. `recall` still works.

More errors are on Connect any MCP client.