Claude mit Rillsoft MCP verbinden

Claude verbindet sich mit dem MCP-Server im geöffneten Rillsoft Project. Sie stellen eine Frage; Claude ruft Werkzeuge auf, Rillsoft Project liefert die Planungsdaten. Diese Anleitung führt vom unverbundenen Client bis zur ersten kontrollierten Antwort. Verwenden Sie entweder Claude Code oder Claude Desktop; die Einrichtung unterscheidet sich.

Voraussetzungen und Datenfluss
#

Sie benötigen Rillsoft Project 10 unter Windows, einen installierten Claude-Client und ein geöffnetes Beispielprojekt. Für Claude Code ist mindestens Build 10.0.625 erforderlich. Der dokumentierte Client-Test vom 12.10.2026 verwendete Claude Code 2.1.296 beziehungsweise Claude Desktop 2.31226 unter Windows. Das sind Prüfstände, keine Aussage über die jeweils neueste Client-Version.

Der MCP-Endpunkt liegt auf Ihrem Rechner: http://127.0.0.1:3928/mcp. Claude Code spricht ihn direkt über Streamable HTTP an. Bei der hier geprüften Desktop-Konfiguration vermittelt das lokale Programm mcp-remote. Lokal ist der Zugang zu Rillsoft Project; der KI-Client kann die gelesenen Daten an seinen Anbieter senden. Prüfen Sie dessen Einstellungen und verwenden Sie für den Einstieg synthetische Beispieldaten. Ein Connector in einer entfernten Webanwendung erreicht diesen Loopback-Endpunkt nicht.

Noch keine Installation? Die Produktseite von Rillsoft Project beschreibt Produkt und Bezug. Eine gesonderte MCP-Lizenzzusage ergibt sich aus dieser Anleitung nicht.

1. Server starten und Beispiel öffnen
#

Öffnen Sie in Rillsoft Project Einstellungen → MCP-Server und aktivieren Sie den Server.
Lassen Sie zunächst Nur-Lesen eingeschaltet. Übernehmen Sie den Port 3928; bei einem anderen Port müssen Sie auch die Client-Konfiguration anpassen.
Ist ein API-Key eingerichtet, behalten Sie ihn bei und hinterlegen ihn im Client als Authorization: Bearer <KEY>. Die Beispiele unten zeigen die Variante ohne Key; <KEY> ist ein Platzhalter. Veröffentlichen Sie Ihren Schlüssel nicht in einer Projektkonfiguration.
Öffnen Sie über Datei → Öffnen eine Kopie des mitgelieferten Projekts „Montagelinie MX-200“ im Paket Maschinen- und Anlagenbau.

Kontrollieren Sie in den Servereinstellungen, dass der Server auf dem gewählten Port läuft. Prüfen Sie im Balkenplan den Projektnamen und die sichtbaren Phasen. So lässt sich die erste KI-Antwort einem bekannten Bestand zuordnen. Eine zweite Instanz darf denselben Port nicht belegen.

2a. Claude Code einrichten
#

Öffnen Sie ein Terminal im gewünschten Arbeitsordner. Verwenden Sie den Befehl oder den JSON-Eintrag aus derselben geprüften Konfigurationsquelle wie in „Erste Schritte“:

Terminal
claude mcp add --transport http rillsoft-project http://127.0.0.1:3928/mcp

