文档中心

文档

Deckbase 集成、API 与开发者指南的技术参考。

参考

快速链接

快速开始

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 令牌。有关配置说明,请参阅 MCP 配置指南.

API 概览

Deckbase 提供两种集成方式:用于 AI 辅助管理卡组和卡片的 MCP 服务器,以及用于程序化访问的直接 REST API 端点。

  • 批量创建、更新和删除卡组与卡片
  • 通过 ElevenLabs 和图像模型为卡片生成 AI 音频与图像
  • 导出包含区块快照和元数据的完整卡组数据
  • 使用灵活的区块布局构建自定义模板
  • 接收卡组和卡片变更的 webhook 事件

从这里开始

最佳实践

把卡片创建视为一条运营流水线

保留请求日志,写入前校验模板必填字段,并在扩大批量规模前抽查生成的卡片。

确定统一的模板策略

对于团队,应确定一套统一的模板策略和一套重试策略。这样可以避免提示词重复漂移,并在映射规则变化时大幅加快故障响应速度。

遵循推荐的阅读顺序

先看配置页面,再看 MCP 服务器参考,最后做生产上线检查。这条路径能最大限度减少身份验证错误和卡片创建时的 schema 不匹配问题。

在仓库中记录规则

如果你正在实施团队工作流,请直接在仓库中记录模板规则和批次验收标准,以便后续更新保持一致。

每周做一次运营复盘

在扩大自动化规模之前,检查近期的写入失败、模板漂移和提示词重复率。

为集成清单做版本管理

将集成清单纳入版本管理,这样新成员上手时无需反推此前的 MCP 配置决策。

准备回滚操作手册

在可能的情况下,附上一份简短的操作手册,用于回滚和重新处理失败批次,这样即使模板不断演进,生产更新也能保持安全。

常见问题

指南和文章请参阅 资源