MCP-Tool-Referenz

Schlagen Sie die 10 Tools des offgen-MCP-Servers nach, ihre Ein- und Ausgaben und die Reihenfolge, in der Assistenten sie aufrufen.

Der MCP-Server von offgen hat 10 Tools: 5 für Workflows und 5 für Bibliotheksvorlagen. Ihr Assistent wählt und ruft sie selbst auf. Diese Seite brauchen Sie, wenn Sie eine Integration bauen oder nachvollziehen möchten, was ein Assistent getan hat.

Endpunkt: https://api.offgen.ai/mcp (Streamable HTTP, zustandslos) · Anmeldung: mit offgen (OAuth) oder mit einem offgen_-API-Schlüssel als Authorization: Bearer oder X-API-Key · Geltungsbereich: eine Organisation pro Verbindung

Wie Sie einen Client verbinden, steht unter offgen in KI-Assistenten nutzen. Der öffentliche Server unter https://www.offgen.ai/mcp ist ein anderer: Er liest nur Produktinformationen zu offgen und kann keine Präsentationen erstellen.

Workflow-Tools

Tool	Eingaben	Rückgabe
`list_workflows`	keine	Die Workflows, die Sie ausführen können: `id`, `name`, `description`. Gibt es keine, ist `emptyReason` gleich `no_runnable_workflows`.
`describe_workflow`	`workflowId`	Die `inputs` des Workflows (Name, Bezeichnung, Typ, Pflichtfeld, erlaubte Werte) und ein JSON-Schema `inputSchema`. Datumswerte im Format `YYYY-MM-DD`.
`generate_presentation`	`workflowId`, `inputs` (Schlüssel wie die Eigenschaften in `inputSchema`)	Eine `runId` mit dem Status `queued`. Ungültige Eingaben ergeben einen Fehler, und es startet kein Lauf.
`get_result`	`runId`	`status` (`queued`, `running`, `completed` oder `failed`), `slidesEmitted`, `pollAgain` und `error`. Nach Abschluss der Download-Link.
`download_presentation`	`runId`	Der Download-Link eines abgeschlossenen Laufs, derselbe, den `get_result` liefert. Bleibt für ältere Integrationen erhalten.

Aus einem Workflow erstellen

list_workflows, dann einen Workflow über seine id wählen. Namen dienen nur der Anzeige.
describe_workflow, um die Pflichtangaben zu ermitteln. Werte gegen inputSchema prüfen.
generate_presentation liefert sofort eine runId.
get_result mit dieser runId. Jeder Aufruf wartet bis zu 55 Sekunden. Solange pollAgain gleich true ist, mit derselben runId erneut aufrufen.
Lautet der Status completed, liefert get_result den Download-Link. Geben Sie ihn an die Person weiter. download_presentation ist nicht nötig.

Die Workflows sind die, die Ihre Organisation in offgen anlegt. Siehe Workflow erstellen.

Tools für Bibliotheksvorlagen

Bei diesen Tools schreibt der Assistent jeden Text selbst, und offgen setzt die Folien aus den Vorlagen Ihrer Bibliothek zusammen. Gesperrte Formen behalten ihren Inhalt.

Tool	Eingaben	Rückgabe
`search_templates`	`query` (optional, jede Sprache), `limit` (1 bis 25, Standard 10)	Passende Vorlagen mit `templateId`, `name`, `description`, `masterName`, `space` und der Zahl der Text- und Bildfelder. Ohne Suchbegriff die neuesten Vorlagen.
`get_template`	`templateIds` (1 bis 10), `waitForAnalysis` (optional, wartet bis zu 40 Sekunden)	Die Analyse jeder Vorlage durch offgen, ihre Felder (`shapeId`, Art, Rolle, Hinweise, aktueller Text, gesperrt), die Platzhalter ihres Layouts, ein Vorschaubild und Links zur Vorschau und zur `.pptx`.
`compose_deck`	`slides` (1 bis 20), jeweils mit `templateId` oder `layoutOf`, dazu `text`, `remove` und `images` mit `shapeId` als Schlüssel	Eine `.pptx`: Download-Link, eine Vorschau pro Folie und das Ergebnis der Dateiprüfung.
`upload_presentation`	`base64` (unter 4 MB) oder nichts; `kind`: `pptx`, `png` oder `jpeg`	Eine `uploadId`. Ohne `base64` eine Upload-URL und einen fertigen `curl`-Befehl zum Senden der Datei.
`onboard_templates`	`uploadId`, `slideNumbers` (optional, bis zu 30 pro Aufruf), `space` (`organization` oder `my`, Standard `organization`)	Eine Vorlage pro Folie mit `templateId` und dem Status `created` oder `existing`.

Präsentation aus Vorlagen bauen

search_templates mit dem, was die Folie zeigen soll, zum Beispiel „Teamübersicht mit Fotos“.
get_template für die Kandidaten, um Felder und Vorschauen zu sehen.
compose_deck mit Text und Bildern für jede shapeId. Mit layoutOf entsteht eine neue Folie auf dem Layout einer Vorlage.
Jede Vorschau prüfen. Für Korrekturen compose_deck erneut mit der ganzen Präsentation aufrufen.
Den Download-Link an die Person weitergeben.

Für Bilder laden Sie zuerst ein PNG oder JPEG mit upload_presentation hoch und tragen dann dessen uploadId in images ein.

Folien als Vorlagen hinzufügen

upload_presentation mit der .pptx-Datei.
onboard_templates mit der uploadId. Der Aufruf darf wiederholt werden: Bereits vorhandene Folien kommen als existing zurück.
offgen benennt und analysiert jede neue Vorlage in 1 bis 3 Minuten. Rufen Sie get_template mit waitForAnalysis: true auf, bis die Analyse fertig ist.

Für den Bereich organization brauchen Sie die Rolle Inhaber oder Admin. Mit my landen die Vorlagen in Ihrer persönlichen Bibliothek (Meine). Siehe Nutzer, Teams und Rollen.

Download-Links

Kein Tool liefert Dateiinhalte. Eine fertige Präsentation kommt als MCP-resource_link, als Markdown-Link und mit den Feldern downloadUrl, suggestedFileName und mimeType.
Der Link enthält ein kurzlebiges Token für genau diese Präsentation. Ein Browser öffnet ihn daher ohne Anmeldung. Ist er abgelaufen, rufen Sie das Tool erneut auf und erhalten einen neuen Link.
Clients mit einer MCP-Version vor 2025-06-18 erhalten dieselben Felder als JSON-Text.

Fehler und Grenzen

Ein Tool-Fehler kommt mit isError und einer Meldung, die den nächsten Schritt nennt, zum Beispiel bei einer unbekannten runId oder einem noch laufenden Lauf.
Fehlende oder ungültige Zugangsdaten ergeben 401 mit einem WWW-Authenticate-Header, damit OAuth-Clients die Anmeldung starten können. Ruft ein Client nach dem Verlust des Zugangs ein Tool auf, etwa mit einem widerrufenen Schlüssel oder bei inaktivem Abonnement, nennt die Meldung die Ursache.

Grenze	Wert
Direkter Upload (`base64`)	unter 4 MB; größere Dateien über die Upload-URL
Größe einer Präsentation	150 MB
Folien pro Aufruf von `onboard_templates`	30; für den Rest erneut aufrufen
Folien pro Aufruf von `compose_deck`	20
Bilder	PNG oder JPEG, je bis zu 10 MB, 10 verschiedene Bilder pro Aufruf von `compose_deck`