offgen Dokumentation

MCP

Verbinden Sie einen MCP-Client mit den Workflows Ihrer offgen-Organisation.

Über den Model Context Protocol (MCP)-Server von offgen können externe KI-Clients die Präsentationsworkflows Ihrer Organisation finden und ausführen. Die Authentifizierung ist auf die Organisation beschränkt, der der API-Schlüssel gehört.

Der MCP-Zugang wird schrittweise für freigeschaltete Organisationen bereitgestellt. Wenn auf der Seite für API-Schlüssel angezeigt wird, dass MCP noch nicht aktiviert ist, wenden Sie sich an Ihren offgen-Ansprechpartner.

API-Schlüssel erstellen

  1. Melden Sie sich bei app.offgen.ai an.
  2. Öffnen Sie Einstellungen → API-Schlüssel.
  3. Erstellen Sie einen benannten Schlüssel und wählen Sie ein Ablaufdatum.
  4. Kopieren Sie den vollständigen Schlüssel sofort. Er wird nur einmal angezeigt.

Nur Eigentümer und Administratoren einer Organisation können API-Schlüssel verwalten. Behandeln Sie einen Schlüssel wie ein Passwort: Speichern Sie ihn nicht in einem Repository, fügen Sie ihn nicht in Präsentationen ein und teilen Sie ihn nicht in Chats.

MCP-Client verbinden

Der produktive Streamable-HTTP-Endpunkt lautet:

https://api.offgen.ai/mcp

Übermitteln Sie den API-Schlüssel als Bearer-Token. Eine kompatible Client-Konfiguration sieht beispielsweise so aus:

{
  "mcpServers": {
    "offgen": {
      "type": "http",
      "url": "https://api.offgen.ai/mcp",
      "headers": {
        "Authorization": "Bearer offgen_your_key_here"
      }
    }
  }
}

Für Claude Code:

claude mcp add --transport http offgen https://api.offgen.ai/mcp --header "Authorization: Bearer offgen_your_key_here"

Verfügbare Tools

ToolZweck
list_workflowsListet die Workflows auf, die für den authentifizierten Benutzer und seine Organisation verfügbar sind.
describe_workflowGibt die erforderlichen und optionalen Eingaben eines Workflows zurück.
generate_presentationStartet die asynchrone Erstellung einer Präsentation und gibt eine Ausführungs-ID zurück.
get_resultFragt den Status einer Ausführung bis zum Abschluss oder Fehler ab und gibt Fortschritt sowie Download-URL zurück.
download_presentationÜbermittelt die fertige .pptx-Datei direkt an den MCP-Client.

Typischer Ablauf für einen KI-Agenten

  1. list_workflows aufrufen.
  2. describe_workflow mit der ID des ausgewählten Workflows aufrufen.
  3. Erforderliche Eingabewerte erfassen und validieren.
  4. generate_presentation aufrufen.
  5. get_result abfragen, bis der Status completed oder failed lautet.
  6. download_presentation aufrufen oder dem Benutzer die kurzzeitig gültige Download-URL aus get_result bereitstellen.

Widerrufen Sie einen offengelegten oder nicht mehr benötigten Schlüssel unter Einstellungen → API-Schlüssel.

Auf dieser Seite