Der MCP-Server in Rillsoft Project

Welche Voraussetzungen gelten?

#

• Rillsoft Project Version 10 unter Windows; frühere Versionen haben keinen MCP-Server.
• Ein KI-Client oder ein Skript, das das Model Context Protocol über Streamable HTTP im Protokollstand 2025-06-18 spricht. Ältere Protokollstände nimmt der Server nicht an.
• Für die ersten Schritte ein mitgeliefertes Branchenbeispiel; alle Daten darin sind synthetisch.

Einrichten in drei Schritten

#

Server starten, Client auf den Endpunkt zeigen, einen lesenden Aufruf prüfen – mehr braucht der erste Kontakt nicht. Jeder Schritt lässt sich einzeln zurücknehmen, kein Schritt verändert ein Projekt.

1Server aktivieren

#

Das Startflag übersteuert die Einstellungen für die Sitzung und unterdrückt den Startbildschirm und die Rückfrage zur Autowiederherstellung, damit ein unbeaufsichtigter Start nicht an einem Dialog hängen bleibt. Die Statuszeile auf der Einstellungsseite zeigt, ob der Server läuft, per Flag läuft, blockiert ist (Port belegt, vermutlich eine zweite Instanz) oder inaktiv ist.

2Client verbinden

#

Der Endpunkt ist http://127.0.0.1:<Port>/mcp – der Pfad gilt exakt, auch /mcp/ ist ein 404. Konfiguration eines MCP-Clients:

{
  "mcpServers": {
    "rillsoft-project": {
      "type": "http",
      "url": "http://127.0.0.1:3928/mcp"
    }
  }
}

Mit gesetztem API-Key kommt eine Kopfzeile dazu:

{
  "mcpServers": {
    "rillsoft-project": {
      "type": "http",
      "url": "http://127.0.0.1:3928/mcp",
      "headers": { "Authorization": "Bearer <KEY>" }
    }
  }
}

3Erster sicherer Test

#

Ohne Initialisierung geht kein Aufruf. Drei Nachrichten genügen, und keine davon verändert das Projekt:

1. initialize – der Server vergibt eine Sitzung; die Kennung steht im Antwortkopf Mcp-Session-Id.
2. notifications/initialized – die Bestätigung schaltet die Werkzeuge frei. Ab jetzt trägt jede Anfrage Mcp-Session-Id und MCP-Protocol-Version.
3. tools/list – der Vertrag: alle Werkzeuge mit Titel, Beschreibung, Ein- und Ausgabeschema. Ein erster lesender Aufruf ist rillsoft_project_tree_get, der komplette berechnete Projektbaum.

Jede Werkzeugantwort liefert das Ergebnis doppelt: als Klartext in content[0].text und maschinenlesbar in structuredContent. Am Ende beendet ein DELETE /mcp mit der Sitzungskennung die Sitzung.

# 1. initialize – die Session-Id steht im Antwortkopf
MCP_SESSION=$(curl -s -i -X POST http://127.0.0.1:3928/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":0,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}' \
  | tr -d '\r' | awk -F': ' 'tolower($1)=="mcp-session-id"{print $2}')

# 2. ab jetzt tragen alle Aufrufe Sitzung und Protokollstand
mcp() { curl -s -X POST http://127.0.0.1:3928/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Mcp-Session-Id: $MCP_SESSION" \
  -H "MCP-Protocol-Version: 2025-06-18" -d "$1"; }

# 3. die Bestätigung schaltet die Werkzeuge frei
mcp '{"jsonrpc":"2.0","method":"notifications/initialized"}'

# der Vertrag: alle Werkzeuge mit Titel, Beschreibung, Ein- und Ausgabeschema
mcp '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

# ein erster lesender Aufruf: der komplette berechnete Projektbaum
mcp '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"rillsoft_project_tree_get","arguments":{}}}'

Wie wird der Zugriff geschützt?

#

Der API-Key ist optional. Leer bedeutet: keine Authentifizierung. Ist in den Einstellungen ein Key gesetzt, verlangt jeder Request – unabhängig vom Startweg – Authorization: Bearer <KEY>, sonst antwortet der Server mit 401. Der Vergleich läuft zeitkonstant. Nötig ist der Key auf Mehrbenutzer- und Terminalserver-Rechnern, weil 127.0.0.1 maschinenweit gilt und nicht sitzungsweit.

Was leisten Nur-Lesen-Modus und Lizenz?

#

Im Nur-Lesen-Modus zeigt tools/list genau die Werkzeuge der Zugriffsklasse nur lesend: kein Vorgang, keine Zuweisung, kein Termin, keine Datei, kein Undo-Schritt. Ändernde Aufrufe – auch Datei-, Pool- und Undo-Werkzeuge – liefern einen klaren Werkzeugfehler, ohne das Projekt anzufassen.

Einige lesende Werkzeuge verändern sichtbar etwas: die Fensterwerkzeuge nur das Fenster, die Darstellungswerkzeuge den Ansichtszustand, der mit der Projektdatei gespeichert wird (Spalten, Gliederung, Markierung). Das Projekt gilt danach als geändert. Die Beschreibung jedes dieser Werkzeuge nennt diese Wirkung.

Die meisten Werkzeuge prüfen keine Lizenz; sie stehen so weit offen wie das Dokumentmodell. Vier folgen der Lizenz wie ihr Gegenstück in der Oberfläche: die Kandidatenliste, die Assistenten „Personal zuordnen" und „Personal herausnehmen" sowie die Rollenableitung. Fehlt die Funktion in der Lizenz, liefern sie einen Fehler statt still zu arbeiten.

Was Sie sehen, sieht die KI

#

