# 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. Source: https://www.offgen.ai/de/docs/mcp-tools 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](/de/docs/admin/api-keys) als `Authorization: Bearer` oder `X-API-Key` · **Geltungsbereich:** eine Organisation pro Verbindung Wie Sie einen Client verbinden, steht unter [offgen in KI-Assistenten nutzen](/de/docs/mcp). 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 1. `list_workflows`, dann einen Workflow über seine `id` wählen. Namen dienen nur der Anzeige. 2. `describe_workflow`, um die Pflichtangaben zu ermitteln. Werte gegen `inputSchema` prüfen. 3. `generate_presentation` liefert sofort eine `runId`. 4. `get_result` mit dieser `runId`. Jeder Aufruf wartet bis zu 55 Sekunden. Solange `pollAgain` gleich `true` ist, mit derselben `runId` erneut aufrufen. 5. 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](/de/docs/workflows). ## Tools für Bibliotheksvorlagen Bei diesen Tools schreibt der Assistent jeden Text selbst, und offgen setzt die Folien aus den Vorlagen Ihrer [Bibliothek](/de/docs/library) zusammen. [Gesperrte Formen](/de/docs/sharepoint/import#formen-sperren) 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 1. `search_templates` mit dem, was die Folie zeigen soll, zum Beispiel „Teamübersicht mit Fotos“. 2. `get_template` für die Kandidaten, um Felder und Vorschauen zu sehen. 3. `compose_deck` mit Text und Bildern für jede `shapeId`. Mit `layoutOf` entsteht eine neue Folie auf dem Layout einer Vorlage. 4. Jede Vorschau prüfen. Für Korrekturen `compose_deck` erneut mit der ganzen Präsentation aufrufen. 5. 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 1. `upload_presentation` mit der `.pptx`-Datei. 2. `onboard_templates` mit der `uploadId`. Der Aufruf darf wiederholt werden: Bereits vorhandene Folien kommen als `existing` zurück. 3. 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](/de/docs/admin/members). ## 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` | ## Verwandte Seiten * [offgen in KI-Assistenten nutzen (MCP)](/de/docs/mcp): Einrichtung der Clients und Fehlerbehebung * [Workflow erstellen](/de/docs/workflows): was `list_workflows` zurückgibt * [Vorlagenbibliothek](/de/docs/library): wo `search_templates` sucht * [offgen für Entwickler](/de/developers) auf offgen.ai