@ cmssy/ mcp- 服务器

MCP 服务器 阴道,一个主机无头CMS 与内置商务。 让一个AI代理在一个Cmsy工作空间中与页面,记录,媒体,表格,产品,订单,退款以及折扣一起工作.

主机服务器( 未安装)

https://api.cmssy.io/mcp 在HTTP上提供同样的工具。 Claude(网络,桌面,代码)和Codex通过签名连接到cmsy. 一个请求服务器 URL 和 API 密钥的客户端 - v0, 可爱的, 博尔特 或您自己的 - 发送一个 cs_ 代号 :

URL:    https://api.cmssy.io/mcp
Header: Authorization: Bearer cs_YOUR_TOKEN

一个瞄准一个工作空间的符号只到达那个工作空间;一个没有瞄准的符号到达你所属的每一个工作空间. 每个工具都需要一个 workspace (单位:千美元)<orgSlug>/<workspaceSlug>),以及 list_workspaces 指定标志可能使用的名称。 它与你在每个工作区的角色一起读写. 更改密码不会取消 - 在 Dashboard > API Tokens 下删除它 。 细节 : cmssy.com/docs/api/mcp (中文(简体) )。 。 。 .

设置

先决条件

1. Cmsy 工作空间 - 免费计划有效; 推车和退票需要 Pro
2. API 令牌( Dashboard > API) 托肯斯,从 cs_(中文(简体) )
3. 您的工作空间标识( 工作空间设置 > 常规)

服务器说话到 https://api.cmssy.io 默认。 过 --api-url 只用于另一个后端.

添加到克洛德代码

添加为 .mcp.json 在您的工程根中 :

{
  "mcpServers": {
    "cmssy": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@cmssy/mcp-server@latest",
        "--token",
        "cs_YOUR_TOKEN",
        "--workspace-id",
        "YOUR_WORKSPACE_ID"
      ]
    }
  }
}

环境变量

而非 CLI 参数, 您可以设定 :

