Layero

面向 Agent 的 Layero

English · 俄语

Layero 是一个托管和部署平台，在俄罗斯设有构建服务器。 代码仓库或代码文件夹 → 发布到 <项目>.layero.app 的网站；支持自定义 域名、预览分支、运行时应用、带 Data API 的 Postgres 数据库。

🌐 网站：https://layero.ru · 📚 文档：https://docs.layero.ru/agents/ · 📦 npm：https://www.npmjs.com/package/layero

此代码仓库是 AI Agent 使用 Layero 的规范：一项技能（skills/layero）、一份 MCP 连接配置（mcp.json）和一张安装命令表（agents-install.json）。其他所有内容——Claude Code 和 Cursor 插件、MCP 注册表条目、下方的安装区块——均由脚本根据规范生成，并由校验关卡检查。

安装

MCP：https://mcp.layero.ru/mcp（服务 layero，http 传输）· 技能：LayeroInfra/layero-agents

客户端	命令
CLI	npx layero@latest deploy
Agent Skill	npx skills add LayeroInfra/layero-agents
Agent MCP	npx -y add-mcp https://mcp.layero.ru/mcp
Claude Code	claude plugin marketplace add LayeroInfra/layero-agents && claude plugin install layero@layero
Cursor	npx -y add-mcp https://mcp.layero.ru/mcp · 一键安装
Codex CLI	codex mcp add layero --url https://mcp.layero.ru/mcp

CI 和无显示环境——将令牌设为 LAYERO_TOKEN：

LAYERO_TOKEN=… npx layero@latest deploy --project <slug> --json --yes

有三种接入方式，请根据客户端选择：

1. 技能 — npx skills add LayeroInfra/layero-agents 会将 skills/layero 安装到任何支持 Agent Skills 标准的 Agent（.agents/skills）中。 该技能会教会 Agent 三种操作方式：推送到已连接的代码仓库、通过 npx layero@latest deploy --json 部署文件夹，以及管理已上线的网站。
2. MCP 服务 — npx -y add-mcp https://mcp.layero.ru/mcp 会将 远程服务（Streamable HTTP）连接到所有已安装的客户端。无需登录即可 使用 search_docs、check_copy、refactor_site；其他功能需要通过 OAuth 登录（首次调用账户工具时，客户端会打开浏览器），或在 CI 中使用 Authorization: Bearer $LAYERO_TOKEN 请求头。 本地不会启动任何内容。
3. 插件 — Claude Code（claude plugin marketplace add LayeroInfra/layero-agents && claude plugin install layero@layero）和 Cursor（Customize → Plugins → Add，代码仓库 LayeroInfra/layero-agents）可通过一条命令同时安装技能和 MCP。

CI 和无浏览器环境

在无法通过浏览器登录的环境中，使用令牌 LAYERO_TOKEN： 可在 app.layero.ru/settings/cli 创建令牌，也可运行 npx layero@latest token create。CLI 会自动读取该变量； 对于 MCP，Claude Code 插件会将其填入 Authorization: Bearer ${LAYERO_TOKEN} 请求头（克隆代码仓库时，根目录下的 .mcp.json 也会执行相同操作）。Cursor 插件不支持请求头：Cursor 不会展开 ${VAR}， 未展开的字符串会作为无效令牌发送到服务器。

Agent 的行为方式

行为原则见 SOUL.md：不要悄悄部署到生产环境；网站地址只能使用平台响应中的地址；回滚和授予数据访问权限前先询问用户；使用用户的语言交流。

代码仓库结构

