Rillsoft Project

Rillsoft Project MCP 服务

德语

Rillsoft AI 是连接 Rillsoft Project 的 AI 网关。Rillsoft Project 是面向中型工业企业的专业解决方案，用于多项目资源和产能规划：它是内置于 Rillsoft Project 10 中、基于其排程引擎构建的 MCP 服务，而不是基于任务列表构建的。

该服务在 Windows 上已启动且可见的 Rillsoft Project 中运行，并通过 Model Context Protocol 向 AI 助手或脚本开放当前项目：项目结构和计划、角色、人员、团队、机器和材料、候选人搜索和人员配置助手、产能分析、基准计划和计划/实际对比、进度和状态日期、资源池、撤销和重做。

本仓库包含文档、客户端配置和 npm 启动器（launcher.js，参见通过 npx 安装）。 服务本身是 Rillsoft Project 10 桌面应用的一部分；启动器只负责转发请求，且没有托管端点。

完整文档：https://rillsoft.ai/en/mcp/

概览

端点	http://127.0.0.1:3928/mcp
协议	基于 Streamable HTTP 的 MCP，修订版 2025-06-18
可访问范围	仅限 127.0.0.1——没有云服务，不会向 Rillsoft 发送任何内容
要求	Windows 上的 Rillsoft Project 10
访问保护	可选 API 密钥、只读模式、拒绝浏览器来源
权衡	MCP 调用不携带用户身份，且只会连接到一个 Rillsoft Project 实例

它不是什么

• 不是任务、待办事项或看板工具，也不是聊天、维基或团队协作平台。
• 不是独立的 AI 产品或聊天插件，而是面向整个 Rillsoft Project 的 AI 访问入口——产品、版本和价格请参见 www.rillsoft.com。
• 不是会自行排程的 AI：Rillsoft Project 负责计算日期、工作量和关键路径；AI 负责读取结果。
• 不是云服务：该服务仅在已打开的 Rillsoft Project 内通过 127.0.0.1 访问。Rillsoft 不会发送任何内容；AI 客户端发送的内容受其提供商隐私政策约束。
• 不是团队服务：不支持远程访问。
• 不是组合编辑器：可以打开并评估组合，但不能更改。

设置

1. 启用服务。 在 Rillsoft Project 中打开 设置 → MCP 服务， 打开启用开关，并暂时保持只读模式开启。 或者，启动 RillPrj.exe /mcp（端口 3928）或 RillPrj.exe /mcp:8123（其他端口），仅用于一个会话。 **检查：**状态栏显示“正在端口 3928 上运行”。

2. 连接 AI 客户端，使用 clients/generic.json：

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

   如果已在设置中配置 API 密钥，请使用 clients/generic-api-key.json （Authorization: Bearer <KEY>）。各客户端的现成配置：

   客户端	文件	放置位置	已验证
   Claude Code	claude-code.mcp.json	项目文件夹中的 .mcp.json，或 claude mcp add --transport http rillsoft-project http://127.0.0.1:3928/mcp	2026 年 10 月 12 日，2.1.296
   Claude Desktop	claude-desktop.json	claude_desktop_config.json（设置 → 开发者 → 编辑配置）；桥接程序 mcp-remote 需要 Node.js	2026 年 10 月 12 日，2.31226
   Codex	codex.toml	~/.codex/config.toml，或 codex mcp add rillsoft-project --url http://127.0.0.1:3928/mcp	2026 年 10 月 12 日，CLI 0.162
   VS Code	vscode.mcp.json	.vscode/mcp.json	2026 年 10 月 12 日，1.117
   Cursor	cursor.mcp.json	~/.cursor/mcp.json	请参阅供应商文档

   Claude Code 和 VS Code 需要 Rillsoft Project 10 build 10.0.625 或更高版本。 任何其他支持通过 Streamable HTTP 使用 MCP 的客户端都可以使用上述地址；具体字段名称请参阅其文档。 **检查：**客户端会列出服务的工具——只读模式下仅显示只读工具。/mcp 是准确路径，/mcp/ 会返回 404。

3. 提出第一个问题，例如：用五段话概述当前项目状态：日期、进度、未解决的冲突。 附带的合成数据行业示例可供试用，无需使用你自己的项目。

每个修改操作在 Rillsoft Project 中都会成为一个普通的撤销步骤——与撤销你自己的编辑一样，按 Ctrl+Z 即可撤销。

分步指南及成功检查：开始使用。

通过 npx 安装（启动器）

对于目录、注册表以及只能启动 stdio 服务的客户端，我们提供了一个基于此仓库构建的 npm 包 @rillsoft/rillsoft-project-mcp。 它是启动器，而不是服务：

