Skip to content

shadcn/ui in Windsurf (Devin Desktop)

Add an entry to mcp_config.json and the agent in Windsurf, now Devin Desktop, checks components and blocks before it writes, then installs them for your framework. It needs shadcn.io Pro, billed apart from Devin.

Kind
Editor
Goes in
~/.codeium/windsurf/mcp_config.json
Connects
Over HTTP
Team config
Yes

Paste one entry, start a session

Windsurf kept its MCP servers in mcp_config.json, and Devin Desktop still reads that file. Signed in with Pro, the entry beside the steps holds your token.

  1. Copy the entry

    With Pro, it carries your token in an Authorization header and names the address serverUrl, Windsurf's key for a remote server. No token yet? Create one on your account.

  2. Merge it into mcp_config.json

    Open ~/.codeium/windsurf/mcp_config.json (windsurf-next on the Next build) and add shadcnio inside mcpServers, beside any servers already there. Save the file.

  3. Start a new Devin Local session

    Devin Local, the agent that replaced Cascade, imports Windsurf's servers (opens in a new tab) when a session starts, so open a fresh tab rather than an old conversation.

  4. Approve the first call

    Devin Local asks before any MCP tool runs. Allow every tool on the server, permanently, and the 22 read-only tools stop asking.

~/.codeium/windsurf/mcp_config.json
Sign in to get your config
Sign in with a Pro account, and this holds your MCP URL, ready to paste.

How it reads, with YOUR_TOKEN where your token goes:

{
  "mcpServers": {
    "shadcnio": {
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      },
      "serverUrl": "https://www.shadcn.io/api/mcp"
    }
  }
}

~/.codeium/ lives in your home folder, so the token never lands in a repository. Regenerate it the moment it leaks, then paste the new one in.

