Cursor Cloud · MCP（可选配置）

官方 SSOT：cursor.com/docs — MCP · Cloud Agents · cloud-agent/setup（环境）。母版索引 → library-index.md §Cursor 官方平台。

Super Cursor 默认不把 MCP / Cloud 配置写入 install 复制的 .cursor/。需要时从模板复制并 commit。

复制路径

模板（install 后路径）	目标
.cursor/templates/cursorGrowth/mcp.json.example	.cursor/mcp.json
.cursor/templates/cursorGrowth/environment.json.example	.cursor/environment.json（默认仅 install）
.cursor/templates/cursorGrowth/environment.docker.json.example	合并进 .cursor/environment.json（有 Dockerfile 时）

cp .cursor/templates/cursorGrowth/mcp.json.example .cursor/mcp.json
cp .cursor/templates/cursorGrowth/environment.json.example .cursor/environment.json
# 需要 Docker Build 时：把 environment.docker.json.example 里的 "build" 段合并进 environment.json
# 或整文件替换：cp .cursor/templates/cursorGrowth/environment.docker.json.example .cursor/environment.json

MCP（.cursor/mcp.json）

• 项目级工具；全局可用 ~/.cursor/mcp.json。
• 使用 ${workspaceFolder} · ${env:NAME} 插值；勿 commit 明文密钥。
• 远程 OAuth 可在条目内加 auth（CLIENT_ID / CLIENT_SECRET / scopes）。
• Cloud Agents 使用 团队 MCP（Dashboard 配置），与本地会话 MCP 分离。
• 设计 MCP 服务 → mcp skill。

Cloud Agents（.cursor/environment.json）

• 解析顺序：仓库内 environment.json → 个人环境 → 团队环境。
• install：Build 时执行的幂等脚本（依赖安装、代码生成等）。母版默认模板只含此项。
• build.dockerfile：高级场景（见 environment.docker.json.example）；勿 COPY 整个项目（Cursor 自行 checkout）。
• 密钥：Dashboard → Cloud Agents Secrets；不要依赖把 .env.local 打进快照。
• Hooks：仓库 .cursor/hooks.json 在 Cloud 可跑 command hooks；~/.cursor/hooks.json 不可用。本地 vs Cloud vs Tab 对照 → platforms.md §Cursor Hooks。
• 部署/compose 约定 → ops-deploy skill（与 VM 内 install 脚本分工：install=Build，compose=运行时文档）。

与 Super Cursor 闸门

• 本地 Sprint 仍靠 .cursorGrowth/plan.md + runner.sh gate-check。
• Cloud 跑 agent 不读取你本机 .cursorGrowth/；把验收命令写进 install 或 PR 描述。

Plugin MVP（本地加载 · 非 Marketplace）

仓库根 .cursor-plugin/ 为 lifecycle 子集（plan · run · master · learn · scaffold + agents ship/review/spike + 核心 rules + hooks）。主路径仍是 仓库根 install-super-cursor.sh 全量 .cursor/ — Plugin 不带 workflow.json · 全量 skills · verify-super-cursor 契约。

bash .cursor/bin/sync-plugin-subset.sh    # 母版维护者：从 .cursor/ 刷新子集
bash .cursor/bin/verify-cursor-plugin-mvp.sh

范围与 install 差异 → templates/cursorGrowth/learn/cursor-platform.md §Plugin MVP · archive/meta/*_SPIKE_plugin_mvp_scope.md（Growth 运行时路径）。

Hooks · config（Plugin 必读）

Plugin hooks 不打包 workflow.json。config-load.sh 期望目标仓库已有 .cursor/config/（通常来自 prior install）。仅 Plugin、无 install → gate-check / plan 元数据不可用。

分发三轨（对照）

轨	skills（约）	说明
install full	28	默认
install --skills-bundle core	23	非 Plugin
.cursor-plugin/	5 lifecycle	非 core；见 verify-cursor-plugin-mvp.sh

归档矩阵 → archive/meta/*_SPIKE_plugin_phase2_scope.md（Growth）。

Marketplace（Defer · 未来清单）

仍 Defer 上架 — Marketplace 不是第三轨替代物；Plugin 包未来可能上架，当前仅本地 .cursor-plugin/。

项	指针
清单归档	archive/meta/*_SPIKE_marketplace_prep_scope.md（Growth）
门禁脚本	bash .cursor/bin/verify-spike-marketplace-prep-scope.sh
长文 SSOT	install 后 learn/cursor-platform.md §Marketplace

Skills bundle（install 可选）

默认 install-super-cursor.sh 仍安装 28 skills（--skills-bundle full，可省略）。若目标项目不需要五工具 skill（week · disk · maintain · ops-deploy · code-stats-viz），可用 --skills-bundle core → 安装后 23 skills。契约 SSOT：config/skill-bundles.json。

./install-super-cursor.sh /path/to/app --skills-bundle core --profile full
bash .cursor/bin/verify-install-skills-bundle.sh   # 母版维护者门禁