• CMSSY_API_TOKEN - API 令牌(cs_xxx(中文(简体) )
• CMSSY_WORKSPACE_ID - 工作空间标识
• CMSSY_API_URL — API URL( 可选; 默认为 https://api.cmssy.io后端)

正在检查哪个构建正在运行

--version 财务报告和审定财务报表 --help 不需要任何标志,所以即使服务器是 未配置 。 运行旗子对 同样的光谱 您的客户端启动, (中文(简体) ), 从您的复制 mcp.json数字 :

npx -y @cmssy/mcp-server --version          # what an unpinned config runs
npx -y @cmssy/mcp-server@latest --version   # what the registry serves today
npm view @cmssy/mcp-server version          # the newest published version

前两个可以不同意, 而分歧是答案: 一个温暖的 npx 缓存保存一个未绑定的 spec 解析到更早,同时 @latest 重新解决并报告最新的一个。 这么说吧 @latest --version 无法诊断 是命令隐藏它。 先问未标注的光谱 当一个工具在一个字段上失败时, API 应该服务, 然后比较 .

清除缓存是 npx clear-npx-cache,或将版本刻入您的配置 所以没什么需要诊断的.

隐私政策

完全政策: https://www.cmssy.com/privacy (中文(简体) )。联系人: 联系人@cmssy.com。 。 。 .

• 此服务器收集的内容:无自取. 它没有本地数据库,没有写文件,也没有向任何分析服务发送任何信息.
• 它发出什么,在哪里:每个工具调用成为 GraphQL 对 Cmsy API 的请求(https://api.cmssy.io 除非你设定 CMSSY_API_URL),携带您的 API 令牌,您的工作空间ID,工具的参数,客户端名称和版本,以及正在运行的工具名称. Cmssy API 记录了从最后两个工具调用的一个使用事件.
• 文件和 URL数字 : upload_media 仅读取本地文件路径,或只下载您通过的 URL,然后将字节上传到 API 返回的 Cmsy 存储 URL。 没有其他文件.
• 使用和储存: Cmsy API在欧盟存储上述政策所描述的工作空间内容(页,记录,媒体,订单,客户). 内容不出售,也不用于培训AI模型.
• 第三方分享:服务器只与 Cmssy API 和 Cmssy 存储 URL 进行交谈,并加上您交出的任何 URL upload_media保险单列出了Cmsy服务本身使用的第三方.
• 保留数据:在呼叫返回后,服务器不保留任何内容 。 工作空间数据在您删除或关闭账户之前会保留;保留期在保单中.
• 你的纪念品:经创建它的成员的许可进行操作. 在 Dashboard > API 下撤消 随时托克.

反应形状( 写工具)

截止0.6.0,大多数写工具接受可选 response 参数 :

• response: "minimal" (default) - 返回一个小块(~200字节) : {id, slug, hasUnpublishedChanges, updatedAt} 用于页面工具, {pageId, blockId, hasUnpublishedChanges, updatedAt} 对于块工具, {id, slug, status, updatedAt} 为形式工具, {id, slug, updatedAt} 用于模型工具, {id, status, updatedAt} 为记录工具, {id, orderNumber, status, paymentStatus, fulfillmentStatus, total, balanceDue, currency, updatedAt} 用于订单工具, {id, code, type, value, enabled, updatedAt} 用于折扣工具.
• response: "full" - 返回完整的突变反应(前0.6行为).

使用 "full" 只当您需要后写入状态内入; 否则会发出一个 后续行动 get_page编号 :get_form编号 :get_model编号 :get_record。这保持代理 上下文窗口从被回放内容所吞噬.

接受的工具 response数字 : create_page, (中文(简体) ), update_page_blocks, (中文(简体) ), update_page_settings, (中文(简体) ), publish_page, (中文(简体) ), unpublish_page, (中文(简体) ), revert_to_published, (中文(简体) ), update_page_layout, (中文(简体) ), add_block_to_page, (中文(简体) ), update_block_content, (中文(简体) ), remove_block_from_page, (中文(简体) ), create_form, (中文(简体) ), update_form, (中文(简体) ), create_model, (中文(简体) ), update_model, (中文(简体) ), create_record, (中文(简体) ), update_record, (中文(简体) ), create_manual_order, (中文(简体) ), edit_order, (中文(简体) ), update_order_details, (中文(简体) ), mark_order_paid, (中文(简体) ), record_order_payment, (中文(简体) ), refund_order, (中文(简体) ), cancel_order, (中文(简体) ), close_order, (中文(简体) ), reopen_order, (中文(简体) ), create_return, (中文(简体) ), approve_return, (中文(简体) ), reject_return, (中文(简体) ), cancel_return, (中文(简体) ), receive_return, (中文(简体) ), refund_return, (中文(简体) ), complete_return, (中文(简体) ), update_return_tracking, (中文(简体) ), create_shipment, (中文(简体) ), update_shipment, (中文(简体) ), set_order_pipeline_stage, (中文(简体) ), record_order_invoice, (中文(简体) ), record_order_invoice_correction, (中文(简体) ), create_discount, (中文(简体) ), update_discount, (中文(简体) ), set_discount_enabled。 。 。 .

patch_block_content 和各种 delete_* / 只有状态的工具 (单位:千美元)update_form_submission_status, (中文(简体) ), import_records(中文(简体) ) 已经返回一个紧凑的 ack 并且不要拿 response。 。 。 .

建一个站点

连接服务器时,会发出指示,将一个代理(v0,Lovable, Bolt, Claude)发送到 get_site_setup 先说 它会返回文件 cmssy init 为 Next.js 写 - call- all page, 编辑器路由, 代理, 配置, 块注册, 头部/脚部区域 - 并填入工作空间的 env vars 。 特工就部署,打电话 set_preview_url,创建 content.changed 网络浏览 /api/revalidate,用户一旦打开编辑器,块类型就会注册,在其布局区域创建有页眉和页脚的页面,并公布.

可用工具

读取工具

写入工具

块帮助工具

update_region_settings

区域( 显示位置) 设置由工作空间的布局宣布 你当明白,你当明白,你当明白。 工具读取当前页面 layoutRegionSettings,仅替换命名区域并写入整个 列表后,所以兄弟地区保留其数值(区域 区域计划已经不存在的关键 在路上掉下来的—— 同样的pruning管理员编辑器做。 后端的自带 BAD_USER_INPUT 消息为未知区域逐字返回,未知 键,或非空 values 没有声明设置的区域(此类区域) 区域接受 values: {} 仅此而已); blockWarnings 当出现时浮出水面.

{ "pageId": "...", "region": "sidebar", "values": { "width": "wide" } }

儿童页面继承一个区域的设置,除非它们设置自己的 - get_page 显示每个区域在 resolvedRegions (单位:千美元)settingsAreInherited, (中文(简体) ), settingsSourcePageId) (中文(简体) ).

patch_block_content

对于长 HTML 内容字符串上的小编辑( 如 a) docs-article 身体状况, patch_block_content 值值为~10x,比 update_block_content 然后在给DB写信之前 发现标记错误.

{
  "pageId": "...",
  "blockId": "...",
  "locale": "en",
  "operations": [
    {
      "op": "insert_before",
      "marker": "<h2>Environment Variables</h2>",
      "html": "<hr><h2>cmssy skills install</h2><p>...</p>",
    },
  ],
}

四项行动: insert_before, (中文(简体) ), insert_after, (中文(简体) ), replace_section, (中文(简体) ), replace_all。 。 。 . 每个标记必须匹配 {\fn华文仿宋\fs16\1chd1d1d1}就是一次 - 0或2+ 与错误匹配 实际计算(无静态半应用状态)。 对于 replace_section, (中文(简体) ), startMarker 包容性和 endMarker 这是独家的. replace_all 设置 整个字符串并取 expected,当前值 - 如果移动则拒绝.

要求数 @cmssy/cli- 注册的工作空间 PAGES_EDIT 允许. 默认 fieldPath 实值 "content" (Docs-article上的HTML正文); 覆盖 如果补入不同的字符串字段。 点片段到达了嵌入的字符串,例如. tabs.0.label 第一个标签的标签.

模型工具(海关数据模型)

AI代理可以定义ModelDefinitions和CRUD他们的记录. 司马/外地 跟着 PropertyField 从 @cmssy/types; 对照 每一个字的模型.

需要工作空间权限 MODELS_VIEW (已读) / MODELS_CREATE 编号 : MODELS_EDIT 编号 : MODELS_DELETE 取决于操作.

商业工具(订单、货物、折扣)

管理店面的订单 手推车和折扣码. 所有钱田 是整数小单位(分数). 顺序/贴现工具接受 response 参数( 见 响应形状) (中文(简体) ).

产品是自定义数据模型的记录;这些工具增加了产品意识 在通用记录工具上阅读和批量写作。 这个 散装工具针对明确 ids 列表 或者说 所有符合 filter (单位:千美元)allMatching: true) (中文(简体) ). 没有零星的股票,也没有独立的 库存突变 -- -- 通过批量设置/调整库存 patch.setStock 编号 : patch.adjustStock。 。 。 .

需要工作空间权限 ORDERS_VIEW 编号 : ORDERS_MANAGE (订单), CARTS_VIEW (条款), DISCOUNTS_VIEW 编号 : DISCOUNTS_MANAGE (贴现), MODELS_VIEW 编号 : MODELS_EDIT 编号 : MODELS_DELETE (产品).

客户工具

客户是签到现场的账户 - 一个模型的记录 启用账户, 而不是管理工作空间的团队 (单位:千美元)list_team) (中文(简体) ).

