Skip to Content
帮助文档从这里开始接入你自己的 AI 编程工具

接入你自己的 AI 编程工具

你已经在用的 AI 编程工具可以直接对接 Zion 项目,方式是安装 Zion Plugin。

Plugin 以 MCP 服务器的形式运行在你的编程工具里,把 Zion 项目接到当前代码库上。装好之后,AI 一次对话里可以做两件事:

  • 改后端——在 Zion 项目里创建和调整数据表、权限、行为流、第三方 API,并同步后端变更;
  • 写前端——在你自己的代码库里写调用这些后端能力的前端代码。

你只需要告诉它用哪个 Zion 项目,以及要实现什么功能。后端本身提供哪些服务、Runtime API 怎么用,见 Headless · Zion BaaS。

安装 Plugin

Zion Plugin 适用于 Claude Code、Codex、Cursor、Qoder 和 WorkBuddy。其他支持 MCP 的工具可以直接接入 zion-mcp MCP 服务器。安装说明和源代码见 Zion 无代码 Plugin 。

展开对应工具查看安装方式:

Claude Code

终端:

claude plugin marketplace add functorz-tech/zion-nocode-plugin claude plugin install zion-nocode@zion

Claude Code CLI:

/plugin marketplace add functorz-tech/zion-nocode-plugin /plugin install zion-nocode@zion /reload-plugins

也可以直接输入 /plugin 打开插件菜单,交互式添加市场并安装。

Claude 客户端:

桌面端(Mac / Windows)和 IDE 扩展在对话框中直接说:

请添加 Git marketplace functorz-tech/zion-nocode-plugin,然后安装 zion-nocode@zion

也可以输入 /plugin 打开插件菜单,与 CLI 一致。

Codex

终端:

codex plugin marketplace add functorz-tech/zion-nocode-plugin codex plugin add zion-nocode@zion codex plugin list | grep zion # 验证

Codex CLI:

运行 /plugins 打开插件面板 → Add Marketplace 填入 functorz-tech/zion-nocode-plugin → 在列表中选择 zion-nocode 安装。

Codex 客户端:

在对话框中直接说:

请添加 Git marketplace functorz-tech/zion-nocode-plugin,然后安装 zion-nocode@zion

也可以输入 /plugin creator,选中该系统插件后让它安装仓库地址。

Cursor

需要 Cursor 2.5+,安装后同时获得 zion-platform 技能和 zion MCP 服务器。

Cursor 客户端(团队 / 企业):

管理员在 Cursor Teams / Enterprise 后台把 https://github.com/functorz-tech/zion-nocode-plugin 添加为团队市场,成员在插件列表中安装 zion-nocode。

终端(本地开发):

git clone https://github.com/functorz-tech/zion-nocode-plugin.git cd zion-nocode-plugin ln -s "$PWD/plugin" ~/.cursor/plugins/local/zion-nocode

完成后重新加载 Cursor 窗口,并在插件设置中启用 zion-nocode。

opencode

对话框内:

直接告诉 AI 从仓库地址安装:

从 https://github.com/functorz-tech/zion-nocode-plugin 安装 Zion 插件

手动配置:

opencode 不读取 Claude Code / Codex 的插件市场,手动接入分 MCP 服务器和技能两部分。

MCP 服务器写入项目根目录的 opencode.json,或合并进已有配置的 mcp 字段(格式与下方通用的 mcpServers 不同):

{ "$schema": "https://opencode.ai/config.json", "mcp": { "zion": { "type": "local", "command": ["npx", "-y", "zion-mcp@latest", "mcp"], "enabled": true } } }

技能方面,opencode 从技能目录读取 <名称>/SKILL.md,把 Plugin 仓库里的 zion-platform 链接过去即可:

git clone https://github.com/functorz-tech/zion-nocode-plugin.git cd zion-nocode-plugin mkdir -p ~/.config/opencode/skills ln -s "$PWD/plugin/skills/zion-platform" ~/.config/opencode/skills/zion-platform

只想在单个项目里启用时,改为链接到项目内的 .opencode/skills/zion-platform。

Qoder

Qoder 客户端:

Plugin 管理页面 → 添加插件仓库地址:

https://github.com/functorz-tech/zion-nocode-plugin

WorkBuddy

WorkBuddy 客户端:

Plugin 管理页面 → 添加插件仓库地址:

https://github.com/functorz-tech/zion-nocode-plugin

其他支持 MCP 的工具(Windsurf、Cline、Trae、Claude Desktop 等)

这些工具不读取插件市场,但可以直接接入 zion-mcp。写入工具的 MCP 配置文件:

{ "mcpServers": { "zion": { "command": "npx", "args": ["-y", "zion-mcp@latest", "mcp"] } } }

可以获得 Zion 的全部工具(数据模型、行为流、数据绑定、日志等)。引导式的 zion-platform 技能需要通过 Plugin 安装,或按上面 opencode 的方式手动放进工具的技能目录。

需要 Node.js 18+。首次使用时按提示登录 Zion 并选择项目,也可以提前在终端登录:

npx -y zion-mcp@latest login

使用 Plugin 开发

登录后,直接用自然语言描述完整的业务目标。例如:

使用 Zion 项目「订单管理」作为当前项目的后端。 为订单功能创建需要的数据结构、权限和服务端逻辑,完成后同步后端变更; 然后在当前代码库中实现订单列表、订单详情和提交订单。

AI 会根据需求同时修改 Zion 后端和当前代码库。需要确认数据结构、权限或业务规则时,AI 会在执行前向你提问。

Last updated on