skills/layero/SKILL.md            — КАНОН: единый навык
skills/layero/references/         — справочники: JSON-события CLI, layero.json, git-провайдеры
mcp.json                          — КАНОН: как подключить MCP-сервер
agents-install.json               — КАНОН: команды установки по клиентам
SOUL.md                           — принципы поведения агента (layero://soul)
assets/logo.svg                   — логотип для карточки плагина
build-adapters.py                 — генерирует всё ниже
check-surfaces.py                 — гейт: сгенерированное == закоммиченное
.claude-plugin/marketplace.json   — маркетплейс Claude Code          (генерируется)
plugins/layero/                   — плагин Claude Code: .mcp.json + навык (генерируется)
.cursor-plugin/marketplace.json   — маркетплейс Cursor                (генерируется)
plugins/layero-cursor/            — плагин Cursor: mcp.json, правило, навык, логотип (генерируется)
server.json                       — запись в реестре MCP как ru.layero/layero (генерируется)
.mcp.json                         — подключение из корня для Claude Code (генерируется)

如何修改

只修改规范：skills/layero/、mcp.json、agents-install.json、 SOUL.md，以及本 README 中安装区块以外的内容。然后：

make build   # перегенерировать адаптеры
make check   # убедиться, что всё совпадает

不要手动修改适配器——修改会在下一次 make build 时丢失，并导致 make check 失败。如果同级目录中存在着陆页和文档的检出副本，校验关卡还会检查其中的 agents-install.json 副本。

Layero 的发布渠道

统一的外部链接清单。在此处修改；不会从代码仓库自动更新的目录会特别标注——每次发布后都要手动修改这些目录（core 中的校验关卡 frontend/landing/check-published-claims.py 会发现已过时的承诺）。

产品

项目	地址
网站	https://layero.ru · llms.txt：https://layero.ru/llms.txt
控制面板	https://app.layero.ru
文档	https://docs.layero.ru · 面向 Agent：https://docs.layero.ru/agents/
平台状态	https://status.layero.app
MCP 服务	https://mcp.layero.ru/mcp
Telegram 聊天	https://t.me/layero_ru
Product Radar	https://productradar.ru/product/layero/

代码

仓库	GitHub	GitVerse 镜像
Agent 规范（本仓库）	https://github.com/LayeroInfra/layero-agents	https://gitverse.ru/layero/layero-agents
CLI（npm i layero）	https://github.com/LayeroInfra/cli	https://gitverse.ru/layero/cli
文档	https://github.com/LayeroInfra/layero-docs	https://gitverse.ru/layero/layero-docs
示例	https://github.com/LayeroInfra/examples	https://gitverse.ru/layero/examples
GitHub Action	https://github.com/LayeroInfra/deploy-action	https://gitverse.ru/layero/deploy-action
设计系统	https://github.com/LayeroInfra/design-system	https://gitverse.ru/layero/design-system

GitVerse 组织：https://gitverse.ru/layero。每个仓库在 push 到 main 时，都会通过工作流 mirror-gitverse.yml 更新镜像；组织 README（配置文件 layero/.gitverse）来自 LayeroInfra/.github。GitHub 组织级别已设置密钥 GITVERSE_LOGIN 和 GITVERSE_TOKEN（公开仓库可见）。

软件包和市场

平台	条目	更新方式
npm	https://www.npmjs.com/package/layero	LayeroInfra/cli 中的 v* 标签（工作流 publish.yml）
GitHub Marketplace	https://github.com/marketplace/actions/deploy-to-layero	通过 deploy-action 发布
官方 MCP 注册表	ru.layero/layero — https://registry.modelcontextprotocol.io/v0.1/servers?search=ru.layero	从 mcp/ 执行 mcp-publisher publish（必须提升版本号）
Claude Code 市场	claude plugin marketplace add LayeroInfra/layero-agents → layero@layero	来自此仓库
Cursor 市场	此仓库的 .cursor-plugin/marketplace.json	来自此仓库
skills.sh	https://skills.sh/LayeroInfra/layero-agents	来自此仓库
Smithery	https://smithery.ai/servers/borisowvalia/layero	手动：npx @smithery/cli mcp publish https://mcp.layero.ru/mcp -n borisowvalia/layero，在 Settings 中填写描述
Glama	https://glama.ai/mcp/connectors/ru.layero/layero	来自 MCP 注册表；所有权已通过文件 https://mcp.layero.ru/.well-known/glama.json 验证（提供 MCP 代码，请勿删除）。旧的重复条目 ru.layero.mcp/layero 已标记为 deprecated；其所有权由 layero.ru 区域（YC DNS）中的 TXT 记录 _glama-claim.mcp.layero.ru 保留
cursor.directory	https://cursor.directory/plugins/layero	在 /plugins/layero/edit 手动操作
mcp.so	申请 https://github.com/chatmcp/mcpso/issues/4219	根据申请处理
PulseMCP	从 MCP 注册表获取	自动

---

English

Layero 是一个托管和部署平台，其构建服务器位于俄罗斯境内：连接代码仓库或上传目录，即可获得一个位于 <project>.layero.app 的网站，以及自定义域名、分支预览、运行时应用和带有 Data API 的 Postgres 数据库。

本仓库是 AI Agent 使用 Layero 的规范来源：一个技能（skills/layero）、一个 MCP 连接规范（mcp.json）和一张安装命令表（agents-install.json）。其他内容——Claude Code 和 Cursor 插件、MCP 注册表条目、上方的安装区块——均由规范生成，并通过门禁检查。

安装

各客户端的命令见上表（agents-install.json）。共有三个渠道：

1. 技能 — npx skills add LayeroInfra/layero-agents 会将 skills/layero 安装到任何支持 Agent Skills 标准的 Agent 中。
2. MCP 服务 — npx -y add-mcp https://mcp.layero.ru/mcp 会将远程 服务（Streamable HTTP）添加到所有已安装的客户端。search_docs、 check_copy 和 refactor_site 无需登录即可使用；其他功能都需要通过 OAuth 登录（客户端会在首次调用账户工具时打开浏览器），或者在 CI 中使用 Authorization: Bearer $LAYERO_TOKEN。不会在本地运行任何内容。
3. 插件 — Claude Code（claude plugin marketplace add LayeroInfra/layero-agents && claude plugin install layero@layero）和 Cursor（自定义 → 插件 → 添加，仓库为 LayeroInfra/layero-agents）。

CI

如果无法通过浏览器登录，请使用 LAYERO_TOKEN：在 app.layero.ru/settings/cli 创建，或使用 npx layero@latest token create 创建。

LAYERO_TOKEN=… npx layero@latest deploy --project <slug> --json --yes

CLI 会自行读取此变量；Claude Code 插件（以及根目录中的 .mcp.json）会将其转发为 Authorization: Bearer ${LAYERO_TOKEN}。Cursor 插件不会附带请求头，因为 Cursor 不会展开 ${VAR}。

修改内容

仅编辑规范源（skills/layero/、mcp.json、agents-install.json、 SOUL.md，以及本 README 中安装部分之外的内容），然后运行 make build 和 make check。生成的适配器不得手动编辑。

文档：https://docs.layero.ru/en/agents/ · 网站：https://layero.ru · npm：https://www.npmjs.com/package/layero

请勿将其与 Layer0 / Edgio 或 layero.com 混淆；它们是无关的产品。

许可证

MIT