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.
Copy the entry
With Pro, it carries your token in an
Authorizationheader and names the addressserverUrl, Windsurf's key for a remote server. No token yet? Create one on your account.Merge it into mcp_config.json
Open
~/.codeium/windsurf/mcp_config.json(windsurf-nexton the Next build) and addshadcnioinsidemcpServers, beside any servers already there. Save the file.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.
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.
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.
| File | Address key | Who gets it |
|---|---|---|
~/.codeium/windsurf/mcp_config.json | serverUrl, as copied | You, in every project (imported by Devin Local) |
~/.config/devin/mcp_config.json (%APPDATA%\devin\ on Windows) | url | You, in every project (Devin's own user file) |
.devin/mcp_config.json | url | Everyone who clones the repo, once committed |
.devin/mcp_config.local.json | url | You, 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.
{ "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.
- Open a new agent tab on Devin Local: the agent selector sits in the bottom right corner.
- Type
/mcpand findshadcnioin the list, connected. - Or right-click the session in the agent sidebar, choose Open customizations, and look under MCP servers.
- Send the prompt below and allow the call: Devin Local runs
whoamiand replies with your account and the calls left this minute.
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.
- shadcn.io MCP connected · 22 tools
MCP call: plan_page({ brief: "landing page for an invoicing app", kind: "marketing" })Returns: Hero, features, pricing, FAQ and CTA, two alternatives eachAgent step: Wrote the plan to ~/.devin/plans, waited for ImplementReturns: You swapped the hero for one with app screenshotsMCP 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 fiveAgent step: Ran npx shadcn add (you allowed it once)Returns: Five sections, stacked in app/page.tsx
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.
shadcnio blocks: profile, billing, API keys and a danger zoneWorth 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__*inpermissions.allowin~/.config/devin/config.jsonand Devin Local stops asking; shell commands keep their own rules.{ "permissions": { "allow": ["mcp__shadcnio__*"] } }
A rule instead of naming it
Devin Desktop reads
AGENTS.mdand.devin/rules/*.md, and.windsurf/rules/still works. Analways_onrule 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,iconsordesign. Words after the command fill the prompt's arguments in order.Plan a page before installing
Start with
/plan, or putmegaplanin the prompt, and Devin Local only reads: it callsplan_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.
/mcpdoesn't listshadcnio.- 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.jsonbut never connects. - Devin's own files take
urlfor a remote server, and the copied entry saysserverUrl, 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_TOKENresolves to an empty string: export it, quit Devin Desktop and reopen it from that shell withdevin-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,
shadcniois 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: shadcniochannel. 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.
Yes. Windsurf was renamed Devin Desktop in June 2026. Its agent, Devin Local, imports the MCP servers in Windsurf's ~/.codeium/windsurf/mcp_config.json when a session starts, so an entry you added in Windsurf keeps working.
Devin Local replaced Cascade, so there is no Cascade panel any more: type /mcp in a session to see each server and its status, or open the session's customizations to see the MCP servers it loaded.
Windsurf's own file reads serverUrl, which is what the config on this page uses. Devin's files, ~/.config/devin/mcp_config.json and the .devin/ ones inside a repo, document url instead. The address and the Authorization header stay the same in both.
~/.codeium/windsurf/mcp_config.json is Windsurf's file, imported by Devin Local for every project. Devin's own user file lives in ~/.config/devin, or %APPDATA%\devin on Windows. In a repo, .devin/mcp_config.json is shared once committed and .devin/mcp_config.local.json stays yours.
Only until you choose otherwise. It asks before any MCP tool by default, and the prompt lets you allow one tool or every tool on the server, for the session or permanently. All 22 tools only read the registry; the install commands that follow are judged by your command permissions.
The Vue, Svelte or Solid version of each component, picked from your package.json. For those frameworks get_install_plan returns every file with its path plus the packages to add, and Devin Local writes the files and runs the install.
A pasted page covers one component in one framework, and it sits in the conversation whether it helps or not. With the MCP, Devin Local fetches what the moment needs: the install command for your framework and base, one part's props, a demo or a whole block, across 6,231 blocks and 294k icons.
Yes. 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.
It picks tools from the prompt, and a short prompt looks answerable without any. Name the server, check that /mcp shows shadcnio, and add a rule in AGENTS.md or .devin/rules telling it to search shadcnio before it writes UI.
Two settings an admin controls. The Allow MCP setting has to be on, and if the team keeps an MCP allowlist, shadcnio must be on it, spelled exactly like the key in your config.
Make the Authorization header read the token from an environment variable, or from a file, instead of holding it. That entry can be committed as .devin/mcp_config.json with serverUrl renamed url. Each person sets their own variable before starting Devin Desktop, and each seat on a Team or Organization plan has a token of its own.
It sits in plain text in your home folder, like other editor credentials, and never inside a repository. For a config you share, read it from the environment or from a file instead of writing it in. If it leaks, regenerate it on your account page and the old one stops working within a few minutes.
What reaches shadcn.io is the call itself: the tool's name and its arguments. Your project's files are read by the agent on your side, never by the server, and no tool can write to them. Installs are commands Devin Local runs for you, under your command permissions.
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.
A 401 means the header has no token or one you regenerated; with the shared entry, an unset environment variable resolves to nothing. A 403 means the token is fine but the account has no active Pro. A 429 means a single token passed 600 calls in a minute, so wait for the Retry-After to run out.
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, and the tool call in the chat shows its error as well.
Using another agent too?
The same URL works in every MCP client: use it beside Windsurf, in your editor, your terminal or your chat app.
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