指南 · 資源

Deckbase MCP 單字卡：比較方式與建立卡片的方法

Model Context Protocol 會將 AI 助理連接到外部工具。多數 MCP 伺服器用於處理文件或程式碼；Deckbase MCP 則會將你的助理連接到你的牌組與卡片，內容與你在 Deckbase 應用程式中學習的完全相同。

Deckbase閱讀時間 7 分鐘

為什麼會有這個頁面

如果你正在搜尋 MCP 單字卡、間隔重複 MCP 或 從 Cursor 建立 Anki 風格卡片，你想要的通常是兩件事：與其他 MCP 模式的公平比較，以及能真正從編輯器建立卡片的清楚流程。以下兩者都有，並附上設定與技術文件的連結。

多數介紹 MCP 的頁面只在高層次說明協定。本指南刻意偏向實際操作：當你的助理能在具備範本限制、牌組 ID 與同步行為的單字卡庫中寫入資料時，會有什麼改變。

這項比較如何評估

為了避免比較內容過於空泛，我們用一個實際問題來評估每種 MCP 模式：它是否能完成端到端的牌組與卡片流程，且成果可直接在間隔重複應用程式中學習？

  1. 1
    這項比較是從 Deckbase 產品角度撰寫，重點放在實際的卡片建立流程，而非一般性的 MCP 示範。
  2. 2
    範例優先呈現學習者實際會執行的任務：列出牌組、檢查範本結構描述，以及建立會同步到手機的卡片。
  3. 3
    參考資料與公開 MCP 文件保持一致，讓實作細節仍可驗證。

Deckbase MCP 與常見 MCP 伺服器

MCP 是協定；每個伺服器會自行決定要公開哪些工具。以下是 Deckbase 與常見模式的對照。

文件與知識類 MCP

常見用途
在聊天情境中讀取 wiki、Notion 或內部文件。
牌組與卡片 CRUD
否，它們不會建立或同步單字卡牌組。
Deckbase 的優勢
Deckbase MCP 專為你的單字卡庫打造：牌組、範本與卡片都會出現在應用程式中。

程式庫與檔案系統 MCP

常見用途
搜尋程式碼、讀取檔案、執行終端機風格的工作流程。
牌組與卡片 CRUD
否，適合工程工作，不適合間隔重複內容。
Deckbase 的優勢
當模型應該新增或更新學習內容，而不是原始碼時，請使用 Deckbase MCP。

一般學習應用程式（不支援 MCP）

常見用途
在單一產品中手動建立卡片，或使用應用程式內的 AI 建立卡片。
牌組與卡片 CRUD
通常綁定在該應用程式的 UI 中，沒有標準 MCP 橋接可連到你的編輯器。
Deckbase 的優勢
提供位於 /api/mcp 的代管 HTTP MCP，包含 list_decks、get_template_schema、create_card 等工具，並支援手機同步。

Deckbase MCP

常見用途
將 Cursor、Claude Code、VS Code 與其他 MCP 用戶端連接到你的帳戶。
牌組與卡片 CRUD
是，使用你的實際範本列出及建立牌組與卡片。
Deckbase 的優勢
卡片會遵循你的範本結構描述；變更會同步到 Deckbase 網頁儀表板與手機應用程式（任何付費方案，OAuth 或 API 金鑰皆可）。

Deckbase 使用者如何透過 MCP 建立卡片

正式環境的 MCP 是代管 HTTP。請將每個請求搭配 Bearer token 傳送到下方端點：從儀表板的「連線」頁面使用 OAuth 登入，或使用 API 金鑰供指令碼使用。Basic、Pro 與 VIP 訂閱者可用任一方式連接。

POST /api/mcp
Authorization: Bearer <API_KEY>
  1. 1
    連接用戶端：在 Cursor、Claude Code、VS Code 或任何支援 MCP 的用戶端中，新增 Deckbase MCP 伺服器 URL 與 Bearer token（逐步設定）。
  2. 2
    探索結構：使用 list_decks 與 list_templates。若要查看區塊類型或 JSON 結構，請使用 list_template_block_types 或 list_block_schemas。
  3. 3
    取得範本結構描述：呼叫 get_template_schema 並傳入 templateId，以取得 create_card 中 block_text 所需的精確 blockId 鍵。
  4. 4
    建立一張或多張卡片：呼叫 create_card 或 create_cards，並提供 deckId、選填的 templateId，以及範本要求的文字欄位。
  5. 5
    隨處學習：新卡片會出現在網頁儀表板，並像手動建立的卡片一樣同步到 Deckbase 手機應用程式。
如需簡明的協定清單（工具、資源、範例），請參閱 文件中的 MCP 伺服器。

如果你的助理回報工具呼叫成功，但你在應用程式中看不到卡片，通常要先檢查 deckId 是否錯誤、blockId 是否不相符，或是否缺少範本必填欄位。在寫入操作前先執行 get_template_schema，是避免卡片寫入失敗最快的方法。

範例提示與對話

MCP 連線後，你可以用自然語言提出要求。下方區塊是真實的聊天工作階段，牌組與範本 ID 已為保護隱私而截短。

