~/教學/MAGIC.md

文章 / AI 工具

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 預設做的白底三欄價目表,下面是 21st.dev 上的黑底 pricing section 元件
上:Claude 預設(一句話、沒給設計方向)。下:21st.dev 上真的元件,作者 Gujjeti Mokshith。

叫 Claude Code 做網頁,常常一看就知道是 AI 做的:白底、三張圓角卡片、中間一張紫色「Most Popular」。21st MCP(以前叫 Magic MCP)換個做法:讓 Claude Code 直接到 21st.dev 一萬兩千多個 React + Tailwind 元件裡挑一個真人做的,寫進你的專案。

照著做完,你會得到這些:

  1. 一把 21st 的 API key(免費帳號就能建立)。
  2. 一行指令把 21st 裝進 Claude Code,或改用官方外掛(plugin)一起裝。
  3. 不用記指令:直接用一般句子跟 Claude Code 說「用 21st 加一個價目表」,它會搜尋、挑元件、寫進專案。
  4. 可以直接複製的 prompt,[]換成你的頁面和元件就能用。
  5. 一份老實的提醒:免費帳號每天只能拿 2 個元件,AI 從零生成要付費,元件的授權也要自己看。

02第 1 步:建立 21st 帳號和 API key

21st.dev/mcp 頁面上方:Use 21st in your agent、Search 12,000+ components,旁邊一顆 API key 按鈕
21st.dev/mcp:右邊的「API key」就是建立金鑰的地方。
  1. 打開 21st.dev/mcp。
  2. 右上角登入;還沒有帳號就按「Get 21st free」建一個免費帳號。
  3. 按頁面上的「API key」,建立一把新的金鑰,複製起來。
  4. 登入之後,這一頁的安裝指令會自動帶入你的金鑰,直接複製也可以。
GitHub 21st-dev/magic-mcp 的 README:Magic MCP → 21st MCP,下面一段 Old Magic API keys were reset
官方 README:Magic MCP 已改名 21st MCP,舊的 Magic API key 全部重設。

03第 2 步:一行指令裝進 Claude Code(或用外掛)

21st.dev/mcp 的 Claude 分頁:Register the server 指令、claude mcp list 檢查、plugin 安裝兩行
21st.dev/mcp 的 Claude → Claude Code 分頁:01 註冊、03 檢查、04 外掛。

在終端機(不是在 Claude Code 對話框裡)貼這一行,把[]連同括號換成你的 API key:

裝進 Claude Code(終端機)
claude mcp add --transport http 21st https://21st.dev/api/mcp --header "x-api-key: [貼上你的 API key]"
  1. 貼上、按 Enter。預設只裝在你現在這個專案資料夾。
  2. 想在所有專案都能用,在 21st 後面加 --scope user(Claude Code 官方文件的用法)。
  3. 輸入 claude mcp list,看到 21st 顯示已連線(Connected)就成功了。
  4. 在專案資料夾打 claude,開始用。
檢查有沒有裝好(終端機)
claude mcp list

另一個做法是官方外掛:一次裝好 21st 的伺服器和 21st 的 skills。這兩行是在 Claude Code 裡面打:

用外掛安裝(在 Claude Code 裡)
/plugin marketplace add 21st-dev/claude-code-plugin
/plugin install 21st@21st

04第 3 步:用一般句子跟它說,不用 /ui

21st 官網的 Claude Code 示範:add a pricing table from 21st,搜尋出三個元件,get_component,寫進 pricing.tsx,Typecheck and build pass
21st 官網示範:一句話 → 搜尋 → 挑元件 → 寫進 pricing.tsx → 建置通過。

以前 Magic MCP 要打 /ui,現在不用了。官方的說法是直接用一般句子,請 agent 去 21st 找元件。句子裡提到「21st」,Claude Code 就知道要用它。我最常用這幾句:

加一個新元件([]換成你的)
用 21st 幫我在[頁面,例如首頁 app/page.tsx]加一個[元件,例如價目表],風格[例如深色、極簡,跟現在網站的配色一致]。
先搜尋就好,列出 3 個候選、作者和差別,等我選一個再安裝。
換掉一個很 AI 的區塊
用 21st 找一個[元件,例如 FAQ 手風琴],取代[檔案,例如 components/faq.tsx]裡現在的版本。
保留我原本的文字內容,顏色和字型改用專案現有的設定。
裝好之後接上你的內容
把剛剛從 21st 裝的[元件名稱]換成我的內容:[方案名稱、價格、每個方案的重點]。
改完跑[npm run build],確認沒有錯誤再告訴我。

它在背後會做這幾件事(21st 官網示範的流程):

  1. search:用你的描述到 21st 搜尋元件。搜尋免費、不限次數。
  2. get_component:拿你選的那個元件的程式碼。免費帳號每天 2 次就是算在這裡。
  3. 把元件寫成一個檔案(示範裡是 components/ui/pricing.tsx),安裝它需要的套件,把寫死的顏色換成你專案的設定。
  4. 跑型別檢查和建置,通過了告訴你放在哪一頁。

05要注意

21st.dev/pricing:Builder 每月 6 美元(年繳)、Builder + AI 每月 15 美元(年繳)、Team 每人每月 7.5 美元
21st.dev/pricing(年繳價):Builder 寫著「Free: 2 a day」,AI 生成要 Builder + AI。
  1. 免費帳號:搜尋不限次數;拿元件程式碼每天 2 次,網站、MCP、CLI 三個加起來算(複製、安裝都算)。
  2. Builder:每月 6 美元(年繳),季繳每月 8 美元。元件無限安裝,但不含 AI 額度。
  3. 要 AI 從零生成元件(generate 工具),要 Builder + AI:500 點每月 15 美元起(年繳,季繳 20 美元),1,000 點 30 美元、2,000 點 60 美元(年繳)。沒開 AI 的帳號,Claude Code 根本看不到生成的工具。
  4. Magic MCP 已經改名 21st MCP,舊的 Magic API key 都重設了,要重新建立。網路上舊教學寫的 /ui、/21 指令已經不用,直接講一般句子。
  5. 元件授權:21st 的條款寫明,市集上的程式碼屬於各自的作者(和 21st Labs),條款本身沒有給一個通用的授權,也不能未經授權轉賣或重新發布。開源元件要保留原本的授權、標明作者。拿去商業專案之前,先看元件頁面和作者寫的授權;我這篇示範的元件頁面就沒寫清楚授權,要用就先問作者。
  6. API key 等於你的帳號額度,不要貼到公開的 repo 或截圖裡。
  7. 價格和每日額度是 2026 年 11 月 5 日在官方頁面看的,之後可能會改,以 21st.dev/pricing 為準。
  8. 這篇是在主頁連結輸入關鍵字 MAGIC 找到的,不會私訊。

資料來源

延伸閱讀