Documentation

Docs

Référence technique pour les intégrations, les API et les guides développeurs de Deckbase.

Référence

Guide de configuration MCP

Guide

Connectez Cursor, Claude Code, VS Code, Windsurf et d'autres clients MCP à Deckbase.

OAuthHTTP+SSEEn-têtes personnalisés+ plus

Référence du serveur MCP

Référence

Référence complète du serveur Model Context Protocol : points d'accès, outils, ressources et authentification.

list_docslist_deckscreate_cardcreate_template+ plus

FSRS dans Deckbase

Concept

Comment Deckbase utilise le Free Spaced Repetition Scheduler, les objectifs de rétention et le flux de révision quotidienne.

RétentionPlanificationImport Anki+ plus

Algorithmes de répétition espacée

Concept

Comment SM-2, Leitner et FSRS planifient les révisions, et pourquoi FSRS est le choix par défaut de Deckbase.

SM-2LeitnerÉtapes de révision+ plus

Liens rapides

Guide de configuration

Démarrage rapide

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}'

Remplacez YOUR_ACCESS_TOKEN par un jeton OAuth depuis votre page de connexion. Pour les instructions de configuration, consultez le guide de configuration MCP.

Présentation de l'API

Deckbase propose deux modes d'intégration : le serveur MCP pour la gestion de decks et de cartes assistée par IA, et des points d'accès directs à l’API REST pour un accès programmatique.

  • Créez, mettez à jour et supprimez des decks et des cartes par lots
  • Générez de l'audio IA et des images pour les cartes via ElevenLabs et des modèles d'image
  • Exportez les données complètes d'un deck, y compris les instantanés de blocs et les métadonnées
  • Créez des modèles personnalisés avec des mises en page de blocs flexibles
  • Recevez des événements webhook pour les modifications de decks et de cartes

Commencez ici

01

Connectez votre client MCP

Utilisez le guide de configuration pour paramétrer Cursor, VS Code, Claude Code ou un autre client compatible MCP avec l'authentification Deckbase.

02

Validez d'abord le schéma

Avant de créer des cartes en masse, examinez les schémas de modèles et les champs requis afin que les enregistrements générés restent cohérents.

03

Exécutez des lots par étapes

Commencez par de petits lots d'écriture, échantillonnez les résultats, et augmentez le volume uniquement lorsque la qualité des cartes et le taux de doublons semblent satisfaisants.

Bonnes pratiques

Traitez la création de cartes comme un pipeline opérationnel

Conservez les journaux de requêtes, validez les champs requis des modèles avant l'écriture, et vérifiez un échantillon de cartes générées avant d'augmenter la taille des lots.

Définissez une stratégie de modèle unique et de référence

Pour les équipes, définissez une stratégie de modèle unique et de référence, ainsi qu'une politique de nouvelle tentative unique. Cela évite la dérive des invites en doublons et accélère considérablement la gestion des incidents lorsque les règles de mappage changent.

Respectez l'ordre de lecture recommandé

La page de configuration d'abord, la référence du serveur MCP ensuite, puis les vérifications avant déploiement en production. Ce parcours minimise les erreurs d'authentification et d'incompatibilité de schéma lors de la création de cartes.

Documentez les règles dans votre dépôt

Si vous mettez en place des flux de travail d'équipe, documentez vos règles de modèles et vos critères d'acceptation des lots directement dans votre dépôt afin que les futures mises à jour restent cohérentes.

Effectuez une revue opérationnelle hebdomadaire

Vérifiez les échecs d'écriture récents, la dérive des modèles et les taux d'invites en doublons avant d'augmenter le volume d'automatisation.

Versionnez votre liste de contrôle d'intégration

Maintenez votre liste de contrôle d'intégration sous versionnement afin que l'intégration de nouveaux contributeurs ne nécessite pas de reconstituer les décisions de configuration MCP antérieures.

Incluez un runbook de retour en arrière

Dans la mesure du possible, incluez un runbook court pour le retour en arrière et le retraitement des lots en échec, afin que les mises à jour en production restent sûres même lorsque les modèles évoluent.

FAQ

Qu'est-ce que le serveur MCP Deckbase ?

Le serveur Model Context Protocol (MCP) permet aux outils d'IA comme Cursor, Claude Code et VS Code de lire vos documents, lister vos decks et créer des cartes de manière programmatique. Il utilise le JSON-RPC standard sur HTTP.

Ai-je besoin d'expérience en programmation pour utiliser le MCP Deckbase ?

Non. Connectez-vous avec OAuth depuis la page de connexion de votre tableau de bord et c'est prêt : vous interagissez par des invites en langage naturel dans votre outil d'IA. Le serveur MCP gère les détails techniques.

Quels outils d'IA prennent en charge le MCP Deckbase ?

Cursor, Claude Code, VS Code avec l'extension MCP, Windsurf, et tout autre client qui prend en charge le Model Context Protocol.

L'API Deckbase est-elle gratuite ?

L'accès MCP et API est inclus dans chaque offre payante : Basic, Pro et VIP. Connectez-vous avec OAuth depuis la page de connexion, une fois abonné.

Pour les guides et les articles, consultez Ressources