Connect Hermoso to Windsurf (Devin Desktop)

Research, ads, posts and campaigns from the agent in your editor.

Devin Desktop supports Streamable HTTP servers and OAuth. It has two agents and they read different files, so pick the section for the one you use. New tabs use the Devin Local agent by default.

The server URL

https://app.hermoso.ai/mcp

Before you start

  • Anyone using Devin Desktop. Enterprise users have to turn MCP on in settings first, and a team admin can disable it.
  • A Hermoso account. The free plan is enough to try it (see pricing). No account yet? Create one in the app first.

The steps

Devin Local agent (the default for new tabs)

  1. This agent reads the Devin CLI's MCP config. Add Hermoso from a terminal:
    devin mcp add hermoso https://app.hermoso.ai/mcp
  2. Sign in:
    devin mcp login hermoso
  3. Run devin mcp list to check it is there.

Cascade (the legacy agent)

  1. Look for Hermoso in the MCP Marketplace: click the MCPs icon in the top right menu of the Cascade panel, or go to Devin Settings, Cascade, MCP Servers. If it is not there, add it by hand in the raw config file, as below.
  2. In ~/.codeium/windsurf/mcp_config.json, add Hermoso. Remote HTTP servers use serverUrl:
    {
      "mcpServers": {
        "hermoso": {
          "serverUrl": "https://app.hermoso.ai/mcp?tools=core"
        }
      }
    }
  3. Save. Click the MCPs icon and then Hermoso to open its settings page, where you can switch individual tools on or off. Devin Desktop supports OAuth for HTTP servers, so expect the Hermoso sign-in page when it first connects.

About Cascade's tool cap. Cascade caps the tools it can hold at 100 across all your servers, and Hermoso's full list is bigger than that. The ?tools=core on the URL above asks Hermoso for its short starting list instead, which leaves room for your other servers. Nothing is lost: that list includes find_tools, which searches every Hermoso tool by name or task, and call_tool, which runs any of them. So the rest of Hermoso is one search and one call away.

What you will be asked to approve

Your browser opens Hermoso's own page. It asks whether to let Devin Desktop use your Hermoso account, under whatever name Devin Desktop registers itself with. Sign in if you aren't already, then select Allow. That is the only thing you approve. It lets Devin Desktop research ads, plan creative and generate images and video on your account, the same things you can do in the app. There is no key to copy, and you can take it back any time in Hermoso under Settings, Agents & API.

Connecting Hermoso does not connect your ad accounts or social channels. You add those inside Hermoso, under Settings, Connectors, and only the ones you want. Ads are created paused, and nothing is posted or spent unless you ask for it.

A prompt to try

The prompt

Using Hermoso: use find_tools to see what you can do for paid ads, then pull how my Meta campaigns did over the last 7 days and tell me which ad to turn off.

Want more like that? The workflows are ready prompts for whole marketing jobs: competitor research into ads, ads from customer reviews, a week of scheduled posts, a paused Meta campaign.

Related

These steps follow Cascade: Model Context Protocol (MCP) and Devin CLI: MCP Configuration, read on 2026-09-20. Menus move, so if a name here no longer matches what you see, that page is the authority. Hermoso is not affiliated with or endorsed by the makers of Windsurf (Devin Desktop).

Connected? The workflows are ready prompts for whole marketing jobs. Pick one and run it.

See the workflows   Or start in the app