CreatioMCP社区版
用于Creatio平台开发的AI驱动MCP服务器
一种产品 ITSC |联系人：philip@itsc.md
______________________________________________________________________
什么是CreatioMCP？
CreationMCP是一个模型上下文协议（MCP）服务器，它将AI开发环境（Cursor IDE、Claude Desktop）直接连接到Creation 8.x实例，包括云和本地实例。它支持人工智能辅助开发——用自然语言驱动的自动化取代手动配置，大大缩短了Creation项目的上市时间。
所有MCP服务器处理都在您的计算机上本地运行，确保完全可审计性和数据主权。
社区版功能
社区版是 自由 并提供了开始人工智能辅助Creatio开发所需的核心能力：
环境管理
- 连接并验证到Creation 8.x实例（云端或本地）
- 基于Cookie的身份验证（社区）、OAuth 2.0（SMB+）
- 单一环境支持
- 使用延迟指标进行健康检查
- 会话生命周期管理
数据操作（只读）
- 基于OData的查询，包括过滤、分页和列选择
- 安全的只读访问——没有意外修改数据的风险
Machine Academy™
通用AI模型缺乏特定于Creation的训练数据，当被要求生成Creation代码时会产生幻觉——发明不存在的API、错误的组件名称和弃用的模式。Machine Academy通过将您的AI IDE建立在一个由官方Creation文档和平台规范精心构建的知识库中来解决这个问题，该知识库由具有多年Creation开发和部署经验的经验丰富的专业人士的实践经验丰富。它教Cursor或Claude Desktop在第一次尝试时正确编写Creation代码。
- 通过经过验证的代码示例在精心策划的实施指南中进行全文搜索
- 具有Freedom UI模式的组件目录——消除了令人产生幻觉的组件名称
- 根据Creatio 8.x API验证的处理程序模式
- 跨数据库SQL参考（MSSQL和PostgreSQL）
- 自动生成的Cursor IDE规则（.mdc文件），将Creation约定注入AI的指令中
AI生成的开发规则
- 自动生成
.cursor/rules/*.mdc符合Creation约定的文件 - Academy数据库中的动态组件目录和UI知识
快速开始
先决条件
- Node.js 20+ — 下载
- 创意8.x --具有管理员访问权限的本地实例
- 光标IDE 或 克劳德桌面版
安装
- 从下载最新版本 发布
- 提取存档
- 在提取的目录中打开终端并全局安装：
npm install -g .这登记了 creatio-mcp-server 命令在您的系统上。
设置
配置您的Creation实例：
creatio-mcp-server setup --url https://myapp.creatio.com --login admin --password pass安装向导验证连接并打印Cursor MCP配置块。
连接到IDE
选项A：光标IDE（通过设置UI）
- 打开光标设置：
Ctrl+,（Windows/Linux）或Cmd+,（macOS） - 导航至 工具和MCP
- 点击 “添加新的MCP服务器”
- 填写：
- 姓名： creatio - 类型： command - 命令： creatio-mcp-server start
- 点击 安装
- 完全重新启动Cursor （关闭并重新打开，而不仅仅是重新加载）
选项A（备选）：游标IDE（通过JSON文件）
创建或编辑 .cursor/mcp.json 在项目根目录（项目级别）中，或 ~/.cursor/mcp.json （全球）：
{
"mcpServers": {
"creatio": {
"command": "creatio-mcp-server",
"args": ["start"]
}
}
}保存后完全重新启动Cursor。
选项B：克劳德桌面
编辑Claude Desktop配置文件：
- 窗户：
%APPDATA%\Claude\claude_desktop_config.json - macOS：
~/Library/Application Support/Claude/claude_desktop_config.json
您也可以通过Claude Desktop打开它： 设置→ 开发者→ 编辑配置.
添加CreationMCP服务器：
{
"mcpServers": {
"creatio": {
"command": "creatio-mcp-server",
"args": ["start"]
}
}
}完全重新启动Claude Desktop （关闭并重新打开，而不仅仅是关闭窗口）。
连接后，您应该看到工具图标(🔨) 在聊天输入区域中。
验证连接
在IDE聊天中，键入：
“使用creatio_health_check验证我的Creation连接。”
您应该收到一个包含Creation实例状态和延迟指标的响应。
第一个查询
让AI读取数据：
“使用creatio_query_data从我的Creation实例中读取前5个联系人。”
您应该看到带有联系人记录的JSON结果。
可用工具（社区版）
| 工具 | 说明 |
|---|---|
creatio_connect | 通过身份验证连接到Creation实例 |
creatio_disconnect | 断开与Creation实例的连接 |
creatio_list_environments | 列出所有已配置的环境 |
creatio_health_check | 使用延迟指标检查Creation实例运行状况 |
creatio_query_data | 通过OData查询数据， $expand （导航设施扩建），以及 $count （总记录数） |
creatio_get_record | 通过ID检索单个记录，可选 $expand 用于导航属性 |
creatio_search_academy | 搜索Creatio知识库 |
creatio_generate_cursor_rules | 生成Cursor IDE开发规则 |
可选：学院知识库
学院知识库为Creatio开发提供人工智能辅助指导。这是可选的，但建议使用。
- 下载
academy-db.zip从 最新版本 - 提取
academy.db到data/目录（或您选择的任何位置） - 如果使用非默认位置，请设置路径：
set CREATIO_ACADEMY_DB_PATH=C:\path\to\academy.db没有学院数据库，学院搜索和学院支持的提示不可用——所有其他工具都正常工作。
配置
| 变量 | 描述 | 默认值 |
|---|---|---|
MCP_TRANSPORT | 交通方式（社区支持 stdio 仅） | stdio |
MCP_LOG_LEVEL | 日志级别： debug, info, warn, error | info |
CREATIO_DEFAULT_URL | 默认创建URL | n/a |
CREATIO_DEFAULT_LOGIN | 默认登录 | 不适用 |
CREATIO_DEFAULT_PASSWORD | 默认密码 | 不适用 |
CREATIO_DEFAULT_AUTH_TYPE | 身份验证类型(cookie) | cookie |
CREATIO_ACADEMY_DB_PATH | Academy SQLite数据库的路径 | ./data/academy.db |
故障排除
连接被拒绝
验证Creatio URL是否正确且可访问。确保生产环境使用HTTPS。检查出站连接的防火墙规则（通常是端口443）。
认证失败
确认登录名和密码。对于cookie身份验证，请确保用户具有web UI访问权限。尝试手动登录 https://your-instance/0.
无默认环境
跑 creatio-mcp-server setup 再次或使用 creatio_connect 带有url、登录名和密码参数的工具。
学院搜索返回空
学院知识库是可选的。下载 academy-db.zip 从 发布 页面，摘录 academy.db 到 data/ 目录，然后重新启动服务器。
升级到SMB或企业
CreationMCP有三个版本：
| 版本 | 关键功能 |
|---|---|
| 社区 （免费） | 连接、只读查询、学院搜索、游标规则 |
| 中小企业 （付费） | 完整的CRUD、模式管理、CI/CD、测试、安全审计、Business Bridge™ |
| 企业 （付费） | HTTP传输、无限制环境、SQL执行、DLP、高级安全、负载测试 |
有关定价和许可咨询，请联系： philip@itsc.md
需求
- Node.js 20+
- Creatio 8.x（云端或本地）
- 光标IDE（v0.40+）或克劳德桌面
安全
- 凭证加密 --所有Creatio连接凭据（URL、登录名、密码、OAuth机密）存储在
~/.creatiomcp/使用AES-256-GCM加密。加密密钥在首次运行时自动生成，并通过PBKDF2-SHA-512绑定到本地计算机——无需配置 - 文件完整性验证 --SHA-256清单检测对分布式文件的篡改
- OWASP十大合规性 --输入验证、路径净化、错误处理
- 无遥测 --没有数据收集，没有电话回家。所有处理都保留在您的机器上
许可证
根据EULA条款，社区版可免费用于个人和商业目的。
______________________________________________________________________
CreatioMCP, 机械学院，以及 商桥 是ITSC的商标。