說明文件
文件
Deckbase 整合、API 與開發人員指南的技術參考資料。
參考
MCP 設定指南
指南將 Cursor、Claude Code、VS Code、Windsurf 及其他 MCP 用戶端連線至 Deckbase。
MCP 伺服器參考
參考Model Context Protocol 伺服器的完整參考：端點、工具、資源與驗證。
Deckbase 中的 FSRS
概念Deckbase 如何使用免費間隔重複排程器、保留率目標與每日複習流程。
間隔重複演算法
概念SM-2、Leitner 與 FSRS 如何安排複習，以及為何 FSRS 是 Deckbase 的預設演算法。
快速連結
快速開始
curl -X POST https://www.deckbase.co/api/mcp \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","method":"tools/list","id":1}'將 YOUR_ACCESS_TOKEN 替換為你的 OAuth 權杖，來源為 Connect 頁面。如需設定說明，請參閱 MCP 設定指南.
API 概覽
Deckbase 提供兩種整合方式：用於 AI 輔助牌組與卡片管理的 MCP 伺服器，以及可直接以程式存取的 REST API 端點。
- 批次建立、更新與刪除牌組和卡片
- 透過 ElevenLabs 與圖像模型為卡片生成 AI 音訊和圖片
- 匯出完整牌組資料，包括區塊快照與中繼資料
- 使用彈性的區塊版面配置建立自訂範本
- 接收牌組與卡片變更的 Webhook 事件
從這裡開始
最佳實務
將卡片建立視為營運流程
保留請求記錄、寫入前驗證範本必填欄位，並在擴大批次規模前抽查產生的卡片。
定義單一標準範本策略
對團隊而言，請定義單一標準範本策略與單一重試政策。這可避免重複的提示詞漂移，並在對應規則變更時大幅加快事件應變速度。
遵循建議的閱讀順序
先閱讀設定頁面，其次為 MCP 伺服器參考，最後再進行正式上線檢查。此順序可將驗證錯誤與卡片建立期間的結構描述不符問題降到最低。
在儲存庫中記錄規則
若你正在實作團隊工作流程，請直接在儲存庫中記錄範本規則與批次驗收門檻，讓後續更新保持一致。
每週進行營運檢視
在擴大自動化量之前，檢查近期的寫入失敗、範本漂移與重複提示詞比率。
為整合檢查清單建立版本
為整合檢查清單建立版本控管，讓新進貢獻者不必反向推敲先前的 MCP 設定決策。
加入復原執行手冊
情況允許時，加入簡短的復原與失敗批次重新處理執行手冊，讓範本演進時正式環境更新仍保持安全。
常見問題
什麼是 Deckbase MCP 伺服器？
Model Context Protocol（MCP）伺服器可讓 Cursor、Claude Code、VS Code 等 AI 工具以程式方式讀取你的文件、列出牌組並建立卡片。它透過 HTTP 使用標準 JSON-RPC。
使用 Deckbase MCP 需要寫程式經驗嗎？
不需要。從儀表板的 Connect 頁面以 OAuth 登入即可，你會在 AI 工具中透過自然語言提示進行互動。技術細節由 MCP 伺服器處理。
哪些 AI 工具支援 Deckbase MCP？
Cursor、Claude Code、安裝 MCP 擴充功能的 VS Code、Windsurf，以及任何支援 Model Context Protocol 的其他用戶端。
Deckbase API 可免費使用嗎？
MCP 與 API 存取已包含在所有付費方案中：Basic、Pro 與 VIP。訂閱後，請從 Connect 頁面以 OAuth 登入。
如需指南與文章，請參閱 資源