指南 · 资源

用于抽认卡的 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 或内部文档。
牌组与卡片增删改查
不能。它们不会创建或同步抽认卡牌组。
Deckbase 的定位
Deckbase MCP 专为你的卡片库打造：牌组、模板和卡片都会显示在应用中。

代码仓库与文件系统类 MCP

典型用途
搜索代码、读取文件、运行终端式工作流。
牌组与卡片增删改查
不能。它们适合工程工作，不适合间隔重复内容。
Deckbase 的定位
当模型需要添加或更新学习材料而不是源代码时，请使用 Deckbase MCP。

通用学习应用（无 MCP）

典型用途
在单一产品内手动创建卡片或使用应用内 AI 创建卡片。
牌组与卡片增删改查
通常局限于该应用的界面，没有连接到编辑器的标准 MCP 桥接。
Deckbase 的定位
在 /api/mcp 提供托管式 HTTP MCP，包含 list_decks、get_template_schema、create_card 等工具，并支持移动端同步。

Deckbase MCP

典型用途
将 Cursor、Claude Code、VS Code 和其他 MCP 客户端连接到你的账户。
牌组与卡片增删改查
可以，使用你的实际模板列出和创建牌组与卡片。
Deckbase 的定位
卡片遵循你的模板架构；更改会同步到 Deckbase 网页仪表板和移动应用（任何付费方案，OAuth 或 API 密钥）。

Deckbase 用户如何使用 MCP 创建卡片

生产环境 MCP 是托管式 HTTP。请使用 Bearer 令牌将每个请求发送到下方端点；可从仪表板的“连接”页面通过 OAuth 登录，或在脚本中使用 API 密钥。Basic、Pro 和 VIP 订阅者可通过任一方式连接。

POST /api/mcp
Authorization: Bearer <API_KEY>
  1. 1
    连接客户端：在 Cursor、Claude Code、VS Code 或任何兼容 MCP 的客户端中添加 Deckbase MCP 服务器 URL 和 Bearer 令牌（分步设置）。
  2. 2
    了解结构：使用 list_decks 和 list_templates。如需了解块类型或 JSON 结构，请使用 list_template_block_types 或 list_block_schemas。
  3. 3
    获取模板架构：使用 templateId 调用 get_template_schema，以获取 create_card 中 block_text 所需的准确 blockId 键。
  4. 4
    创建一张或多张卡片：使用 deckId、可选的 templateId 以及模板要求的文本字段调用 create_card 或 create_cards。
  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 服务器文档。