Documentación
Docs
Referencia técnica para integraciones, APIs y guías para desarrolladores de Deckbase.
Referencia
Guía de configuración de MCP
GuíaConecta Cursor, Claude Code, VS Code, Windsurf y otros clientes MCP a Deckbase.
Referencia del servidor MCP
ReferenciaReferencia completa del servidor del Model Context Protocol: endpoints, herramientas, recursos y autenticación.
FSRS en Deckbase
ConceptoCómo usa Deckbase el Free Spaced Repetition Scheduler, los objetivos de retención y el flujo de repaso diario.
Algoritmos de repetición espaciada
ConceptoCómo programan los repasos SM-2, Leitner y FSRS, y por qué FSRS es el predeterminado de Deckbase.
Enlaces rápidos
Inicio rápido
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}'Reemplaza YOUR_ACCESS_TOKEN con un token de OAuth de tu página de conexión. Para instrucciones de configuración, consulta la guía de configuración de MCP.
Descripción general de la API
Deckbase ofrece dos vías de integración: el servidor MCP para la gestión de mazos y tarjetas asistida por IA, y endpoints directos de la API REST para acceso programático.
- Crear, actualizar y eliminar mazos y tarjetas en lotes
- Generar audio e imágenes con IA para las tarjetas mediante ElevenLabs y modelos de imágenes
- Exportar datos completos del mazo, incluidas instantáneas de bloques y metadatos
- Crear plantillas personalizadas con diseños de bloques flexibles
- Recibir eventos de webhook para cambios en mazos y tarjetas
Empieza aquí
Conecta tu cliente MCP
Usa la guía de configuración para conectar Cursor, VS Code, Claude Code u otro cliente compatible con MCP con la autenticación de Deckbase.
Valida el esquema primero
Antes de crear tarjetas en masa, revisa los esquemas de plantillas y los campos obligatorios para que los registros generados sean consistentes.
Ejecuta lotes por etapas
Empieza con lotes pequeños de escritura, muestrea los resultados y escala solo cuando la calidad de las tarjetas y la tasa de duplicados se vean saludables.
Mejores prácticas
Trata la creación de tarjetas como una canalización operativa
Mantén registros de solicitudes, valida los campos obligatorios de la plantilla antes de escribir y revisa muestras de tarjetas generadas antes de aumentar el tamaño del lote.
Define una estrategia de plantilla canónica
Para equipos, define una estrategia de plantilla canónica y una política de reintentos. Esto evita la desviación de prompts duplicados y agiliza mucho la respuesta ante incidentes cuando cambian las reglas del mapeador.
Sigue el orden de lectura recomendado
Primero la página de configuración, segundo la referencia del servidor MCP y después las verificaciones para el despliegue en producción. Esta ruta minimiza los errores de autenticación y de incompatibilidad de esquemas durante la creación de tarjetas.
Documenta las reglas en tu repositorio
Si implementas flujos de trabajo en equipo, documenta las reglas de tus plantillas y los criterios de aceptación de lotes directamente en tu repositorio para que las actualizaciones futuras se mantengan consistentes.
Realiza una revisión operativa semanal
Revisa los fallos de escritura recientes, la desviación de plantillas y las tasas de prompts duplicados antes de escalar el volumen de automatización.
Versiona tu lista de verificación de integración
Mantén versionada tu lista de verificación de integración para que incorporar nuevos colaboradores no requiera reconstruir las decisiones anteriores de configuración de MCP.
Incluye un manual de reversión
Cuando sea posible, incluye un manual breve de reversión y reprocesamiento de lotes fallidos para que las actualizaciones en producción sigan siendo seguras incluso cuando las plantillas evolucionan.
Preguntas frecuentes
¿Qué es el servidor MCP de Deckbase?
El servidor del Model Context Protocol (MCP) permite que herramientas de IA como Cursor, Claude Code y VS Code lean tus documentos, listen mazos y creen tarjetas de forma programática. Usa JSON-RPC estándar sobre HTTP.
¿Necesito experiencia en programación para usar Deckbase MCP?
No. Inicia sesión con OAuth desde la página de conexión de tu panel y listo: interactúas mediante instrucciones en lenguaje natural en tu herramienta de IA. El servidor MCP se encarga de los detalles técnicos.
¿Qué herramientas de IA son compatibles con Deckbase MCP?
Cursor, Claude Code, VS Code con la extensión MCP, Windsurf y cualquier otro cliente compatible con el Model Context Protocol.
¿La API de Deckbase es gratuita?
El acceso a MCP y a la API está incluido en todos los planes de pago: Basic, Pro y VIP. Inicia sesión con OAuth desde la página de conexión una vez que estés suscrito.
Para guías y artículos, consulta Recursos