Ihre KI auf unserer App: SOPs mit Claude bearbeiten

Vor einiger Zeit schrieb jemand auf LinkedIn einem Softwarehersteller sinngemäss: «Ich will nicht Ihre KI in Ihrer App. Ich will meine KI auf Ihrer App.» Der Satz trifft einen Punkt, den viele Anbieter übersehen. Wer täglich mit einem eigenen KI-Assistenten arbeitet, will nicht in jeder Software einen anderen, kleineren Assistenten bedienen. Er will, dass sein Assistent die Software bedienen kann.

Wir haben diesen Satz auf Viali selbst angewendet: Viali hat jetzt einen MCP-Server. Der erste Bereich, den er öffnet, sind die SOPs und Richtlinien einer Klinik.

Das QM-Handbuch als Ordner voller Dateien

In den meisten Kliniken ist das Qualitätsmanagement-Handbuch ein Ordner: Word-Dateien, daraus erzeugte PDFs, eine Excel-Liste mit den Versionen, dazu Kopien auf dem Laufwerk und im Mailanhang. Ändert sich eine übergeordnete Vorgabe, zum Beispiel die hausinterne Richtlinie zur Händehygiene, beginnt die Suche: Welche der vierzig Dokumente erwähnen das Thema? Welche Fassung ist die gültige? Wer hat zuletzt etwas geändert?

In Viali ist eine SOP kein Dateianhang, sondern ein digitales Dokument mit Status (Entwurf oder veröffentlicht), Versionsverlauf, Unterschriftsanfragen an das Team und einem Assistenten, der Fragen des Personals aus den veröffentlichten Richtlinien beantwortet. Das war die Grundlage. Mit dem MCP-Server kann jetzt auch ein KI-Agent mit diesen Dokumenten arbeiten, und zwar mit vielen auf einmal.

Was der MCP-Server kann

MCP (Model Context Protocol) ist ein offener Standard, über den KI-Agenten Werkzeuge anderer Programme nutzen. Viali stellt unter https://use.viali.app/mcp 12 Werkzeuge für die SOPs einer Klinik bereit:

• Lesen und finden: SOPs auflisten (nach Status, Thema oder Suchwort), eine SOP vollständig lesen, im Volltext suchen (Entwürfe eingeschlossen).
• Schreiben: eine neue SOP anlegen (immer als Entwurf), eine SOP ändern, veröffentlichen oder auf Entwurf zurücksetzen.
• Versionen: den Versionsverlauf ansehen, eine frühere Version lesen und wiederherstellen.
• Themen: Themen (Tags) setzen, alle Themen der Klinik mit ihrer Häufigkeit auflisten, ein Thema in allen SOPs umbenennen oder zwei Themen zusammenführen.

Ein Werkzeug zum Löschen gibt es bewusst nicht. Löschen bleibt eine Entscheidung, die eine Person in Viali trifft.

Ein Auftrag statt vierzig Dialoge

Das Beispiel oben zeigt einen typischen Auftrag: «Überarbeite alle Hygiene-SOPs auf die neue Händedesinfektion-Richtlinie und tagge sie mit „Hygiene".» Der Agent liest die neue Richtlinie aus einer lokalen Datei, sucht in Viali alle betroffenen SOPs, liest jede einzeln, passt den Text an und setzt das Thema. Am Ende meldet er, was er getan hat, und worauf die Klinik achten muss.

Wir nutzen das bei Viali selbst. Unser Gründer schreibt und pflegt SOPs inzwischen als Anwender über Claude Code, deutlich schneller als mit der KI im SOP-Editor («Mit KI entwerfen», «Mit KI verbessern»). Der Editor ist gut für eine einzelne Richtlinie. Für ein ganzes Handbuch ist der eigene Agent im Vorteil: Er hat die anderen Dokumente der Klinik zur Hand, er arbeitet viele SOPs in einem Durchgang ab, und der Mensch prüft das Ergebnis, statt jede Änderung selbst zu tippen.

Die Themen sind neu in Viali. Sie erscheinen in der SOP-Liste als kleine Chips und als Filter, für Administratoren und für das Personal. So findet eine Pflegefachperson alle Hygiene-Richtlinien mit einem Klick.

Nichts geht verloren

Eine Klinik kann einem Agenten nur dann Richtlinien anvertrauen, wenn jede Änderung nachvollziehbar und umkehrbar ist. Deshalb gelten für den Agenten dieselben Regeln wie in der App:

