Документация

Документация

Технический справочник по интеграциям Deckbase, API и руководствам для разработчиков.

Справочник

Руководство по настройке MCP

Руководство

Подключи Cursor, Claude Code, VS Code, Windsurf и другие MCP-клиенты к Deckbase.

OAuthHTTP+SSEПользовательские заголовки+ ещё

Справочник по MCP-серверу

Справочник

Полный справочник по серверу Model Context Protocol: эндпоинты, инструменты, ресурсы и аутентификация.

list_docslist_deckscreate_cardcreate_template+ ещё

FSRS в Deckbase

Концепция

Как Deckbase использует Free Spaced Repetition Scheduler, целевые показатели удержания и ежедневный процесс повторений.

УдержаниеПланированиеИмпорт из Anki+ ещё

Алгоритмы интервального повторения

Концепция

Как SM-2, Leitner и FSRS планируют повторения и почему FSRS выбран в Deckbase по умолчанию.

SM-2LeitnerШаги повторения+ ещё

Быстрые ссылки

Руководство по настройке

Быстрый старт

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

Замени YOUR_ACCESS_TOKEN на OAuth-токен с твоей страницы Connect. Инструкции по настройке смотри в руководстве по настройке MCP.

Обзор API

Deckbase предлагает два пути интеграции: MCP-сервер для управления колодами и карточками с помощью ИИ и прямые эндпоинты REST API для программного доступа.

  • Создание, обновление и удаление колод и карточек пакетами
  • Генерация ИИ-аудио и изображений для карточек через ElevenLabs и модели изображений
  • Экспорт полных данных колоды, включая снимки блоков и метаданные
  • Создание пользовательских шаблонов с гибкой компоновкой блоков
  • Получение событий вебхуков об изменениях колод и карточек

С чего начать

01

Подключи свой MCP-клиент

Используй руководство по настройке, чтобы настроить Cursor, VS Code, Claude Code или другой MCP-совместимый клиент с аутентификацией Deckbase.

02

Сначала проверь схему

Перед массовым созданием карточек проверь схемы шаблонов и обязательные поля, чтобы создаваемые записи оставались согласованными.

03

Запускай пакеты поэтапно

Начни с небольших пакетов записи и проверки образцов результатов, а масштабируй только после того, как качество карточек и доля дублей будут в норме.

Лучшие практики

Относись к созданию карточек как к операционному конвейеру

Веди журналы запросов, проверяй обязательные поля шаблона перед записью и выборочно проверяй созданные карточки перед увеличением размера пакета.

Определи одну каноническую стратегию шаблонов

Для команд определи одну каноническую стратегию шаблонов и одну политику повторных попыток. Это помогает избежать дублирования и дрейфа промптов и значительно ускоряет реакцию на инциденты при изменении правил маппинга.

Соблюдай рекомендуемый порядок чтения

Сначала страница настройки, затем справочник по MCP-серверу, потом проверки перед запуском в продакшене. Этот путь сводит к минимуму ошибки аутентификации и несоответствия схем при создании карточек.

Документируй правила в своём репозитории

Если ты внедряешь командные процессы, документируй правила шаблонов и критерии приёмки пакетов прямо в своём репозитории, чтобы будущие обновления оставались согласованными.

Проводи еженедельный операционный обзор

Проверяй недавние сбои записи, дрейф шаблонов и долю дублирующихся промптов перед масштабированием автоматизации.

Версионируй свой чек-лист интеграции

Веди версии чек-листа интеграции, чтобы новым участникам не приходилось восстанавливать предыдущие решения по настройке MCP методом обратной разработки.

Добавь инструкцию по откату

Когда это возможно, добавляй краткую инструкцию по откату и повторной обработке неудачных пакетов, чтобы обновления в продакшене оставались безопасными даже при изменении шаблонов.

Частые вопросы

Что такое MCP-сервер Deckbase?

Сервер Model Context Protocol (MCP) позволяет таким ИИ-инструментам, как Cursor, Claude Code и VS Code, читать твои документы, получать список колод и программно создавать карточки. Он использует стандартный JSON-RPC поверх HTTP.

Нужен ли опыт программирования для использования MCP Deckbase?

Нет. Войди через OAuth со страницы Connect в своей панели управления, и всё готово: ты работаешь через промпты на естественном языке в своём ИИ-инструменте. Технические детали берёт на себя MCP-сервер.

Какие ИИ-инструменты поддерживают MCP Deckbase?

Cursor, Claude Code, VS Code с расширением MCP, Windsurf и любой другой клиент, поддерживающий Model Context Protocol.

API Deckbase бесплатен?

Доступ к MCP и API включён во все платные тарифы: Basic, Pro и VIP. После подписки войди через OAuth со страницы Connect.

Руководства и статьи смотри в разделе Ресурсы