价格列表工具

价目表(金、银、经销商等级)对买方的定价比 每个产品或变体的目录加固定价格。 每个买方有一个清单: 一个公司的成员支付公司名单,一个没有公司的客户 他们自己的.

销售频道工具

销售渠道(零售道,horeca道,b2b道)是商店前期发送要定价的密钥 从向它公布的价目单中提取的:买方自己或公司的产品 列表获胜,然后是频道日期列表,然后是其基准列表,然后是 目录。 名单公布于 create_price_list 编号 : update_price_list channels。 。 。 .

Webhook 工具

管理出局事件 Webhoks. create_webhook 财务报告和审定财务报表 rotate_webhook_secret 返回签名秘密 一次 - 无法再次取回.

需要工作空间权限 WEBHOOKS_VIEW (已读) / WEBHOOKS_MANAGE (创建,更新,旋转,删除).

电子邮件工具

需要工作空间许可 EMAIL_CONFIG_VIEW。 。 。 .

资源

示例工作流程

> List all pages in my workspace
> Search for pages matching "blog"
> Show me the available block types
> Which pages still use block types the site no longer registers?
> Create a new "Features" page with content in English and Polish
> Add a hero block to the Features page
> Publish the Features page

正在主机服务器( 图书馆)

createHostedServer 从没有符号和磁盘的主机提供相同的工具。 每个工具都需要一个 workspace (单位:千美元)<orgSlug>/<workspaceSlug>(三); list_workspaces 指定连接可能使用的名称。 包只检查形状 workspace - 下面的一切都是主持人的工作:

• resolveWorkspace(workspace) 是授权. 每通电话都检查一下,呼叫者是否仍然是该工作空间的成员,而且联系得到了批准. 为“不存在”和“不是您的”投出相同的信息,所以拒绝不会显示哪些工作空间存在.
• 执行者是范围. 这个 CmssyApi 它返回( e)createCmssyApi(execute, workspaceId))以该工作空间的用户身份运行每个文档;软件包不会发送任何内容.
• fetchUrl 是 SSRF 边界 . 拒绝私有,回回回和链接本地地址,并重新检查每个方向. 包裹在读取时会以50MB为身体盖上.

发展

pnpm install
pnpm dev -- --token cs_xxx --workspace-id xxx --api-url http://localhost:4000