Where the entry can live in Devin Desktop
FileAddress keyWho gets it
~/.codeium/windsurf/mcp_config.jsonserverUrl, as copiedYou, in every project (imported by Devin Local)
~/.config/devin/mcp_config.json (%APPDATA%\devin\ on Windows)urlYou, in every project (Devin's own user file)
.devin/mcp_config.jsonurlEveryone who clones the repo, once committed
.devin/mcp_config.local.jsonurlYou, in this repo only (gitignored)

Share one entry with the team

The shared entry's header reads ${env:SHADCNIO_TOKEN}, so it holds no secret: pass it around, or commit it as .devin/mcp_config.json with serverUrl renamed url. Each person exports SHADCNIO_TOKEN before starting Devin Desktop, or swaps in ${file:…} to read a token file. On a shadcn.io Team or Organization plan, each seat holder generates that token from their own account page.

mcp_config.json
{
  "mcpServers": {
    "shadcnio": {
      "headers": {
        "Authorization": "Bearer ${env:SHADCNIO_TOKEN}"
      },
      "serverUrl": "https://www.shadcn.io/api/mcp"
    }
  }
}

Each teammate sets SHADCNIO_TOKEN to their own token (from their MCP URL), so no token is committed.

See it in a session

In a Devin Local session, /mcp lists every server it knows with its status, and Open customizations shows the ones the session loaded.

  1. Open a new agent tab on Devin Local: the agent selector sits in the bottom right corner.
  2. Type /mcp and find shadcnio in the list, connected.
  3. Or right-click the session in the agent sidebar, choose Open customizations, and look under MCP servers.
  4. Send the prompt below and allow the call: Devin Local runs whoami and replies with your account and the calls left this minute.
Prompt
use shadcnio to check which account I'm connected as

A day with it in Devin Desktop

Three jobs from a day in Devin Desktop: a plan turned into a page, a Vue port, and the file open in the editor. Turn the MCP off to see the same prompt without it.

Your agent
  1. shadcn.io MCP connected · 22 tools
  2. You: Plan a landing page for our invoicing app from blocks, and build it once I approve.
  3. MCP call: plan_page({ brief: "landing page for an invoicing app", kind: "marketing" })Returns: Hero, features, pricing, FAQ and CTA, two alternatives each
  4. Agent step: Wrote the plan to ~/.devin/plans, waited for ImplementReturns: You swapped the hero for one with app screenshots
  5. MCP call: get_block({ names: ["hero-app-screenshots", "features-bento-grid", "pricing-billing-toggle", "faq-accordion", "cta-centered-dark-dual-action"], include: ["install"] })Returns: One npx shadcn add command for all five
  6. Agent step: Ran npx shadcn add (you allowed it once)Returns: Five sections, stacked in app/page.tsx
  7. Your agent: The landing page follows the plan you approved: five blocks, one install, monthly and yearly pricing included.

In your project

Landing page

  • Five real blocks, in the plan's order
  • One install for the whole page

1 prompt → 2 MCP calls

Prompts for a Devin Local tab

Paste one into a new Devin Local tab. Naming shadcnio keeps the agent on the registry instead of its training data.

01
use shadcnio to plan the marketing site from blocks, hero to footer, and wait for my go before installing
02
megaplan the settings area with shadcnio blocks: profile, billing, API keys and a danger zone
03
use shadcnio to swap the hand-built dropdown in this file for the Menu component
04
use shadcnio to add toasts to this SvelteKit app and show one when a draft saves
05
use shadcnio to check what props Combobox takes before you change the country picker
06
use shadcnio to put an onboarding checklist on the empty dashboard
07
use shadcnio to restyle the app after Vercel's DESIGN.md, keeping our dark mode
08
use shadcnio to find a Lucide icon for each item in the settings nav

Worth knowing in Devin Desktop

Permissions, rules, plan mode and worktrees: the parts of Devin Local that change how the MCP behaves.

  • Allow the server for good

    Each of the 22 tools only reads. Put mcp__shadcnio__* in permissions.allow in ~/.config/devin/config.json and Devin Local stops asking; shell commands keep their own rules.

    {
      "permissions": {
        "allow": ["mcp__shadcnio__*"]
      }
    }
  • A rule instead of naming it

    Devin Desktop reads AGENTS.md and .devin/rules/*.md, and .windsurf/rules/ still works. An always_on rule keeps the registry in every request without naming it.

    ---
    trigger: always_on
    ---
    For UI work, search the shadcnio MCP before writing a component, and install it with the command it returns.
  • The server's prompts as commands

    Type /mcp__shadcnio__ in a session and pick one of seven: add, block, form, setup, page, icons or design. Words after the command fill the prompt's arguments in order.

  • Plan a page before installing

    Start with /plan, or put megaplan in the prompt, and Devin Local only reads: it calls plan_page, writes the plan to ~/.devin/plans/, and installs nothing until you click Implement.

  • Try a block in a worktree

    Pick a worktree in the location picker when you start the session. The agent installs and edits there, your checkout stays clean, and Merge brings the result back.

  • Add it from the terminal

    With Devin CLI installed, one command writes the server to Devin's own user file, which takes url. Use the endpoint and token from the config above.

    $ devin mcp add -s user shadcnio <endpoint> -H "Authorization: Bearer <token>"

When Devin Local can't reach shadcnio

Most failures show up in /mcp or on the tool call itself. Errors that aren't particular to Devin Desktop are in the troubleshooting guide.

/mcp doesn't list shadcnio.
The session started before you saved, or the file doesn't parse: a missing comma between two servers is typical. Fix the JSON and open a new Devin Local tab, since imports happen when a session starts.
The entry sits in .devin/mcp_config.json but never connects.
Devin's own files take url for a remote server, and the copied entry says serverUrl, Windsurf's key. Rename it and start a new session.
Every shadcnio call comes back 401.
The header has no token, or one you've regenerated since. Copy the entry again and replace the old one. With the team entry, an unset SHADCNIO_TOKEN resolves to an empty string: export it, quit Devin Desktop and reopen it from that shell with devin-desktop ..
Calls return 403 although the token is current.
The token is fine; the account behind it has no active Pro plan. Renew it, and the same entry works with nothing to edit.
On a work account, shadcnio is blocked or missing.
An admin controls MCP for your team: Allow MCP may be off, or an allowlist blocks every server not on it. Ask them to add shadcnio, matching your config's key, case included.
A tool call fails and the chat only says it errored.
Open the Output panel and choose the MCP: shadcnio channel. Each server keeps its own log there, so the failed request is easy to find.

Get the MCP for Windsurf with Pro

The MCP comes with every Pro plan, with every block and premium template, for you or your whole team. Monthly, yearly or lifetime.

4.9/5 out of 5 · 150+ reviewsfrom 150+ founders and developers.

  • Secure checkout via Stripe
  • Code lives in your repo
  • Keep what you've shipped if you cancel
  • License terms

Frequently asked questions

The shadcn MCP in Windsurf: setup, limits, and the rest.

4.9 out of 5 from 150+ developers

Point Devin Desktop at the registry

One entry in Windsurf's mcp_config.json hands Devin Local every component, 6,231 blocks and 294k icons, with any Pro plan.

Get Pro