Der Kapazitätsreport rechnet nichts selbst. Er serialisiert die sichtbare, bereits berechnete Ansicht: Zeitraum aus dem Zeitfilter, Zeitraster aus der Kalenderskala, Kennzahl aus der eingestellten Darstellung. Jede Perspektive, die die KI einstellt, ist gleichzeitig auf dem Bildschirm zu sehen – und ein Strg+Z stellt Ansicht, Struktur, Zeitfilter und Darstellung gemeinsam wieder her. Dasselbe gilt für jede Mutation: Erkennt Rillsoft Project beim Abschluss einen Konflikt, rollt es selbst zurück, und das Werkzeug meldet den Grund bei unverändertem Projekt.

Ohne KI: Skripte und Integrationen

#

Nicht ein Chat-Plugin, sondern der Zugang zu Rillsoft Project als Ganzem – auch ohne KI, per Skript, mit mitgelieferten Beispieldaten. Derselbe Endpunkt lässt sich ohne KI-Assistent bedienen. Die mcp-Funktion aus dem curl-Beispiel oben ist bereits ein Skript; in PowerShell sieht ein Aufruf so aus:

$body = @'
{"jsonrpc":"2.0","id":1,"method":"tools/list"}
'@
curl.exe -s -X POST http://127.0.0.1:3928/mcp `
  -H "Content-Type: application/json" `
  -H "Mcp-Session-Id: $env:MCP_SESSION" `
  -H "MCP-Protocol-Version: 2025-06-18" -d $body

Typische Anwendungen: Abwesenheiten aus dem Urlaubssystem rollierend in den Ressourcenpool spiegeln, Kapazitäts- und Soll/Ist-Reports periodisch ziehen, Projekte aus Vorlagen erzeugen, eine Ansicht für eine Aufnahme reproduzierbar einstellen. Jedes Werkzeug beschreibt Eingabe und Ausgabe als vollständiges JSON-Schema; beide werden zur Laufzeit durchgesetzt. Feldnamen sind englisch und in beiden Richtungen gleich, sodass eine Antwort ohne Umbenennen zum nächsten Aufruf weitergereicht werden kann.

Zwei Stolperfallen beim automatisierten Start: Rillsoft Project aus PowerShell oder cmd starten, denn eine POSIX-Shell wie Git Bash schreibt das /mcp-Flag zu einem Pfad um. Und der Server lauscht erst einige Sekunden nach dem Programmstart.

Wie schnell antwortet der Server?

#

Gemessen am größten mitgelieferten Beispielprojekt des Anlagenbau-Pakets mit 650 Elementen, 637 Anordnungsbeziehungen und rund 1.500 Zuweisungen, im Debug-Build auf der Referenzmaschine:

Das Arbeiten mit einem fertigen Projekt ist unkritisch. Langsam ist allein der skriptgesteuerte Aufbau großer Projekte, weil jeder ändernde Aufruf einen vollständigen Undo-Schnappschuss anlegt; das ganze Anlagenbau-Paket mit zwölf Projekten entsteht in rund 16.700 Aufrufen.

Was gilt bei mehreren Instanzen?

#

Rillsoft Project ist eine Ein-Dokument-Anwendung: eine Instanz, ein Projekt, ein Port. Der Server bindet exklusiv an seinen Port; eine zweite Instanz auf demselben Port scheitert beim Start und meldet das in der Statuszeile. Für parallele Projekte bekommt jede Instanz einen eigenen Port (/mcp:3928, /mcp:3929, …) und im Client einen eigenen Servereintrag. Eine automatische Portsuche gibt es bewusst nicht – der Client muss wissen, welche Instanz er anspricht. Ein Projektverzeichnis oder eine Adressierung über eine Projektkennung gibt es nicht; ein Projekt wird über seinen Dateipfad geöffnet.

Wie meldet der Server Fehler?

#

Protokollfehler und fachliche Ablehnung sind getrennt: An einem Protokollfehler kann der Aufrufer nichts korrigieren, aus einer fachlichen Ablehnung baut er den zweiten Versuch.

Der Fehlertext ist der Selbstkorrekturkanal eines Agenten. Er nennt den Feldpfad, die erlaubten Werte oder das Werkzeug, das den fehlenden Zustand herstellt. Daneben steht ein stabiler englischer Fehlercode, der in der deutschen, englischen und russischen Ausgabe derselbe ist – eine Wiederholungsregel baut man auf den Code, nicht auf den Wortlaut. Höchstens 32 Sitzungen laufen gleichzeitig; JSON-RPC-Batches werden abgelehnt.

Wenn nach einem harten Programmende kein Port aufgeht: Der Dialog zur Autowiederherstellung wartet auf eine Antwort, wenn der Server über die Einstellung statt über das Flag gestartet wurde. Die Sicherungsdateien *.mbk unter %TEMP%\Rillsoft beantworten oder für Skriptläufe vorab entfernen.

Referenz: die zehn Werkzeugbereiche

#

Die sechs Karten oben fassen zusammen; vollständig decken die Werkzeuge zehn Bereiche ab – die Gliederung der Produktdokumentation. Den Vertrag je Werkzeug – Schemas, Zugriffsklassen, Fehlercodes – beschreibt die Entwicklerseite; wie ein Bereich in der Praxis aussieht, zeigen die verlinkten Beispiele.

Nächster Schritt

#

Die Prompt-Bibliothek zeigt sechzehn Fragen mit Voraussetzungen, Toolkette und Grenzen. Der Vertrag mit Schemas und Fehlercodes steht auf der Entwicklerseite. Wer zuerst sehen will, wie es sich anfühlt, beginnt mit den ersten Schritten.

Produktversion

Rillsoft Project 10

Belegstatus

Angaben aus der Produktdokumentation von Rillsoft Project 10 (Stand 08.09.2026); der Abgleich mit dem freigegebenen Build steht aus.