ドキュメント

ドキュメント

Deckbaseの連携、API、開発者向けガイドの技術リファレンス。

リファレンス

MCPセットアップガイド

ガイド

Cursor、Claude Code、VS Code、Windsurf、その他のMCPクライアントをDeckbaseに接続します。

OAuthHTTP+SSEカスタムヘッダー＋その他

MCPサーバーリファレンス

リファレンス

Model Context Protocolサーバーの完全なリファレンス: エンドポイント、ツール、リソース、認証。

list_docslist_deckscreate_cardcreate_template＋その他

DeckbaseにおけるFSRS

コンセプト

Deckbaseがフリー間隔反復スケジューラ、定着率目標、日々の復習ワークフローをどう使うか。

RetentionSchedulingAnki import＋その他

間隔反復アルゴリズム

コンセプト

SM-2、ライトナー、固定間隔、FSRSがどう復習をスケジュールするか——そしてなぜDeckbaseがFSRSを使うのか。

SM-2LeitnerFixed intervals＋その他

クイックリンク

セットアップガイドAPIキー

クイックスタート

curl -X POST https://www.deckbase.co/api/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

以下を置き換えてください: YOUR_API_KEY を、あなたの ダッシュボードからのキーで置き換えてください。セットアップ手順は MCPセットアップガイド.

API概要

Deckbaseは2つの連携パスを提供します: AI支援によるデッキ・カード管理のためのMCPサーバーと、プログラムによるアクセスのための直接的なREST APIエンドポイントです。

  • デッキとカードをバッチで作成・更新・削除する
  • ElevenLabsと画像モデルを使ってカード用のAI音声・画像を生成する
  • ブロックスナップショットとメタデータを含む完全なデッキデータをエクスポートする
  • 柔軟なブロックレイアウトでカスタムテンプレートを構築する
  • デッキ・カードの変更に対するWebhookイベントを受け取る

はじめに

01

MCPクライアントを接続する

セットアップガイドを使って、Cursor、VS Code、Claude Code、その他のMCP対応クライアントをDeckbase認証で設定します。

02

まずスキーマを検証する

一括でカードを作成する前に、テンプレートスキーマと必須フィールドを確認し、生成されるレコードの一貫性を保ちます。

03

段階的なバッチを実行する

小さな書き込みバッチから始め、出力をサンプリングし、カード品質と重複率が健全であることを確認してから規模を拡大します。

ベストプラクティス

カード作成を運用パイプラインとして扱う

リクエストログを保持し、書き込み前に必須テンプレートフィールドを検証し、バッチサイズを拡大する前に生成されたカードをスポットチェックしましょう。

1つの正規テンプレート戦略を定義する

チームの場合、1つの正規テンプレート戦略と1つの再試行方針を定義しましょう。これにより重複プロンプトのずれを防ぎ、マッパールールが変わった際のインシデント対応がはるかに速くなります。

推奨される読む順序に従う

まずセットアップページ、次にMCPサーバーリファレンス、その後本番ロールアウトのチェックという順序です。この順序は、カード作成時の認証ミスやスキーマ不一致エラーを最小限に抑えます。

ルールをリポジトリに文書化する

チームのワークフローを実装している場合は、テンプレートルールとバッチ受け入れゲートを直接リポジトリに文書化し、今後の更新を一貫させましょう。

週次の運用レビューを行う

自動化の規模を拡大する前に、最近の書き込み失敗、テンプレートのずれ、重複プロンプト率を確認しましょう。

統合チェックリストをバージョン管理する

統合チェックリストをバージョン管理し、新しい貢献者のオンボーディングが過去のMCPセットアップの決定を逆算する必要がないようにしましょう。

ロールバックのランブックを含める

可能であれば、テンプレートが進化しても本番アップデートが安全であるよう、ロールバックと失敗したバッチの再処理のための簡潔なランブックを含めましょう。

よくある質問

Deckbase MCPサーバーとは何ですか？

Model Context Protocol（MCP）サーバーは、Cursor、Claude Code、VS CodeのようなAIツールが、あなたのドキュメントを読み、デッキを一覧表示し、プログラムでカードを作成できるようにします。標準的なHTTP上のJSON-RPCを使用します。

Deckbase MCPを使うのにコーディング経験は必要ですか？

APIキーとJSONの基本的な知識があると役立ちますが、主にAIツール内で自然言語のプロンプトを通じて操作します。技術的な詳細はMCPサーバーが処理します。

どのAIツールがDeckbase MCPに対応していますか？

Cursor、Claude Code、MCP拡張機能付きVS Code、Windsurf、その他Model Context Protocolに対応するあらゆるクライアントです。

Deckbase APIは無料で使えますか？

MCPとAPIアクセスはProおよびVIPサブスクリプションに含まれています。購読後、ダッシュボードからAPIキーを作成できます。

APIキーはどうやって取得しますか？

ダッシュボードのAPIキーページに移動し、「キーを作成」をクリックしてトークンをコピーしてください。Authorizationヘッダーのベアラートークンとして使用します。

ガイドや記事については リソース