Zum Inhalt springen
satware® AI OnlyOffice MCP

Schnellstart

Voraussetzungen

Abschnitt betitelt „Voraussetzungen“

Schließen Sie zuerst den Leitfaden Installation ab. Sie benötigen:

  • Einen laufenden OnlyOffice Document Server-Container
  • Einen gebauten MCP-Server (npm run build)
  • Einen MCP-Client (oder curl zum Testen)

Dokument generieren

Abschnitt betitelt „Dokument generieren“

  1. MCP-Server starten

    Für den HTTP-Modus (einfacher mit curl zu testen):

    Terminal window
    npm run start:server

    Überprüfen Sie, ob er läuft:

    Terminal window
    curl -f http://localhost:3847/health

  2. Verfügbare Vorlagen auflisten

    Terminal window
    curl -X POST http://localhost:3847/mcp \
      -H "Content-Type: application/json" \
      -H "Accept: application/json, text/event-stream" \
      -d '{
        "jsonrpc": "2.0",
        "id": 1,
        "method": "tools/call",
        "params": {
          "name": "onlyoffice_list_templates",
          "arguments": {}
        }
      }'

    Dies gibt 5 generische Vorlagen zurück.

  3. Stellenbeschreibung generieren

    Terminal window
    curl -X POST http://localhost:3847/mcp \
      -H "Content-Type: application/json" \
      -H "Accept: application/json, text/event-stream" \
      -d '{
        "jsonrpc": "2.0",
        "id": 2,
        "method": "tools/call",
        "params": {
          "name": "onlyoffice_generate_document",
          "arguments": {
            "template": "stellenbeschreibung",
            "format": "docx",
            "data": {
              "Positionstitel": "Software Engineer",
              "Fachbereich": "IT",
              "Abteilung": "Development",
              "Standort": "Berlin",
              "Datum": "06.07.2026",
              "Arbeitsverhaeltnis": "Vollzeit",
              "Stellenziel": "Develop and maintain software applications",
              "Hauptaufgaben": ["Code development", "Code review", "Testing"],
              "Nebenaufgaben": ["Documentation", "Team meetings"]
            }
          }
        }
      }'

    Die Antwort enthält das generierte Dokument als Base64-Daten oder als Download-URL (abhängig von der ARTIFACTS_BASE_URL-Konfiguration).

  4. MCP-Client verbinden

    Für lokale Clients (Claude Desktop, Cline) verwenden Sie den STDIO-Modus:

    {
      "mcpServers": {
        "onlyoffice": {
          "command": "node",
          "args": ["dist/index.js"],
          "cwd": "/path/to/onlyoffice"
        }
      }
    }

    Für Remote-Clients (opencode, TypingMind) verwenden Sie den HTTP-Modus:

    {
      "mcp": {
        "onlyoffice": {
          "type": "remote",
          "url": "https://onlyoffice.localhost/mcp"
        }
      }
    }

Verfügbare Vorlagen

Abschnitt betitelt „Verfügbare Vorlagen“
Vorlage Format Beschreibung
stellenbeschreibung DOCX/PDF Stellenbeschreibung (HR)
dienstliches_schreiben DOCX/PDF Amtliches Schreiben
beschlussvorlage DOCX/PDF Beschlussvorlage
praesentation PPTX/PDF Professionelle Präsentation
bericht XLSX/PDF Tabellarischer Bericht mit Formeln
Siehe die Vorlagen-Referenz für vollständige Schema-Details.

Nächste Schritte

Abschnitt betitelt „Nächste Schritte“