ガイド・リソース
フラッシュカード用Deckbase MCP: 他と何が違うか、そしてカードの作成方法
Model Context ProtocolはAIアシスタントを外部ツールに接続します。ほとんどのMCPサーバーはドキュメントやコードを扱いますが、Deckbase MCPはあなたのアシスタントをあなたのデッキとカードに接続します。Deckbaseアプリで学習するのと同じコンテンツです。
このページが存在する理由
MCP フラッシュカード、間隔反復 MCP、CursorからAnki風カードを作成を検索している場合、あなたが求めているのは2つのことです: 他のMCPパターンとの公正な比較と、エディタから実際にカードを作成する明確なワークフローです。以下にその両方があります——セットアップと技術ドキュメントへのリンク付きで。
MCPに関するほとんどのページは、プロトコルを高いレベルで説明しています。本ガイドは意図的に運用的です: アシスタントがテンプレートの制約、デッキID、同期の挙動を伴うフラッシュカードライブラリに書き込めるようになると何が変わるか。
この比較の評価方法
薄い比較コンテンツを避けるため、各MCPパターンを1つの実践的な質問で評価します: 間隔反復アプリで学習できる状態まで、デッキとカードのワークフローをエンドツーエンドで完了できるか？
- 1この比較はDeckbase製品側の視点で書かれており、一般的なMCPデモではなく実際のカード作成ワークフローに焦点を当てています。
- 2例では、学習者が実際に行うタスク——デッキの一覧表示、テンプレートスキーマの確認、モバイルに同期するカードの作成——を優先しています。
- 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ダッシュボードとモバイルアプリに同期されます（Pro/VIP、APIキー）。
DeckbaseユーザーがMCPを使ってカードを作成する方法
本番運用のMCPはホスト型HTTPです。各リクエストをベアラートークン（ダッシュボードのAPIキー、または有効な場合はOAuthアクセストークン）とともに以下のエンドポイントへ送信してください。ProおよびVIP購読者はダッシュボードでAPIキーを作成できます。
POST /api/mcp
Authorization: Bearer <API_KEY>- 1クライアントを接続する —
Cursor、Claude Code、VS Code、またはMCP対応の任意のクライアントに、Deckbase MCPサーバーのURLとベアラートークンを追加してください（ステップバイステップのセットアップ）。 - 2構造を確認する —
list_decksとlist_templatesを使いましょう。ブロックタイプやJSON形式については、list_template_block_typesやlist_block_schemasを使ってください。 - 3テンプレートスキーマを取得する —
templateIdを指定してget_template_schemaを呼び出し、create_cardのblock_textに使う正確なblockIdキーを取得します。 - 41枚または複数のカードを作成する —
deckId、任意でtemplateId、テンプレートが必要とするテキストフィールドを指定してcreate_cardまたはcreate_cardsを呼び出します。 - 5どこでも学習する — 新しいカードはWebダッシュボードに表示され、手動で作成したカードと同様にDeckbaseモバイルアプリに同期されます。
アシスタントがツール呼び出しの成功を返してもアプリにカードが表示されない場合、まず確認すべきなのは通常、誤ったdeckId、一致しないblockId、または必須テンプレートフィールドの欠落です。書き込み操作の前にget_template_schemaを実行することが、カード書き込み失敗を防ぐ最も速い方法です。
プロンプト例と会話
MCPが接続されると、平易な言葉で質問できます。以下のブロックは実際のチャットセッションです——プライバシーのためデッキとテンプレートのIDは省略されています。
# Example prompts (paste or adapt)
- $ 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!
| Ukrainian | Pronunciation | English |
|---|---|---|
| Привіт | Pryvit | Hello |
| Дякую | Dyakuyu | Thank you |
| Будь ласка | Bud' laska | Please / You're welcome |
| Так | Tak | Yes |
| Ні | Ni | No |
| Вода | Voda | Water |
| Хліб | Khlib | Bread |
| Добрий день | Dobryy den' | Good day |
| До побачення | Do pobachennya | Goodbye |
| Вибачте | Vybachte | Excuse me / Sorry |
必要条件と正直な確認事項
ホスト型のデッキ/カードツールには、料金ページとダッシュボードページに記載の通り、有効な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_template_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サーバーと何が違いますか？
Deckbase MCPでカードを作成するにはどうすればよいですか？
Deckbase MCPはMCPセットアップページと同じですか？
最終更新: 2026年3月。製品とAPIの詳細は変更される場合があります。ツール名とパラメータの正式な情報源はMCPサーバードキュメントです。