• Rillsoft Project 10 正在运行时，它会将每个请求通过 stdio 转发到端点 http://127.0.0.1:3928/mcp。地址固定；没有用于设置地址的环境变量，也不需要 API 密钥。如果 Rillsoft Project 中设置了 API 密钥，启动器会报告 401——请改用上面的 HTTP 配置。仅用于诊断时，RILLSOFT_MCP_LOG=<file> 会将会话中的请求和响应写入日志文件。
• Rillsoft Project 未运行时（程序未运行或系统不是 Windows），它会根据 tools-list.json 自行响应 initialize 和 tools/list——与程序相同的 118 个工具；对于每个 tools/call，则返回 isError: true 和提示信息。这样目录就能在 Linux 上显示这些工具。

{
  "mcpServers": {
    "rillsoft-project": {
      "command": "npx",
      "args": ["-y", "@rillsoft/rillsoft-project-mcp"]
    }
  }
}

需要 Node.js 18 或更高版本；只有在 Windows 上运行 Rillsoft Project 10 时才能获得实际结果。客户无需使用启动器：以上配置可直接连接正在运行的程序。

安装为 Claude 插件

此仓库也是 Claude Code 和 Cowork 的插件（.claude-plugin/）。 在 Claude Code 中：

/plugin install rillsoft-project --marketplace rillsoft/rillsoft-project-mcp

此插件在你的计算机上执行的操作：

• 启动一个本地 MCP 服务：node ${CLAUDE_PLUGIN_ROOT}/launcher.js （Node.js 18 或更高版本），与上方 npm 包使用同一个启动器。
• 启动器只与 http://127.0.0.1:3928/mcp 通信，也就是在同一台计算机上运行的 Rillsoft Project 10 的 MCP 端点。它不会向其他任何地方发送数据，不会收集遥测数据，不需要账户或 API 密钥。
• 如果 Rillsoft Project 未运行，启动器会读取插件文件夹中的 tools-list.json 并列出工具；之后每次调用工具都会返回提示，而非结果。
• 只有在你自行设置 RILLSOFT_MCP_LOG=<file> 时，它才会写入日志文件。

与其他 MCP 服务一样，你的 AI 客户端会将工具返回的项目数据发送给其服务提供商。本地插件服务可在 Claude Code 和 Cowork 中运行；Claude Desktop 中的聊天功能会忽略它们——请在那里使用“设置”下的配置。

如果遇到问题

现象	原因和解决方法
400	缺少会话或协议版本——发送 initialize，然后附上 Mcp-Session-Id 和 MCP-Protocol-Version: 2025-06-18
401	设置了 API 密钥；客户端需要 Authorization: Bearer <KEY>
403	请求携带了浏览器发送的 Origin 标头；请使用 MCP 客户端，而不是浏览器页面
崩溃后没有端口	自动恢复对话框正在等待响应；请进行处理，或启动 RillPrj.exe /mcp
服务未立即监听	程序启动几秒后，服务才会启动

工具目录和规范

工具名称带有前缀 rillsoft_，在所有语言版本中均为英文；参数、结果字段、枚举值和错误代码保持不变，消息则遵循正在运行的 Rillsoft Project 所用的语言。关于 tools/list、架构、错误、撤销、只读模式和会话的工作方式，请参阅：开发者：MCP 服务规范。

完整的工具目录包含 Rillsoft Project 10.0.626.0 的 118 个工具，以及标题、访问类别、参数和说明，详见 TOOLS.md。该目录由正在运行的程序通过 scripts/generate_tools.py 从 tools/list 生成，不会手动编辑；包含输出架构在内的原始结果见 tools-list.json。

链接

• MCP 服务：https://rillsoft.ai/en/mcp/
• 入门指南：https://rillsoft.ai/en/get-started/
• 开发者：https://rillsoft.ai/en/developers/
• 提示词库：https://rillsoft.ai/en/prompts/
• 产品：https://www.rillsoft.com/mcp-server/
• 官方 MCP 注册表：ai.rillsoft/rillsoft-project（条目）

提供商

Rillsoft GmbH，德国莱昂贝格——提供进度安排、资源和多项目规划软件。Rillsoft Project 是专有软件；此仓库包含其 MCP 文档和启动器。

许可证

此仓库中的文档和工具目录采用 CC BY 4.0 许可；启动器代码（launcher.js）采用 MIT License 许可。Rillsoft Project 本身（包括其 MCP 服务）是 Rillsoft GmbH 的专有软件，不受上述任一许可证约束。