Dokumentation

Technische Referenz für Deckbase-Integrationen, APIs und Entwicklerleitfäden.

Referenz

Schnellstart

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

Ersetzen Sie YOUR_ACCESS_TOKEN durch ein OAuth-Token von Ihrer Seite „Verbinden“. Anweisungen zur Einrichtung finden Sie im MCP-Einrichtungsleitfaden.

API-Übersicht

Deckbase bietet zwei Integrationswege: den MCP-Server für KI-gestütztes Deck- und Kartenmanagement sowie direkte REST-API-Endpunkte für programmatischen Zugriff.

  • Erstellen, aktualisieren und löschen Sie Decks und Karten in Stapeln
  • Generieren Sie KI-Audio und KI-Bilder für Karten über ElevenLabs und Bildmodelle
  • Exportieren Sie vollständige Deck-Daten einschließlich Block-Snapshots und Metadaten
  • Erstellen Sie eigene Vorlagen mit flexiblen Block-Layouts
  • Empfangen Sie Webhook-Ereignisse für Änderungen an Decks und Karten

Hier beginnen

Best Practices

  • Behandeln Sie die Kartenerstellung als operativen Prozess

    Führen Sie Anfrageprotokolle, validieren Sie Pflichtfelder der Vorlagen vor Schreibvorgängen und prüfen Sie erzeugte Karten stichprobenartig, bevor Sie die Stapelgröße erhöhen.

  • Definieren Sie eine kanonische Vorlagenstrategie

    Definieren Sie für Teams eine kanonische Vorlagenstrategie und eine einzige Wiederholungsrichtlinie. So vermeiden Sie doppelten Prompt-Drift und reagieren bei Änderungen der Mapper-Regeln deutlich schneller.

  • Befolgen Sie die empfohlene Lesereihenfolge

    Zuerst die Einrichtungsseite, dann die MCP-Server-Referenz, danach die Produktionschecks. Dieser Weg minimiert Authentifizierungsfehler und Schema-Fehler bei der Kartenerstellung.

  • Dokumentieren Sie Regeln in Ihrem Repository

    Wenn Sie Team-Workflows umsetzen, dokumentieren Sie Ihre Vorlagenregeln und Batch-Abnahmekriterien direkt in Ihrem Repository, damit künftige Aktualisierungen konsistent bleiben.

  • Führen Sie eine wöchentliche operative Überprüfung durch

    Prüfen Sie aktuelle Schreibfehler, Vorlagen-Drift und Duplikatsraten der Prompts, bevor Sie das Automatisierungsvolumen erhöhen.

  • Versionieren Sie Ihre Integrations-Checkliste

    Halten Sie Ihre Integrations-Checkliste versioniert, damit das Onboarding neuer Mitwirkender kein Reverse Engineering früherer MCP-Einrichtungsentscheidungen erfordert.

  • Fügen Sie ein Rollback-Runbook hinzu

    Fügen Sie nach Möglichkeit ein kurzes Runbook für Rollbacks und die Nachverarbeitung fehlgeschlagener Stapel hinzu, damit Produktionsaktualisierungen auch bei weiterentwickelten Vorlagen sicher bleiben.

FAQ

  • Der Model Context Protocol (MCP)-Server ermöglicht KI-Tools wie Cursor, Claude Code und VS Code, Ihre Dokumente zu lesen, Decks aufzulisten und programmatisch Karten zu erstellen. Er nutzt standardmäßiges JSON-RPC über HTTP.

    Mehr erfahren

Leitfäden und Artikel finden Sie unter Ressourcen.