ガイド・リソース

フラッシュカード用Deckbase MCP: 他と何が違うか、そしてカードの作成方法

Model Context ProtocolはAIアシスタントを外部ツールに接続します。ほとんどのMCPサーバーはドキュメントやコードを扱いますが、Deckbase MCPはあなたのアシスタントをあなたのデッキとカードに接続します。Deckbaseアプリで学習するのと同じコンテンツです。

Deckbase7分で読了

このページが存在する理由

MCP フラッシュカード、間隔反復 MCP、CursorからAnki風カードを作成を検索している場合、あなたが求めているのは2つのことです: 他のMCPパターンとの公正な比較と、エディタから実際にカードを作成する明確なワークフローです。以下にその両方があります——セットアップと技術ドキュメントへのリンク付きで。

MCPに関するほとんどのページは、プロトコルを高いレベルで説明しています。本ガイドは意図的に運用的です: アシスタントがテンプレートの制約、デッキID、同期の挙動を伴うフラッシュカードライブラリに書き込めるようになると何が変わるか。

この比較の評価方法

薄い比較コンテンツを避けるため、各MCPパターンを1つの実践的な質問で評価します: 間隔反復アプリで学習できる状態まで、デッキとカードのワークフローをエンドツーエンドで完了できるか？

  1. 1
    この比較はDeckbase製品側の視点で書かれており、一般的なMCPデモではなく実際のカード作成ワークフローに焦点を当てています。
  2. 2
    例では、学習者が実際に行うタスク——デッキの一覧表示、テンプレートスキーマの確認、モバイルに同期するカードの作成——を優先しています。
  3. 3
    参照情報は公開のMCPドキュメントと整合しており、実装の詳細を検証可能にしています。

Deckbase MCP vs 一般的なMCPサーバー

MCPはプロトコルです。どのツールを公開するかは各サーバーが決めます。DeckbaseがよくあるパターンとくらべてどうMCPに位置づけられるかを見てみましょう。

ドキュメント・ナレッジMCP

典型的な用途
チャットのコンテキスト内でwiki、Notion、社内ドキュメントを読む。
デッキ・カードCRUD
いいえ——フラッシュカードデッキを作成・同期しません。
Deckbaseの視点
Deckbase MCPはあなたのライブラリ専用に作られています: アプリに表示されるデッキ、テンプレート、カード。

リポジトリ・ファイルシステムMCP

典型的な用途
コードを検索し、ファイルを読み、ターミナル風のワークフローを実行する。
デッキ・カードCRUD
いいえ——エンジニアリング作業には優れていますが、間隔反復コンテンツには向きません。
Deckbaseの視点
モデルがソースコードではなく学習資料を追加・更新すべきときにDeckbase MCPを使いましょう。

一般的な学習アプリ（MCPなし）

典型的な用途
1つの製品内での手動またはアプリ内AIカード作成。
デッキ・カードCRUD
通常はそのアプリのUIに限定され、エディタへの標準的なMCPブリッジはありません。
Deckbaseの視点
list_decks、get_template_schema、create_cardなどのツールを備えた/api/mcpでのホスト型HTTP MCP——加えてモバイル同期。

Deckbase MCP

典型的な用途
Cursor、Claude Code、VS Code、その他のMCPクライアントをあなたのアカウントに接続する。
デッキ・カードCRUD
はい——実際のテンプレートを使ってデッキとカードを一覧表示・作成できます。
Deckbaseの視点
カードはテンプレートスキーマに従い、変更はDeckbase Webダッシュボードとモバイルアプリに同期されます（有料プラン、OAuthまたはAPIキー）。

DeckbaseユーザーがMCPを使ってカードを作成する方法

本番運用のMCPはホスト型HTTPです。各リクエストをベアラートークンとともに以下のエンドポイントへ送信してください——ダッシュボードの「接続」ページからOAuthでサインインするか、スクリプト向けにAPIキーを使用します。Basic・Pro・VIPの購読者はどちらの方法でも接続できます。

POST /api/mcp
Authorization: Bearer <API_KEY>
  1. 1
    クライアントを接続する — Cursor、Claude Code、VS Code、またはMCP対応の任意のクライアントに、Deckbase MCPサーバーのURLとベアラートークンを追加してください（ステップバイステップのセットアップ）。
  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
    1枚または複数のカードを作成する — deckId、任意でtemplateId、テンプレートが必要とするテキストフィールドを指定してcreate_cardまたはcreate_cardsを呼び出します。
  5. 5
    どこでも学習する — 新しいカードはWebダッシュボードに表示され、手動で作成したカードと同様にDeckbaseモバイルアプリに同期されます。
