Dokumentacja

Dokumentacja

Dokumentacja techniczna integracji, API i przewodników dla programistów Deckbase.

Referencja

Przewodnik konfiguracji MCP

Przewodnik

Połącz Cursor, Claude Code, VS Code, Windsurf i innych klientów MCP z Deckbase.

OAuthHTTP+SSENiestandardowe nagłówki+ więcej

Referencja serwera MCP

Referencja

Pełna referencja serwera Model Context Protocol: endpointy, narzędzia, zasoby i uwierzytelnianie.

list_docslist_deckscreate_cardcreate_template+ więcej

FSRS w Deckbase

Koncepcja

Jak Deckbase wykorzystuje Free Spaced Repetition Scheduler, cele retencji i codzienny przebieg powtórek.

RetencjaPlanowanieImport z Anki+ więcej

Algorytmy powtórek rozłożonych w czasie

Koncepcja

Jak SM-2, Leitner i FSRS planują powtórki oraz dlaczego FSRS jest domyślnym algorytmem w Deckbase.

SM-2LeitnerKroki powtórek+ więcej

Szybkie linki

Przewodnik konfiguracji

Szybki start

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

Zastąp YOUR_ACCESS_TOKEN tokenem OAuth ze strony Połączenia. Instrukcje konfiguracji znajdziesz w przewodniku konfiguracji MCP.

Przegląd API

Deckbase oferuje dwie ścieżki integracji: serwer MCP do zarządzania taliami i kartami z pomocą AI oraz bezpośrednie endpointy REST API do dostępu programistycznego.

  • Tworzenie, aktualizowanie i usuwanie talii oraz kart partiami
  • Generowanie dźwięku i obrazów AI dla kart przez ElevenLabs i modele obrazów
  • Eksport pełnych danych talii, w tym migawek bloków i metadanych
  • Tworzenie własnych szablonów z elastycznym układem bloków
  • Odbieranie zdarzeń webhook o zmianach w taliach i kartach

Zacznij tutaj

01

Połącz swojego klienta MCP

Skorzystaj z przewodnika konfiguracji, aby skonfigurować Cursor, VS Code, Claude Code lub innego klienta zgodnego z MCP z uwierzytelnianiem Deckbase.

02

Najpierw sprawdź schemat

Zanim zaczniesz tworzyć karty hurtowo, przejrzyj schematy szablonów i wymagane pola, aby generowane rekordy były spójne.

03

Uruchamiaj partie etapami

Zacznij od małych partii zapisu, sprawdzaj próbki wyników i zwiększaj skalę dopiero wtedy, gdy jakość kart i odsetek duplikatów wyglądają dobrze.

Dobre praktyki

Traktuj tworzenie kart jak operacyjny potok

Zachowuj logi żądań, sprawdzaj wymagane pola szablonu przed zapisem i losowo weryfikuj wygenerowane karty, zanim zwiększysz rozmiar partii.

Zdefiniuj jedną kanoniczną strategię szablonów

W zespołach zdefiniuj jedną kanoniczną strategię szablonów i jedną politykę ponawiania. Pozwala to uniknąć dryfu zduplikowanych promptów i znacznie przyspiesza reakcję na incydenty, gdy zmieniają się reguły mapowania.

Trzymaj się zalecanej kolejności czytania

Najpierw strona konfiguracji, potem referencja serwera MCP, a na końcu kontrole przed wdrożeniem produkcyjnym. Ta ścieżka ogranicza błędy uwierzytelniania i niezgodności schematu podczas tworzenia kart.

Dokumentuj reguły w swoim repozytorium

Jeśli wdrażasz zespołowe przepływy pracy, opisz reguły szablonów i kryteria akceptacji partii bezpośrednio w repozytorium, aby przyszłe zmiany pozostały spójne.

Rób cotygodniowy przegląd operacyjny

Sprawdzaj ostatnie błędy zapisu, dryf szablonów i odsetek zduplikowanych promptów, zanim zwiększysz skalę automatyzacji.

Wersjonuj swoją listę kontrolną integracji

Wersjonuj listę kontrolną integracji, aby wdrażanie nowych współpracowników nie wymagało odtwarzania wcześniejszych decyzji dotyczących konfiguracji MCP.

Dołącz instrukcję wycofywania zmian

Jeśli to możliwe, przygotuj krótką instrukcję wycofywania zmian i ponownego przetwarzania nieudanych partii, aby aktualizacje produkcyjne pozostały bezpieczne, nawet gdy szablony się zmieniają.

FAQ

Czym jest serwer MCP Deckbase?

Serwer Model Context Protocol (MCP) pozwala narzędziom AI, takim jak Cursor, Claude Code i VS Code, czytać Twoją dokumentację, wyświetlać talie i tworzyć karty programowo. Wykorzystuje standardowy JSON-RPC przez HTTP.

Czy potrzebuję doświadczenia w programowaniu, żeby korzystać z Deckbase MCP?

Nie. Zaloguj się przez OAuth na stronie Połączenia w swoim panelu i gotowe: komunikujesz się w języku naturalnym w swoim narzędziu AI. Szczegółami technicznymi zajmuje się serwer MCP.

Które narzędzia AI obsługują Deckbase MCP?

Cursor, Claude Code, VS Code z rozszerzeniem MCP, Windsurf oraz każdy inny klient obsługujący Model Context Protocol.

Czy API Deckbase jest darmowe?

Dostęp do MCP i API jest zawarty w każdym płatnym planie: Basic, Pro i VIP. Po wykupieniu subskrypcji zaloguj się przez OAuth na stronie Połączenia.

Przewodniki i artykuły znajdziesz tutaj: Zasoby