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

Sostituisci YOUR_ACCESS_TOKEN con un token OAuth della tua pagina Connect. Per le istruzioni di configurazione, consulta la guida alla configurazione MCP.

Panoramica API

Deckbase offre due percorsi di integrazione: il server MCP per la gestione di mazzi e carte assistita dall'AI e gli endpoint API REST diretti per l'accesso programmatico.

Crea, aggiorna ed elimina mazzi e carte in batch
Genera audio e immagini AI per le carte tramite ElevenLabs e modelli di immagini
Esporta i dati completi del mazzo, inclusi snapshot dei blocchi e metadati
Crea modelli personalizzati con layout di blocchi flessibili
Ricevi eventi webhook per le modifiche a mazzi e carte

Inizia da qui

Collega il tuo client MCP

Usa la guida alla configurazione per impostare Cursor, VS Code, Claude Code o un altro client compatibile MCP con l'autenticazione di Deckbase.

Verifica prima lo schema

Prima di creare carte in blocco, controlla gli schemi dei modelli e i campi obbligatori, così i record generati rimangono coerenti.

Esegui batch progressivi

Inizia con piccoli batch di scrittura, verifica un campione dei risultati e scala solo quando la qualità delle carte e il tasso di duplicati sono soddisfacenti.

Best practice

Tratta la creazione delle carte come una pipeline operativa

Mantieni i log delle richieste, valida i campi obbligatori dei modelli prima delle scritture e controlla a campione le carte generate prima di aumentare le dimensioni dei batch.

Definisci una strategia di modelli canonica unica

Per i team, definisci una strategia di modelli canonica unica e una politica di retry unica. In questo modo eviti la deriva dei prompt duplicati e la gestione degli incidenti diventa molto più rapida quando le regole di mapping cambiano.

Segui l'ordine di lettura consigliato

Prima la pagina di configurazione, poi il riferimento del server MCP, infine i controlli per il rollout in produzione. Questo percorso riduce al minimo errori di autenticazione e di schema durante la creazione delle carte.

Documenta le regole nel repository

Se stai implementando flussi di lavoro di team, documenta le regole dei modelli e i criteri di accettazione dei batch direttamente nel repository, così gli aggiornamenti futuri restano coerenti.

Fai una revisione operativa settimanale

Controlla gli errori di scrittura recenti, la deriva dei modelli e i tassi di prompt duplicati prima di aumentare il volume dell'automazione.

Versiona la checklist di integrazione

Mantieni versionata la checklist di integrazione, così l'onboarding di nuovi collaboratori non richiede di ricostruire le decisioni precedenti sulla configurazione MCP.

Includi un runbook di rollback

Quando possibile, includi un breve runbook per il rollback e il rielaborazione dei batch falliti, così gli aggiornamenti in produzione restano sicuri anche quando i modelli evolvono.

FAQ

Cos'è il server MCP di Deckbase?

Il server Model Context Protocol (MCP) consente ad strumenti AI come Cursor, Claude Code e VS Code di leggere i tuoi documenti, elencare i mazzi e creare carte in modo programmatico. Usa JSON-RPC standard su HTTP.

Serve esperienza di programmazione per usare Deckbase MCP?

No. Accedi con OAuth dalla pagina Connect della dashboard e sei a posto: interagisci tramite prompt in linguaggio naturale nel tuo strumento AI. Il server MCP gestisce i dettagli tecnici.

Quali strumenti AI supportano Deckbase MCP?

Cursor, Claude Code, VS Code con l'estensione MCP, Windsurf e qualsiasi altro client che supporti il Model Context Protocol.

L'API di Deckbase è gratuita?

L'accesso a MCP e alle API è incluso in ogni piano a pagamento: Basic, Pro e VIP. Accedi con OAuth dalla pagina Connect, dopo l'abbonamento.

Per guide e articoli, consulta Risorse