簡潔なプロトコル一覧（ツール、リソース、例）についてはドキュメントのMCPサーバーをご覧ください。

アシスタントがツール呼び出しの成功を返してもアプリにカードが表示されない場合、まず確認すべきなのは通常、誤ったdeckId、一致しないblockId、または必須テンプレートフィールドの欠落です。書き込み操作の前にget_template_schemaを実行することが、カード書き込み失敗を防ぐ最も速い方法です。

プロンプト例と会話

MCPが接続されると、平易な言葉で質問できます。以下のブロックは実際のチャットセッションです——プライバシーのためデッキとテンプレートのIDは省略されています。

deckbase — mcp-session

# Example prompts (paste or adapt)

  • $ Deckbaseにある現在のデッキを確認してもらえますか？
  • $ Testという新しいデッキを作成してください。
  • $ ウクライナ語を学習中です。そのデッキに基本語彙をいくつか追加してください。
  • $ ウクライナ語の語彙用に新しいテンプレートを作成してもらえますか？

— session —

You

Deckbaseにある現在のデッキを確認してもらえますか？

Assistant

Deckbaseには2つのデッキがあります:

1. English Phrases（ID: b7ba3351…）: デフォルトのテンプレートが割り当てられています 2. Distinction1（ID: d80019c9…）: デフォルトのテンプレートはありません

You

新しいデッキを作成してもらえますか？

Assistant

新しいデッキの名前は何にしますか？ 説明も任意で入力できます。

You

Test

Assistant

作成しました！新しいデッキ「Test」（ID: 0c3cbbfb…）が使用できる状態です。

You

ウクライナ語を学習しています。Testに基本語彙をいくつか追加してもらえますか？

Assistant

ウクライナ語のテンプレートはまだありませんが、英語語彙形式のテンプレートでも問題なく使える可能性があります（表にウクライナ語、裏に英語）。まずそのスキーマを確認します。

You

ウクライナ語の新しいテンプレートを作成してもらえますか？

Assistant

ウクライナ語の語彙テンプレートを次の内容で作成します: ウクライナ語の単語、発音、英語の意味（非表示）、例文。

テンプレートを作成しました: ウクライナ語語彙（ID: c1970944…）、4つのブロック付き: • ウクライナ語の単語（ヘッダー） • 発音（表示） • 英語の意味（非表示: フリップすると表示） • 例文（引用）

次に、Testデッキにカードを追加します。

Assistant

ブロックIDを取得しました。ウクライナ語の基本語彙カードを10枚作成します。

Testに10枚のカードを追加しました。語彙の例:

各カードの表にはウクライナ語と発音が表示され、英語の意味はカードをめくるまで非表示です。さらに例文も表示されます。Удачі（幸運を祈ります）。学習、がんばってください！

ウクライナ語発音英語
ПривітPryvitこんにちは
ДякуюDyakuyuありがとう
Будь ласкаBud' laskaお願いします / どういたしまして
ТакTakはい
НіNiいいえ
ВодаVoda水
ХлібKhlibパン
Добрий деньDobryy den'こんにちは
До побаченняDo pobachennyaさようなら
ВибачтеVybachteすみません / ごめんなさい

必要条件と正直な確認事項

サブスクリプション

ホスト型のデッキ/カードツールには、料金ページとダッシュボードページに記載の通り、有効なBasic・Pro・VIPのいずれかのアカウントとAPIアクセスが必要です。

クライアント

HTTPトランスポートとカスタムヘッダーをサポートするMCPクライアントであれば機能します。Cursor、VS Code、Claude Codeについては/mcpで解説しています。

教育的側面

MCPは作成を自動化しますが、どのデッキ・テンプレートを使い、何を記憶するかはあなたが選びます。

デッキの汚染を防ぐ本番ロールアウトパターン

チームは、成功した1枚のカードのデモから品質ゲートなしに大量の書き込みに一気に進んでしまい、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、ブロックID用のget_template_schema、そしてdeckIdとテンプレートが期待するテキストフィールドを指定してcreate_cardまたはcreate_cardsを呼び出します。カードはライブラリに表示され、モバイルに同期されます。

Deckbase MCPはMCPセットアップページと同じですか？

セットアップページはCursor、VS Code、Claude CodeのJSON設定を示しています。本ガイドはDeckbaseを他のMCPパターンと比較し、カードの作成手順を解説します。技術リファレンスはDocs → MCPサーバーにあります。

最終更新: 2026年3月。製品とAPIの詳細は変更される場合があります。ツール名とパラメータの正式な情報源はMCPサーバードキュメントです。