Dokumentation

Dokumentation

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

Referenz

Schnellzugriff

Schnellstart

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

Leitfäden und Artikel finden Sie unter Ressourcen