~/教學/MAGIC.md
21st MCP(以前叫 Magic MCP):讓 Claude Code 做的網頁不再像 AI 做的,兩步裝好
21st MCP 讓 Claude Code 從 21st.dev 一萬兩千多個 React 元件裡挑一個,直接寫進專案。附 API key、一行安裝、外掛、一句話 prompt 和免費額度提醒。
Claude Code 做的網頁,常常一看就是 AI 做的。21st MCP(以前叫 Magic MCP)讓它改用 21st.dev 上真人做的現成元件:裝好之後跟它說一句「用 21st 加一個價目表」,它就搜尋、挑一個、寫進你的專案。這篇是 Reels 裡 MAGIC 那支影片的完整版:先看前後對比,再來是怎麼拿 API key、一行指令(或外掛)裝進 Claude Code、可以直接複製的 prompt,以及免費額度、付費 AI 生成、改名和授權這些要注意的地方。
01先看結果:同一個價目表,Claude 預設 vs 21st 元件

叫 Claude Code 做網頁,常常一看就知道是 AI 做的:白底、三張圓角卡片、中間一張紫色「Most Popular」。21st MCP(以前叫 Magic MCP)換個做法:讓 Claude Code 直接到 21st.dev 一萬兩千多個 React + Tailwind 元件裡挑一個真人做的,寫進你的專案。
照著做完,你會得到這些:
- 一把 21st 的 API key(免費帳號就能建立)。
- 一行指令把 21st 裝進 Claude Code,或改用官方外掛(plugin)一起裝。
- 不用記指令:直接用一般句子跟 Claude Code 說「用 21st 加一個價目表」,它會搜尋、挑元件、寫進專案。
- 可以直接複製的 prompt,[]換成你的頁面和元件就能用。
- 一份老實的提醒:免費帳號每天只能拿 2 個元件,AI 從零生成要付費,元件的授權也要自己看。
02第 1 步:建立 21st 帳號和 API key

- 打開 21st.dev/mcp。
- 右上角登入;還沒有帳號就按「Get 21st free」建一個免費帳號。
- 按頁面上的「API key」,建立一把新的金鑰,複製起來。
- 登入之後,這一頁的安裝指令會自動帶入你的金鑰,直接複製也可以。

- 21st MCP 官方安裝頁 — 建立 API key、各家工具的安裝指令
03第 2 步:一行指令裝進 Claude Code(或用外掛)

在終端機(不是在 Claude Code 對話框裡)貼這一行,把[]連同括號換成你的 API key:
claude mcp add --transport http 21st https://21st.dev/api/mcp --header "x-api-key: [貼上你的 API key]"
- 貼上、按 Enter。預設只裝在你現在這個專案資料夾。
- 想在所有專案都能用,在 21st 後面加 --scope user(Claude Code 官方文件的用法)。
- 輸入 claude mcp list,看到 21st 顯示已連線(Connected)就成功了。
- 在專案資料夾打 claude,開始用。
claude mcp list
另一個做法是官方外掛:一次裝好 21st 的伺服器和 21st 的 skills。這兩行是在 Claude Code 裡面打:
/plugin marketplace add 21st-dev/claude-code-plugin /plugin install 21st@21st
- 21st MCP 官方安裝頁(Claude 分頁) — claude mcp add 指令和外掛指令
- 官方外掛 21st-dev/claude-code-plugin — Apache-2.0,伺服器 + skills
- Claude Code 官方文件:MCP — --scope、claude mcp list、/mcp
04第 3 步:用一般句子跟它說,不用 /ui

以前 Magic MCP 要打 /ui,現在不用了。官方的說法是直接用一般句子,請 agent 去 21st 找元件。句子裡提到「21st」,Claude Code 就知道要用它。我最常用這幾句:
用 21st 幫我在[頁面,例如首頁 app/page.tsx]加一個[元件,例如價目表],風格[例如深色、極簡,跟現在網站的配色一致]。 先搜尋就好,列出 3 個候選、作者和差別,等我選一個再安裝。
用 21st 找一個[元件,例如 FAQ 手風琴],取代[檔案,例如 components/faq.tsx]裡現在的版本。 保留我原本的文字內容,顏色和字型改用專案現有的設定。
把剛剛從 21st 裝的[元件名稱]換成我的內容:[方案名稱、價格、每個方案的重點]。 改完跑[npm run build],確認沒有錯誤再告訴我。
它在背後會做這幾件事(21st 官網示範的流程):
- search:用你的描述到 21st 搜尋元件。搜尋免費、不限次數。
- get_component:拿你選的那個元件的程式碼。免費帳號每天 2 次就是算在這裡。
- 把元件寫成一個檔案(示範裡是 components/ui/pricing.tsx),安裝它需要的套件,把寫死的顏色換成你專案的設定。
- 跑型別檢查和建置,通過了告訴你放在哪一頁。
05要注意

- 免費帳號:搜尋不限次數;拿元件程式碼每天 2 次,網站、MCP、CLI 三個加起來算(複製、安裝都算)。
- Builder:每月 6 美元(年繳),季繳每月 8 美元。元件無限安裝,但不含 AI 額度。
- 要 AI 從零生成元件(generate 工具),要 Builder + AI:500 點每月 15 美元起(年繳,季繳 20 美元),1,000 點 30 美元、2,000 點 60 美元(年繳)。沒開 AI 的帳號,Claude Code 根本看不到生成的工具。
- Magic MCP 已經改名 21st MCP,舊的 Magic API key 都重設了,要重新建立。網路上舊教學寫的 /ui、/21 指令已經不用,直接講一般句子。
- 元件授權:21st 的條款寫明,市集上的程式碼屬於各自的作者(和 21st Labs),條款本身沒有給一個通用的授權,也不能未經授權轉賣或重新發布。開源元件要保留原本的授權、標明作者。拿去商業專案之前,先看元件頁面和作者寫的授權;我這篇示範的元件頁面就沒寫清楚授權,要用就先問作者。
- API key 等於你的帳號額度,不要貼到公開的 repo 或截圖裡。
- 價格和每日額度是 2026 年 11 月 5 日在官方頁面看的,之後可能會改,以 21st.dev/pricing 為準。
- 這篇是在主頁連結輸入關鍵字 MAGIC 找到的,不會私訊。
- 21st 價格方案 — Free、Builder、Builder + AI、Team
- 21st 使用條款 — 元件程式碼的所有權和授權(2026-07-20 更新)
- 示範用的元件:pricing section — 作者 Gujjeti Mokshith
資料來源
- 21st MCP 官方安裝頁 21st.dev/mcp(Claude Code 指令、外掛、FAQ 免費額度,2026-11-05 查)
- 21st 價格方案 21st.dev/pricing(2026-11-05 查)
- 21st llms.txt(免費帳號每日額度、12,000+ 元件)
- GitHub:21st-dev/magic-mcp(改名、舊 key 重設、/ui FAQ、ISC 授權)
- GitHub:21st-dev/claude-code-plugin(外掛安裝、API_KEY_21ST)
- 21st 使用條款(2026-07-20 更新)
- 21st.dev 元件:pricing section(Gujjeti Mokshith)
- Claude Code 官方文件:MCP(--scope、claude mcp list、/mcp)
下一支 Reel 想學什麼?
我每天測 Claude 和 AI 工具,把真的有用的做成 Reel。追蹤 @vivianlin.tech,新教學一出來就看得到。