Documentação
Docs
Referência técnica para integrações, APIs e guias de desenvolvedores do Deckbase.
Referência
Guia de configuração do MCP
GuiaConecte Cursor, Claude Code, VS Code, Windsurf e outros clientes MCP ao Deckbase.
Referência do servidor MCP
ReferênciaReferência completa do servidor Model Context Protocol: endpoints, ferramentas, recursos e autenticação.
FSRS no Deckbase
ConceitoComo o Deckbase usa o Free Spaced Repetition Scheduler, metas de retenção e o fluxo diário de revisão.
Algoritmos de repetição espaçada
ConceitoComo SM-2, Leitner e FSRS agendam revisões, e por que o FSRS é o padrão do Deckbase.
Links rápidos
Início 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}'Substitua YOUR_ACCESS_TOKEN por um token OAuth da sua página Conectar. Para instruções de configuração, consulte o guia de configuração do MCP.
Visão geral da API
O Deckbase oferece dois caminhos de integração: o servidor MCP para gerenciamento de baralhos e cartões com assistência de IA, e endpoints diretos da API REST para acesso programático.
- Crie, atualize e exclua baralhos e cartões em lote
- Gere áudio e imagens com IA para cartões via ElevenLabs e modelos de imagem
- Exporte todos os dados do baralho, incluindo snapshots de blocos e metadados
- Crie modelos personalizados com layouts de blocos flexíveis
- Receba eventos de webhook para alterações em baralhos e cartões
Comece aqui
Conecte seu cliente MCP
Use o guia de configuração para configurar Cursor, VS Code, Claude Code ou outro cliente compatível com MCP usando a autenticação do Deckbase.
Valide o esquema primeiro
Antes de criar cartões em lote, inspecione os esquemas dos modelos e os campos obrigatórios para que os registros gerados permaneçam consistentes.
Execute lotes em etapas
Comece com pequenos lotes de escrita, faça amostragem dos resultados e aumente a escala somente depois que a qualidade dos cartões e a taxa de duplicatas estiverem saudáveis.
Boas práticas
Trate a criação de cartões como um pipeline operacional
Mantenha registros de solicitações, valide os campos obrigatórios dos modelos antes das gravações e faça verificações pontuais nos cartões gerados antes de aumentar o tamanho dos lotes.
Defina uma estratégia de modelo canônica
Para equipes, defina uma única estratégia canônica de modelo e uma única política de repetição. Isso evita divergências duplicadas nos prompts e acelera muito a resposta a incidentes quando as regras do mapeador mudam.
Siga a ordem de leitura recomendada
Primeiro a página de configuração, depois a referência do servidor MCP e, por fim, as verificações de implantação em produção. Esse caminho minimiza erros de autenticação e incompatibilidades de esquema durante a criação de cartões.
Documente as regras no seu repositório
Se você estiver implementando fluxos de trabalho em equipe, documente as regras dos modelos e os critérios de aceitação dos lotes diretamente no repositório para que as atualizações futuras permaneçam consistentes.
Faça uma revisão operacional semanal
Verifique falhas recentes de escrita, divergências nos modelos e taxas de prompts duplicados antes de aumentar o volume da automação.
Versione sua lista de verificação de integração
Mantenha sua lista de verificação de integração versionada para que a integração de novos colaboradores não exija engenharia reversa das decisões anteriores de configuração do MCP.
Inclua um runbook de reversão
Quando possível, inclua um breve runbook para reversão e reprocessamento de lotes com falha, para que atualizações em produção permaneçam seguras mesmo quando os modelos evoluírem.
Perguntas frequentes
O que é o servidor MCP do Deckbase?
O servidor Model Context Protocol (MCP) permite que ferramentas de IA como Cursor, Claude Code e VS Code leiam seus documentos, listem baralhos e criem cartões programaticamente. Ele usa JSON-RPC padrão sobre HTTP.
Preciso de experiência em programação para usar o MCP do Deckbase?
Não. Entre com OAuth pela página Conectar do seu painel e pronto: você interage por meio de prompts em linguagem natural na sua ferramenta de IA. O servidor MCP cuida dos detalhes técnicos.
Quais ferramentas de IA são compatíveis com o MCP do Deckbase?
Cursor, Claude Code, VS Code com a extensão MCP, Windsurf e qualquer outro cliente compatível com o Model Context Protocol.
O uso da API do Deckbase é gratuito?
O acesso ao MCP e à API está incluído em todos os planos pagos: Basic, Pro e VIP. Entre com OAuth pela página Conectar após assinar.
Para guias e artigos, consulte Recursos