AI and MCP

How to connect Windsurf (Devin Desktop) to SpendixAI with MCP

Windsurf is now Devin Desktop. Add SpendixAI through the MCP config file, authenticate with OAuth, and handle the config path conflict in the vendor's own pages.

Editorial illustration for How to connect Windsurf (Devin Desktop) to SpendixAI with MCP

Windsurf is now called Devin Desktop, and that is why older tutorials and newer documentation disagree about names and file locations. Cognition's FAQ says the rename took effect on 2 June 2026 and is branding only, with legacy .windsurf rule and skill paths still loading.

The names you will see

The app binary is now Devin, and the in-editor agent is called Devin Local. Older pages still say Windsurf and Cascade. A separate product, Windsurf Plugins for JetBrains and other editors, still exists under the old name; this guide is about the desktop editor. We build SpendixAI ourselves, and we checked the Devin pages in November 2026. Expect labels to keep moving.

Settle the config file location first

The vendor's own pages disagree, and we could not resolve the conflict. Use the app's 'Open MCP config file' action, if you see it, instead of guessing a path.

SourcePath described
Devin Local page, project.devin/mcp_config.json
Devin Local page, local override.devin/mcp_config.local.json
Devin Local page, user level~/.config/devin/mcp_config.json, or mcp_config.json inside the devin folder under AppData on Windows
Desktop FAQ~/.codeium/mcp_config.json, described as unchanged

Adding SpendixAI

  1. Copy the address from Developer → MCP connections in SpendixAI.
  2. In Devin Desktop, open the MCP config file with the 'Open MCP config file' action.
  3. Add an mcpServers object with an entry named spendixai.
  4. Give it a serverUrl field set to <your SpendixAI server address>. The desktop app also accepts a url field.
  5. Leave headers out so the app uses OAuth instead of a pasted key.
  6. Save, then find spendixai in the MCP list. If it shows 'Needs authentication', click Authenticate.
  7. On the SpendixAI consent screen, sign in, choose the workspace and pick Read only.

Devin Local supports stdio, Streamable HTTP and SSE, each with OAuth. If a token expires, the server shows the same 'Needs authentication' state and you repeat the step.

What we could not confirm about the interface

The Devin Local page describes a Customize page with an MCPs section where you choose where to install and pick servers from an available list. That list is for registry servers. We could not confirm a way to enter a custom address through that screen, so the JSON file is the route we verified. The older Windsurf pages describe Settings, then Tools, then Windsurf Settings, then Add Server; that was not rechecked against the current build.

Approval and administrators

By default the agent asks for approval before calling any MCP tool. Keep that behaviour for SpendixAI. Enterprise users must enable MCP manually. Team admins can switch MCP on or off and allowlist servers; once any server is allowlisted, all others are blocked. If SpendixAI does not appear or cannot be added, ask whoever manages your plan whether MCP is enabled and whether an allowlist is in force.

SpendixAI's presets are the second guard. Read only (recommended) covers transactions and reports. Read and add also creates transactions and uploads documents. Full access adds categorisation rules and insights. Billing and member settings never reach an assistant, and your workspace role still applies.

A separate product: the Devin command line

The Devin CLI has its own commands: devin mcp add spendixai with a --url option, then devin mcp login spendixai. It can store the entry at project or user level. The Devin cloud web app is another thing again, needing an organisation admin or a 'Manage MCP Servers' permission, and we did not cover it here.

First questions

  • What did I spend last month, by category?
  • Which three merchants did I pay most this year?
  • Which uncategorised transactions need my attention?

Check key figures against the SpendixAI report. To remove access, disconnect Devin Desktop under Developer → MCP connections.

If your editor was installed before the rename, you may still have Windsurf-era notes, bookmarks or team documents that point at the old names and paths. Update them so colleagues do not follow instructions for a layout that has changed.

SPENDIXAI JOURNAL

Useful ideas start with a clearer picture of your own spending.

Explore your reports