Fünf Schritte, jeder mit einer Kontrolle. Sie benötigen ein installiertes Rillsoft Project 10 und einen passenden KI-Client. Der MCP-Server läuft lokal im geöffneten Programm. Ihr KI-Client kann die bereitgestellten Projektdaten an seinen Anbieter übertragen; dafür gelten seine Einstellungen und Bedingungen. Die Einrichtung unten nennt den Prüfstand je Client.
Wenn Sie Rillsoft Project noch nicht einsetzen: Informationen zum Produkt finden Sie auf der Seite Rillsoft Project.
1. MCP-Server aktivieren#
Öffnen Sie in Rillsoft Project Einstellungen → MCP-Server, setzen Sie den
Aktiv-Schalter und lassen Sie den Nur-Lesen-Modus für den Anfang
eingeschaltet. Der Port bleibt auf dem Standard 3928, der API-Key leer.
Kontrolle: Die Statuszeile auf derselben Seite zeigt „läuft auf Port 3928“. Zeigt sie „aktiviert, aber blockiert“, belegt eine zweite Instanz den Port – dann schließen Sie sie oder tragen einen anderen Port ein.
2. Ein Branchenbeispiel öffnen#
Öffnen Sie über Datei → Öffnen aus den mitgelieferten Beispielen das
Leitprojekt des Maschinenbau-Pakets: Ordner 02_maschinenbau, Projekt
„Montagelinie MX-200“ – 60 Personen in sieben Teams, vier Projekte und eine
Grundlast im Paket. Alle Personen, Firmen und Termine darin sind synthetisch,
Sie können nichts kaputt machen – und im Nur-Lesen-Modus ohnehin nichts
ändern.
Kontrolle: Der Balkenplan zeigt das Projekt mit seinen Phasen von der Auftragsklärung bis zum Projektabschluss.
3. KI-Client verbinden#
Für Claude führt die eigene Schritt-für-Schritt-Anleitung durch Code- und Desktop-Einrichtung bis zur ersten lesenden Abfrage.
Wählen Sie Ihren Client und übernehmen Sie Befehl oder Konfiguration. Jeder Eintrag nennt, wo die Datei liegt, wie Sie die Verbindung prüfen und wann wir ihn zuletzt im Programm geprüft haben.
http://127.0.0.1:3928/mcpKI-Client wählen
Claude Code
claude mcp add --transport http rillsoft-project http://127.0.0.1:3928/mcp{
"mcpServers": {
"rillsoft-project": {
"type": "http",
"url": "http://127.0.0.1:3928/mcp"
}
}
}Der Befehl schreibt den Eintrag für den aktuellen Ordner; mit --scope user gilt er überall. Kontrolle in der Sitzung mit /mcp.
Claude Desktop
{
"mcpServers": {
"rillsoft-project": {
"command": "npx",
"args": ["-y", "[email protected]", "http://127.0.0.1:3928/mcp"]
}
}
}Claude Desktop startet lokale Server nur als Programm; die Brücke mcp-remote reicht die Anfragen an Rillsoft Project weiter und braucht Node.js. Die Datei öffnen Sie über Einstellungen → Entwickler → Konfiguration bearbeiten; danach Claude Desktop neu starten. Kontrolle: Unter Entwickler steht rillsoft-project als verbunden.
Codex
codex mcp add rillsoft-project --url http://127.0.0.1:3928/mcp[mcp_servers.rillsoft-project]
url = "http://127.0.0.1:3928/mcp"Der Befehl schreibt genau diesen Abschnitt in die Datei; Sie können ihn auch von Hand eintragen. Kontrolle in der Sitzung mit /mcp.
VS Code
{
"servers": {
"rillsoft-project": {
"type": "http",
"url": "http://127.0.0.1:3928/mcp"
}
}
}Oder in der Befehlspalette MCP: Add Server und HTTP wählen. Kontrolle: MCP: List Servers zeigt rillsoft-project als gestartet, die Ausgabe nennt die gefundenen Werkzeuge.
Cursor
{
"mcpServers": {
"rillsoft-project": {
"url": "http://127.0.0.1:3928/mcp"
}
}
}Für nur ein Projekt die Datei .cursor/mcp.json im Projektordner verwenden. Kontrolle: Settings → MCP zeigt rillsoft-project mit seinen Werkzeugen.
Andere Clients
{
"mcpServers": {
"rillsoft-project": {
"type": "http",
"url": "http://127.0.0.1:3928/mcp"
}
}
}Jeder Client, der das Model Context Protocol über Streamable HTTP spricht, verbindet sich mit dieser Adresse; die Feldnamen nennt die Dokumentation Ihres Clients. Webanwendungen wie claude.ai oder ChatGPT erreichen einen Server auf Ihrem Rechner nicht.
Mit API-Key ergänzt der Client die Kopfzeile Authorization: Bearer <KEY>; Vorlagen dafür stehen auf GitHub.
Kontrolle: Der Client listet die Werkzeuge des Servers auf – im
Nur-Lesen-Modus nur die lesenden. Bleibt die Liste leer, prüfen Sie Port und
Pfad: /mcp gilt exakt, /mcp/ ist ein 404.
4. Die erste Frage stellen#
Stellen Sie im Client die Frage:
Fasse den aktuellen Projektstatus zusammen: Termine, Fortschritt, offene Konflikte, in fünf Absätzen.
Kontrolle: Die Antwort nennt den Projektnamen, den Zeitraum und die Phasen aus dem Balkenplan und keine Angaben, die nicht im Projekt stehen. Verlangt der Client eine Bestätigung je Werkzeugaufruf, sehen Sie dabei, dass er nur lesende Werkzeuge verwendet. Weitere Fragen stehen in der Prompt-Bibliothek.
5. Ändern und mit Strg+Z zurücknehmen#
Schalten Sie in den Einstellungen den Nur-Lesen-Modus aus und stellen Sie eine ändernde Frage:
Verschiebe die Fördertechnik-Montage um zwei Wochen nach hinten und zeig mir, wie sich die Kapazitätsansicht der Industriemechanik ändert.
Sehen Sie in Rillsoft Project zu: Der Vorgang wandert, die Folgetermine wandern mit, die Kapazitätsansicht wechselt. Drücken Sie danach in Rillsoft Project Strg+Z.
Kontrolle: Der Balkenplan springt auf den Ausgangsstand zurück. Jeder ändernde Aufruf der KI ist ein normaler Bearbeitungsschritt – Sie nehmen ihn zurück wie jeden eigenen. Der Unterschied zum Verschieben eines Datums von Hand: Rillsoft Project rechnet Folgetermine und Kapazität nach – die KI hat nur den Auftrag gegeben.
Wenn es hakt#
| Symptom | Ursache und Abhilfe |
|---|---|
Client meldet 400 | Sitzung oder Protokollstand fehlt in der Anfrage – der Client muss initialize senden und danach Mcp-Session-Id und MCP-Protocol-Version: 2025-06-18 mitschicken |
Client meldet 401 | In den Einstellungen ist ein API-Key gesetzt; der Client braucht Authorization: Bearer <KEY> |
Client meldet 403 | Die Anfrage trägt einen Origin-Header, wie ihn Browser senden; der Server lehnt das ab. Einen MCP-Client statt einer Browserseite verwenden |
| kein Port nach einem Absturz | Der Dialog zur Autowiederherstellung wartet auf eine Antwort. Ihn beantworten oder Rillsoft Project mit RillPrj.exe /mcp starten |
| Server lauscht nicht sofort | Er startet einige Sekunden nach dem Programmstart; kurz warten |
| Start aus einem Skript schlägt fehl | Rillsoft Project aus PowerShell oder cmd starten – Git Bash schreibt das /mcp-Flag zu einem Pfad um |
Danach#
Die MCP-Seite erklärt Server, Zugriffsschutz und Skripte ohne KI, die Entwicklerseite den Vertrag mit Schemas und Fehlercodes. Die Beispiele zeigen drei Fälle Schritt für Schritt an den ausgelieferten Branchenpaketen.
- 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.