Cursor MCP 設定教學：一步一步建立單字卡
如何透過 MCP 將 Cursor 連接到 Deckbase，並從程式碼檔案、文件與筆記自動建立單字卡。完整逐步設定說明。
如果你把 Cursor 當成主要編輯器，可以透過模型情境協定（Model Context Protocol，MCP）將它連接到 Deckbase(opens in a new tab)，直接從你的程式碼庫建立單字卡，不必切換應用程式、不必複製內容，也不用離開編輯器。
本指南會完整走過用 Cursor MCP 建立單字卡的設定流程：MCP 是什麼、Deckbase 整合能做到哪些事，以及逐步的設定步驟。
MCP 是什麼？為什麼對單字卡很重要？
MCP（Model Context Protocol，模型情境協定）是一項開放標準，讓 AI 工具能連接外部服務。當你在 Cursor 中設定 MCP 伺服器後，編輯器裡的 AI 助理就能直接呼叫該服務的 API，它會成為對話中的一項工具，而不是你得另外打开的瀏覽器分頁。
用在單字卡製作上，這代表你可以：
-
選取一個函式、類別或一段文件，請 Cursor 根據內容建立單字卡
-
從程式碼註解、README 檔案或行內文件產生卡片
-
用專案裡的任何檔案或資料夾建立牌組
-
不必離開編輯器，就能把卡片加到現有的 Deckbase 牌組
實際效果是：無論你正在熟悉新的程式碼庫、準備技術證照考試，或想從文件建立個人知識庫，做卡片都簡化成一句 AI 指令。
事前準備
-
Cursor（最新版本）
-
Deckbase 帳號(opens in a new tab)（免費方案就夠用）
-
Deckbase API 金鑰（可在帳號設定中取得）
-
已安裝 Node.js 18 以上版本（用來執行 MCP 伺服器）
步驟 1：取得 Deckbase API 金鑰
-
前往「設定」→「API」
-
產生一組新的 API 金鑰
-
複製這組金鑰，下一步會用到
步驟 2：把 Deckbase MCP 伺服器加入 Cursor
開啟 Cursor 的「設定」→「Features」→「MCP Servers」，新增一組伺服器設定：
{
"name": "deckbase",
"command": "npx",
"args": ["-y", "@deckbase/mcp-server"],
"env": {
"DECKBASE_API_KEY": "your-api-key-here"
}
}
儲存設定並重新啟動 Cursor。之後每次啟動 Cursor，Deckbase MCP 伺服器都會自動啟動。
→ MCP 伺服器完整文件(opens in a new tab)
步驟 3：確認連線
開一個新的 Cursor 對話，輸入：
用 Deckbase MCP 工具列出我的牌組。
如果連線正常，Cursor 會回傳你的 Deckbase 牌組清單。若出現錯誤，請確認 API 金鑰是否正確，以及 MCP 伺服器是否正常啟動（可在設定的 MCP 伺服器日誌中查看）。
步驟 4：從程式碼檔案建立第一批卡片
在編輯器中選取一個函式或類別，開啟 Cursor 對話，然後試試：
請根據這段程式碼建立 5 張單字卡，讓我可以用來複習這個函式的運作方式，並加入我的「Python internals」牌組。
Cursor 會透過 Deckbase MCP 工具直接產生並加入卡片。不用複製貼上，也不用切換分頁。
可以用來建立卡片的素材
Deckbase MCP 整合支援 Cursor 能存取的所有文字內容：
-
**程式碼檔案：**函式、類別、演算法、設計模式
-
**文件：**README 檔案、API 參考文件、行內說明
-
**註解：**TODO 註解、架構筆記、行內解釋
-
**設定檔：**理解每個選項的作用
-
**測試檔案：**理解每個測試在驗證什麼行為
技術單字卡的範例指令
面對新的程式碼庫：
我正在熟悉這個程式碼庫。請從驗證模組建立 10 張單字卡，幫助我了解 session 管理機制，並加入我的「Codebase onboarding」牌組。
準備考試：
請根據這段 AWS IAM 文件產生 15 張單字卡，內容涵蓋角色（roles）、政策（policies）與權限界線（permission boundaries）之間的差異，並加入我的「AWS Solutions Architect」牌組。
用工作內容做每日複習：
請拿我今天最後寫的 3 個函式，為每一個建立複習卡片，內容涵蓋核心邏輯、處理過的邊界情況，以及我為什麼採用這種做法，並加入我的「Work knowledge base」牌組。
在 Deckbase 中複習卡片
透過 Cursor MCP 建立的卡片會立刻出現在你的 Deckbase 牌組中，可直接接受 FSRS 排程複習。打開 Deckbase 網頁版(opens in a new tab)或行動 App，依照平常的排程複習即可。
Cursor 負責製作、Deckbase 負責複習，兩者結合形成一個閉環：你從實際運作的程式碼中學習，透過自適應排程複習這些概念，把原本會在專案之間逐漸淡忘的技術知識真正留下來。
→ MCP 學習自動化範例(opens in a new tab)
常見問題：用 Cursor MCP 建立單字卡
Deckbase MCP 也能搭配 Cursor 以外的編輯器嗎？
可以。Deckbase MCP 伺服器與任何支援 MCP 的用戶端相容。Claude Desktop、Cline、Continue 以及其他支援 MCP 的工具，都能使用同一份伺服器設定。
使用 MCP 需要付費的 Deckbase 方案嗎？
最新方案細節請見 deckbase.co/mcp(opens in a new tab)。免費方案已支援核心牌組操作所需的 MCP 連線。
用私有程式碼建立卡片時，內容會不會離開我的電腦？
MCP 伺服器會把你選取的內容送到 Deckbase 的 API 來建立卡片。如果你處理的是專有或敏感程式碼，使用這項整合前，請先確認貴組織對外部 API 呼叫的規範。
請 Cursor 加入卡片時，牌組還不存在怎麼辦？
Deckbase MCP 工具可以在建立卡片的流程中一併建立新牌組。只要請 Cursor「建立一個叫做 X 的新牌組，並把這些卡片加進去」即可。
這跟手動把文字複製到 Deckbase 有什麼不同？
主要好處是：不必在應用程式之間切換、省去複製貼上的步驟，而且可以直接從專案裡的任何檔案建立卡片，完全不用開瀏覽器。對大多數學習時間都待在程式碼編輯器裡的人來說，流程精簡的幅度相當明顯。
把這類文章變成字卡
貼上連結、PDF 或筆記，Deckbase 就會建立牌組並以 FSRS 安排複習。