deckbase — mcp-session

# 範例提示（可貼上或自行調整）

  • $ Can you check my current decks on Deckbase?
  • $ Create a new deck called Test.
  • $ I'm learning Ukrainian — add some basic vocabulary to that deck.
  • $ Can you create a new template for Ukrainian vocabulary?

— session —

You

Can you check my current decks on Deckbase?

Assistant

You have 2 decks on Deckbase:

1. English Phrases (ID: b7ba3351…) — has a default template assigned 2. Distinction1 (ID: d80019c9…) — no default template

You

Can you create a new deck?

Assistant

What would you like to name the new deck? And optionally, a description?

You

Test

Assistant

Created! New deck "Test" (ID: 0c3cbbfb…) is ready to use.

You

I'm learning Ukrainian. Can you add some basic vocabulary to Test?

Assistant

No Ukrainian template exists yet, but an English vocabulary–style template can work well (Ukrainian on the front, English on the back). I'll check its schema first.

You

Can you create a new template for Ukrainian?

Assistant

I'll create a Ukrainian vocabulary template with: Ukrainian word, pronunciation, English meaning (hidden), and an example sentence.

Template created — Ukrainian Vocabulary (ID: c1970944…) with 4 blocks: • Ukrainian Word (header) • Pronunciation (visible) • English Meaning (hidden — revealed on flip) • Example Sentence (quote)

Now I'll add cards to your Test deck.

Assistant

Got the block IDs. Creating 10 basic Ukrainian vocabulary cards.

10 cards added to Test. Sample vocabulary:

Each card shows Ukrainian + pronunciation on the front; English meaning stays hidden until you flip; plus an example sentence. Удачі (good luck) with your studies!

UkrainianPronunciationEnglish
ПривітPryvitHello
ДякуюDyakuyuThank you
Будь ласкаBud' laskaPlease / You're welcome
ТакTakYes
НіNiNo
ВодаVodaWater
ХлібKhlibBread
Добрий деньDobryy den'Good day
До побаченняDo pobachennyaGoodbye
ВибачтеVybachteExcuse me / Sorry

需求與誠實檢查

訂閱方案

代管的牌組與卡片工具需要有效的 Basic、Pro 或 VIP 帳戶，並需具備定價頁面與儀表板頁面所述的 API 存取權。

用戶端

任何支援 HTTP 傳輸與自訂標頭的 MCP 用戶端都能運作。我們在 /mcp 說明了 Cursor、VS Code 與 Claude Code。

學習方法

MCP 會自動化建立流程；你仍需選擇牌組、範本，以及要記住的內容。

可避免牌組汙染的正式上線模式

團隊使用 MCP 時，常見的失敗原因是從成功的單張卡片示範，直接跳到大規模寫入，卻沒有品質關卡。更好的模式是分階段上線，並在每個批次大小執行明確檢查。這能降低清理成本，也能保護用於每日複習的活躍牌組。

先導測試

建議批次大小
10-25 張卡片
主要驗證目標
驗證範本對應、答案品質與牌組路由

小批次

建議批次大小
25-50 張卡片
主要驗證目標
檢查重複的題目提示與格式錯誤的背面欄位

擴大執行

建議批次大小
50-200 張卡片
主要驗證目標
追蹤失敗記錄，並只重跑失敗的資料列

在每個階段前，請維持簡單的驗收規則：抽樣卡片中至少 90% 無需手動改寫即可立即使用。如果品質低於這個水準，請暫停、修正對應規則，並只重跑失敗的記錄，而不是全部重新產生。

# minimal guardrail checklist
1) list_decks -> confirm target deckId
2) get_card_layout_schema -> validate required blockId fields
3) create_cards in small batch
4) spot-check random sample
5) scale only after acceptance threshold passes

常見問題

Deckbase MCP 與其他 MCP 伺服器有何不同？

多數 MCP 伺服器會公開文件、儲存庫或瀏覽器自動化功能。Deckbase MCP 公開的是你的單字卡庫：可用工具列出牌組與範本、取得範本結構描述，以及建立或更新會同步到 Deckbase 應用程式的卡片，而不只是聊天中的文字片段。

如何用 Deckbase MCP 建立卡片？

在 Basic、Pro 或 VIP 方案中，從儀表板的「連線」頁面使用 OAuth 登入（或使用 API 金鑰供指令碼使用），將 MCP 用戶端連接到代管端點，然後呼叫 list_templates、用 get_template_schema 取得區塊 ID，並以 deckId 與範本預期的文字欄位呼叫 create_card 或 create_cards。卡片會出現在你的單字卡庫中，並同步到手機。

Deckbase MCP 與 MCP 設定頁面是同一件事嗎？

設定頁面會顯示 Cursor、VS Code 與 Claude Code 的 JSON 設定。本指南會比較 Deckbase 與其他 MCP 模式，並帶你一步步建立卡片；技術參考文件位於「文件」→「MCP 伺服器」。

最後更新於 2026 年 3 月。產品與 API 細節可能變更；工具名稱與參數請以 MCP 伺服器文件 為準。