TypingMind-Integration (Type B)

Überblick

TypingMind kann sich auf zwei Arten mit MCP-Servern verbinden:

Typ	Verbindung	Beschreibung
Type B	Native Remote-MCP-URL	Direkte HTTP-Verbindung zum MCP-Server. Kein Proxy nötig.
Type C.b	stdio-Proxy	`@typingmind/mcp` proxy leitet HTTP an stdio-Kindprozesse weiter.

Der OnlyOffice MCP Server verwendet Type B - eine direkte HTTP-Verbindung ohne Proxy. Das ist einfacher, schneller und vermeidet die Wartung eines zusätzlichen Proxy-Prozesses.

Voraussetzungen

Laufender MCP-Server unter https://<host>/mcp
TLS-Terminierung (Caddy/Nginx)
CORS_ORIGINS-Umgebungsvariable korrekt konfiguriert (siehe unten)

TypingMind konfigurieren

MCP-Verbindung im TypingMind-Admin-Panel hinzufügen

Admin → Plugins → MCP Connections → Add
URL: https://onlyoffice.<domain>/mcp
Transport: streamable-http

Verbindung testen

TypingMind sollte initialize senden und die Tool-Liste erhalten (16 Tools für den OnlyOffice MCP Server über HTTP - die 5 Storage-Tools und die 5 Anmeldeinformations-Tools sind STDIO-exklusiv, #173/#175).
Dokument generieren

Im Chat onlyoffice_generate_document aufrufen mit Template-ID, Format und Felddaten. Das generierte Dokument wird als Download-Link zurückgegeben.

CORS_ORIGINS konfigurieren

Der MCP-Server validiert den Origin-Header des Browsers gegen die CORS_ORIGINS-Umgebungsvariable. In Produktion ist dies fail-closed: ohne CORS_ORIGINS werden Browser-Anfragen mit 403 abgewiesen.

Umgebung	Wert	Verhalten
Entwicklung	`*`	Alle Origins erlaubt
Produktion	`https://mcp.<domain>,https://<tenant-domain>`	Nur gelistete Origins

Produktionskonfiguration

# .env (Docker)
CORS_ORIGINS=https://onlyoffice.worms.government.satware.ai,https://worms.government.satware.ai

Erste Origin: Die MCP-Server-Domain (für Admin UI und same-origin-Anfragen)
Zweite Origin: Die TypingMind-Tenant-Domain (für Type B Browser-Fetch)

Fehlerbehebung

Symptom	Ursache	Lösung
HTTP 403 vom MCP-Endpunkt	Origin nicht in `CORS_ORIGINS`	Tenant-Domain hinzufügen, Container neu erstellen
HTTP 403 nur im Browser, curl funktioniert	CORS greift nur für Browser	`CORS_ORIGINS` prüfen (curl sendet keinen Origin-Header)
Tools im Admin UI sichtbar, aber TypingMind kann nicht generieren	MCP-Endpunkt nicht freigegeben	`/mcp`-Pfad in Caddy-Konfiguration prüfen
`invalid_client` beim Verbinden	Falsche URL oder fehlendes TLS	URL mit `https://` und `/mcp`-Suffix verwenden

Architektur

TypingMind Browser (worms.government.satware.ai)
    |
    | POST /mcp (JSON-RPC, streamable-http)
    v
Caddy :443 (onlyoffice.worms.government.satware.ai)
    |
    v
OnlyOffice MCP Server (:3847)
    |
    v
OnlyOffice Document Server (:80)

Der @typingmind/mcp-Proxy auf Port 50880/50980 ist nicht in das OnlyOffice-Routing involviert. Er verbindet andere MCP-Server (DokuWiki, IMAP, Cortex) via stdio.