shadcnstudio MCP Proxy

Use the shadcnstudio MCP Server via the proxy — no upstream credentials needed

Quick start

Please read the official docs to learn the full features and usage of the shadcnstudio MCP Server. Claude Code's MCP setup is essentially the same, but both the install command and the registry URL in components.json must switch to this proxy。

Install MCP Server

bash

claude mcp add --transport stdio shadcn-studio-mcp --scope user -- npx -y ss-mcp-proxy@latest API_KEY=<YOUR_KEY> EMAIL=anything@example.com

Differences from the official install command

Package name changes from shadcn-studio-mcp to ss-mcp-proxy
API_KEY is the distributed key (prefix ss_mcp_)
EMAIL can be any value

Full Claude Code setup

This follows the official four-step flow, but step 1's install command and step 2's components.json registryconfig must use this proxy.

1. Installation

Open Claude Code in your project directory, run the install command below; once installed, use /mcp /mcp to verify the MCP Server is loaded.

bash

claude mcp add --transport stdio shadcn-studio-mcp --scope user -- npx -y ss-mcp-proxy@latest API_KEY=<YOUR_KEY> EMAIL=anything@example.com

text

/mcp

2. Configure components.json file

Make sure your shadcn project is initialized. The registry structure in the official docs is for reference, but don't use the official domain directly; switch to the shadcnstudio shadcnstudio entry provided by this proxy.

How to use shadcn CLI

Example proxy config: /r/shadcnstudio。

3. Setup Instructions & Commands

Setup Instructions file (CLAUDE.md)

Create the official AI instructions file in your project to give Claude Code shadcn code-generation constraints.

bash

curl -o CLAUDE.md https://cdn.shadcnstudio.com/ss-assets/mcp/instructions/copilot-instructions.md

Setup Commands for Claude Code

Run the command below to create /cui、/iui、/rui /ftc shortcuts.

bash

mkdir -p .claude/commands

echo "Call a tool get-create-instructions from a shadcn-studio mcp server with the following prompt #$ARGUMENTS and follow all the instructions provided in the response." > .claude/commands/cui.md

echo "Call a tool get-inspire-instructions from a shadcn-studio mcp server with the following prompt #$ARGUMENTS and follow all the instructions provided in the response." > .claude/commands/iui.md

echo "Call a tool get-refine-instructions from a shadcn-studio mcp server with the following prompt #$ARGUMENTS and follow all the instructions provided in the response." > .claude/commands/rui.md

echo "Call a tool get-ftc-instructions from a shadcn-studio mcp server with the following prompt #$ARGUMENTS and follow all the instructions provided in the response." > .claude/commands/ftc.md

Note: this must be configured separately in each project that uses the MCP Server.

4. Use the shadcnstudio MCP Server

After completing the steps above, you can use it directly in Claude Code: /cui、/iui、/rui /ftc.

FAQ

What if I get rate-limited?

Default limit is 15 req/s; normal usage won't trigger it. If rate-limited, wait a few seconds and retry.

Is it okay to enter any EMAIL?

Yes. The proxy ignores the client-sent email and replaces it with the real mailbox configured on the server. It's required only to satisfy the MCP package's config format.

Quick start

Install MCP Server

bash

claude mcp add --transport stdio shadcn-studio-mcp --scope user -- npx -y ss-mcp-proxy@latest API_KEY=<YOUR_KEY> EMAIL=anything@example.com

Differences from the official install command

Package name changes from shadcn-studio-mcp to ss-mcp-proxy
API_KEY is the distributed key (prefix ss_mcp_)
EMAIL can be any value

Full Claude Code setup

This follows the official four-step flow, but step 1's install command and step 2's components.json registryconfig must use this proxy.

1. Installation

Open Claude Code in your project directory, run the install command below; once installed, use /mcp /mcp to verify the MCP Server is loaded.

bash

claude mcp add --transport stdio shadcn-studio-mcp --scope user -- npx -y ss-mcp-proxy@latest API_KEY=<YOUR_KEY> EMAIL=anything@example.com

text

/mcp

2. Configure components.json file

How to use shadcn CLI

Example proxy config: /r/shadcnstudio。

3. Setup Instructions & Commands

Setup Instructions file (CLAUDE.md)

Create the official AI instructions file in your project to give Claude Code shadcn code-generation constraints.

bash

curl -o CLAUDE.md https://cdn.shadcnstudio.com/ss-assets/mcp/instructions/copilot-instructions.md

Setup Commands for Claude Code

Run the command below to create /cui、/iui、/rui /ftc shortcuts.

bash

mkdir -p .claude/commands

echo "Call a tool get-create-instructions from a shadcn-studio mcp server with the following prompt #$ARGUMENTS and follow all the instructions provided in the response." > .claude/commands/cui.md

echo "Call a tool get-inspire-instructions from a shadcn-studio mcp server with the following prompt #$ARGUMENTS and follow all the instructions provided in the response." > .claude/commands/iui.md

echo "Call a tool get-refine-instructions from a shadcn-studio mcp server with the following prompt #$ARGUMENTS and follow all the instructions provided in the response." > .claude/commands/rui.md

echo "Call a tool get-ftc-instructions from a shadcn-studio mcp server with the following prompt #$ARGUMENTS and follow all the instructions provided in the response." > .claude/commands/ftc.md

Note: this must be configured separately in each project that uses the MCP Server.

4. Use the shadcnstudio MCP Server

After completing the steps above, you can use it directly in Claude Code: /cui、/iui、/rui /ftc.

FAQ

What if I get rate-limited?

Default limit is 15 req/s; normal usage won't trigger it. If rate-limited, wait a few seconds and retry.

Is it okay to enter any EMAIL?

Yes. The proxy ignores the client-sent email and replaces it with the real mailbox configured on the server. It's required only to satisfy the MCP package's config format.