↓ Skip to main content
Rillsoft AI
Connect Rillsoft

Rillsoft AI

Get started

Five steps to the first answer: enable the MCP server, open an example, connect your AI client, ask the first question, try Ctrl+Z – each with a success check.

Five steps, each with a check that shows it worked. You need an installed Rillsoft Project 10 and an AI client that speaks the Model Context Protocol over HTTP. Everything runs on your machine; nothing is sent to Rillsoft.

If you do not use Rillsoft Project yet: product information is on the Rillsoft Project page.

1. Enable the MCP server
#

In Rillsoft Project open Settings → MCP server, set the active switch and leave read-only mode switched on for now. The port stays at the default 3928, the API key stays empty.

Check: The status line on the same page shows “running on port 3928”. If it shows “enabled but blocked”, a second instance occupies the port – close it or enter another port.

2. Open an industry example
#

Via File → Open choose from the shipped examples the lead project of the mechanical engineering package: folder 02_maschinenbau, project “Montagelinie MX-200” (assembly line MX-200; the shipped sample data is in German) – 60 people in seven teams, four projects and a base load in the package. All people, companies and dates in it are synthetic, you cannot break anything – and in read-only mode you cannot change anything anyway.

Check: The Gantt chart shows the project with its phases from order clarification to project closure.

3. Connect your AI client
#

Enter the server in your client:

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

The format follows the MCP specification; field names may differ per client – your client’s documentation is authoritative. We have verified the connection with Claude and Codex.

Check: The client lists the server’s tools – in read-only mode only the read-only ones. If the list stays empty, check port and path: /mcp is exact, /mcp/ is a 404.

4. Ask the first question
#

Ask in the client:

Summarize the current project status: dates, progress, open conflicts, in five paragraphs.

Check: The answer names the project name, the period and the phases from the Gantt chart and nothing that is not in the project. If the client asks for confirmation per tool call, you see that it uses read-only tools only. More questions are in the prompt library.

5. Change and take it back with Ctrl+Z
#

Switch read-only mode off in the settings and ask a mutating question:

Move the task “Fördertechnik-Montage” (conveyor assembly) two weeks later and show me how the capacity view for industrial mechanics changes.

Watch Rillsoft Project: the task moves, the follow-on dates move with it, the capacity view changes. Then press Ctrl+Z in Rillsoft Project.

Check: The Gantt chart jumps back to the starting state. Every mutating call by the AI is an ordinary editing step – you take it back like any of your own. The difference to moving a date by hand: Rillsoft Project recalculates follow-on dates and capacity – the AI only gave the instruction.

If something is stuck
#

SymptomCause and remedy
client reports 400session or protocol revision missing in the request – the client must send initialize and then include Mcp-Session-Id and MCP-Protocol-Version: 2025-06-18
client reports 401an API key is set in the settings; the client needs Authorization: Bearer <KEY>
client reports 403the request carries an Origin header as browsers send it; the server rejects that. Use an MCP client, not a browser page
no port after a crashthe auto-recovery dialog is waiting for an answer. Answer it or start Rillsoft Project with RillPrj.exe /mcp
server does not listen immediatelyit starts a few seconds after the program; wait briefly
start from a script failsstart Rillsoft Project from PowerShell or cmd – Git Bash rewrites the /mcp flag into a path

Afterwards
#

The MCP page explains server, access protection and scripts without AI, the developers page the contract with schemas and error codes. The examples show three cases step by step on the shipped industry packages.

Product version
Rillsoft Project 10
Verification
Details from the Rillsoft Project 10 product documentation (as of 2026-09-08); reconciliation with the released build is pending.