• Jede Änderung ist eine Version. Im Versionsverlauf steht der Name der Person, die den Zugang erstellt hat, mit dem Zusatz «(Claude)», zum Beispiel «Dr. Anna Keller (Claude)». Jede frühere Version lässt sich jederzeit wiederherstellen.
• Keine stillen Überschreibungen. Jede Änderung nennt die Version, auf der sie beruht. Hat eine Kollegin die SOP inzwischen in Viali geändert, lehnt Viali die Änderung ab. Der Agent liest die aktuelle Fassung neu und wendet seine Änderung darauf an.
• Neue SOPs beginnen als Entwurf. Das Personal sieht sie erst, wenn sie veröffentlicht werden.
• Unterschriften bleiben in Ihrer Hand. Das Veröffentlichen sendet keine Unterschriftsanfragen. Laufen noch Anfragen auf einer älteren Version, erhält der Agent einen Hinweis, dass diese Personen den alten Text unterschreiben.

Sicherheit: eine Klinik, nur SOPs, keine Patientendaten

• Nur SOPs. Der MCP-Server kennt keine Patienten, Termine, Rechnungen oder andere Daten. Kein Werkzeug reicht darüber hinaus, und keine andere Viali-Schnittstelle akzeptiert den Zugang.
• Eine Klinik. Jeder Zugang gehört zu genau einer Klinik.
• Persönlich und befristet. Eine Administratorin oder ein Administrator erstellt den Zugang für sich selbst. Er wird nur einmal angezeigt, gilt 30, 60 oder 90 Tage und lässt sich jederzeit widerrufen. Verliert die Person die Rolle Admin oder Manager, ist der Zugang sofort ungültig.
• Begrenzt. Höchstens 120 Anfragen pro Minute und Zugang. Ist eine Klinik wegen der Abrechnung schreibgeschützt, lehnt Viali alle Änderungen ab.

Mehr zur Datenhaltung von Viali steht auf der Seite Sicherheit.

So starten Sie

1. 1In Viali unter Admin → Integrationen, Reiter API Key, die Karte KI-Zugang (MCP) öffnen, einen Namen und die Gültigkeit wählen und Zugang erstellen klicken.
2. 2Den angezeigten Befehl einmal in einem Terminal einfügen, in dem Claude Code läuft:

claude mcp add --transport http viali https://use.viali.app/mcp --header "Authorization: Bearer vct_…"

1. 1Claude Code einen Auftrag geben, zum Beispiel: «Liste alle SOPs ohne Thema auf und schlage passende Themen vor.»

Heute verbindet sich Claude Code mit dem Zugang. Eine Verbindung für claude.ai und Claude Desktop über OAuth ist geplant. Die technische Beschreibung steht in der Viali-API-Dokumentation.

Warum wir das so bauen

Eine Software für Kliniken muss nicht jeden KI-Assistenten selbst erfinden. Sie muss ihre Daten sauber strukturiert, versioniert und sicher begrenzt bereitstellen, damit der Assistent der Klinik damit arbeiten kann. Die SOPs sind der erste Bereich. Die Regeln bleiben dieselben: klar begrenzter Zugang, jede Änderung nachvollziehbar, keine Patientendaten.

Häufige Fragen

Was ist der MCP-Server von Viali?

Ein Endpunkt unter https://use.viali.app/mcp, der das Model Context Protocol (Streamable HTTP) spricht. Über ihn kann ein KI-Agent wie Claude Code die SOPs einer Klinik auflisten, lesen, durchsuchen, anlegen, ändern, veröffentlichen, versionieren und mit Themen versehen. Es gibt 12 Werkzeuge. Ein Werkzeug zum Löschen gibt es nicht.

Sieht der KI-Agent Patientendaten?

Nein. Der Zugang gilt für eine Klinik und nur für die SOPs. Kein Werkzeug des MCP-Servers erreicht Patienten, Termine oder andere Daten, und keine andere Viali-Schnittstelle akzeptiert den Zugang.

Wer kann einen Zugang erstellen, und wie lange gilt er?

Eine Administratorin oder ein Administrator der Klinik erstellt einen persönlichen Zugang unter Admin → Integrationen, Reiter API Key, Karte KI-Zugang (MCP). Der Zugang wird nur einmal angezeigt. Er gilt 30, 60 oder 90 Tage, lässt sich jederzeit widerrufen und wird ungültig, sobald die Person die Rolle Admin oder Manager verliert.

Was passiert, wenn jemand dieselbe SOP gleichzeitig in Viali ändert?

Jede Änderung muss die Version nennen, auf der sie beruht. Hat sich die SOP inzwischen geändert, lehnt Viali die Änderung ab und nennt die aktuelle Versionsnummer. Der Agent liest dann die aktuelle Fassung neu und wendet seine Änderung darauf an. Nichts wird still überschrieben.

Mit welchen KI-Werkzeugen funktioniert das?

Heute mit Claude Code, verbunden mit einem einzigen Befehl. Eine Verbindung für claude.ai und Claude Desktop über OAuth ist geplant.