.mcp.json · im Projektordner
{
  "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.

Voraussetzung: Rillsoft Project 10 ab Build 10.0.625 – ältere Builds lehnen den Protokollstand von Claude Code ab.

Geprüft am 12.10.2026, Claude Code 2.1.296

Starten Sie Claude Code im konfigurierten Ordner und öffnen Sie /mcp. Der Server rillsoft-project muss verbunden sein und Werkzeuge anbieten. Eine Freigabe des Servers durch Claude Code ersetzt nicht Ihre Freigabe einer späteren Projektänderung. Details zu Geltungsbereichen und HTTP-Konfiguration stehen in der offiziellen Claude-Code-Dokumentation.

2b. Claude Desktop einrichten
#

Für diese Variante benötigen Sie zusätzlich Node.js mit npx. Öffnen Sie in Claude Desktop Einstellungen → Entwickler → Konfiguration bearbeiten. Ergänzen Sie den Server in der vorhandenen Datei; erhalten Sie andere Servereinträge. Der folgende Eintrag startet eine lokale Brücke und übergibt ihr den HTTP-Endpunkt:

claude_desktop_config.json
{
  "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.

Geprüft am 12.10.2026, Claude Desktop 2.31226 (Windows)

Beenden und starten Sie Claude Desktop nach dem Speichern der Konfiguration neu. Kontrollieren Sie unter Entwickler, ob rillsoft-project verbunden ist. Der erste Start von npx kann den angegebenen, fest versionierten Helfer herunterladen. Eine Änderung der Helferversion wäre ein neuer Prüfstand.

Vorlagen mit API-Key finden Sie in den Client-Konfigurationen des Rillsoft-MCP-Repositories. Übernehmen Sie die Vorlage für Ihren Client; die Code- und Desktop-Formate sind nicht austauschbar.

3. Erste lesende Abfrage und erwartetes Ergebnis
#

Geben Sie Claude diesen Auftrag:

Lies mit rillsoft_project_tree_get das geöffnete Projekt. Nenne den Projektnamen und die obersten Teilprojekte. Lies anschließend mit rillsoft_project_conflict_list die offenen Konflikte und fasse sie nach Art zusammen. Ändere nichts und speichere nichts.

Die entsprechenden Werkzeugargumente lauten:

{"name":"rillsoft_project_tree_get","arguments":{}}
{"name":"rillsoft_project_conflict_list","arguments":{}}

Jede Zeile ist ein eigener tools/call-Parameterblock, kein JSON-RPC-Batch. Claude übernimmt den MCP-Handshake. Der Baum enthält Struktur, Namen und UUIDs; die Konfliktliste liefert die im geöffneten Plan erkannten Konflikte. Es gibt keine universelle Sollzahl von Konflikten: sie hängt von Datei, Statusdatum und Änderungen ab.

Vergleichen Sie den gemeldeten Projektnamen und die obersten Teilprojekte mit dem Balkenplan sowie die Konfliktarten mit der Konfliktliste in Rillsoft Project. Eine Antwort über ein anderes Projekt oder ohne Werkzeugaufruf ist kein erfolgreicher Verbindungstest. Die Abfrage benötigt weder Schreibzugriff noch Speichern. Erst nach dieser Kontrolle folgen fachliche Auswertungen.

Wenn die Verbindung nicht zustande kommt
#

Beobachtung	Prüfung und nächster Schritt
Verbindung abgelehnt	Rillsoft Project öffnen, Serverstatus und Port prüfen; der Listener startet erst nach dem Programmstart.
HTTP 404	Pfad genau `/mcp` verwenden; `/mcp/` ist ein anderer Pfad.
HTTP 401	API-Key in Server und passender Client-Konfiguration abgleichen; nicht den Zugriffsschutz entfernen.
HTTP 400	Bei Claude Code den Mindestbuild prüfen; Sitzung und Protokoll werden vom Client ausgehandelt.
HTTP 403	Ein Browser-`Origin` wird vom lokalen Server abgelehnt; den konfigurierten lokalen MCP-Client verwenden.
Desktop startet den Helfer nicht	Node.js/`npx`, gültiges JSON und vollständigen Neustart des Clients prüfen.
Schreibwerkzeug fehlt	Im Nur-Lesen-Modus beabsichtigt. Für diesen Verbindungstest ist es nicht nötig.

Die Referenz für Fehler, Undo und sichere Schreibzugriffe trennt Verbindungsfehler von fachlichen Ablehnungen und unklaren Schreibausgängen.

Nächste Schritte und Quellenstand
#

Prüfen Sie als Nächstes Ressourcenkapazität mit MCP oder folgen Sie den Beispielen zum Erstellen und Ändern eines Projekts an einer Kopie. Erste Schritte enthält die weiteren Clients.

Quellenstand 19.10.2026: Client-Konfigurationen und Verbindungskontrollen aus dem Prüfstand vom 12.10.2026; Werkzeugargumente aus dem generierten Katalog, Build 10.0.626. Eine aktuelle Konfigurationsprüfung ist kein erneuter Lauf aller Client-Versionen. Die Client-Blöcke oben werden aus den bestehenden Einrichtungsdaten erzeugt.

Produktversion: Rillsoft Project 10.0.625; Claude Code 2.1.296 / Desktop 2.31226
Zuletzt geprüft: 2026-10-12

Voraussetzungen und Datenfluss#

1. Server starten und Beispiel öffnen#

2a. Claude Code einrichten#

2b. Claude Desktop einrichten#

3. Erste lesende Abfrage und erwartetes Ergebnis#

Wenn die Verbindung nicht zustande kommt#

Nächste Schritte und Quellenstand#