Cloady

@cloady/mcp

适用于 Cloady 的本地 MCP 服务——将整个 Cloady API 作为工具提供给 AI 助手：工作区、应用、部署、环境变量、域名、卷、成员、集成、账单和支持工单。

根据 Cloady 的 OpenAPI 契约生成，因此每个 REST 操作都是一个以其操作 ID 命名的工具（listVars、createVar、deployApp、execCommand）。它通过 stdio 运行，并使用你的 API 令牌调用 https://cloady.com。

设置

关于基于 OAuth 的 Claude 插件，请参阅 Cloady for Claude。它会连接到托管的 MCP 端点，无需安装 npm 服务或复制 API 令牌。

Gemini CLI 扩展

从此仓库安装扩展：

gemini extensions install https://github.com/Cloady/cloady-mcp

打开 Gemini CLI 并运行 /mcp auth cloady，通过 OAuth 登录 Cloady。完成任何必要的账户验证，并根据任务选择范围最窄的权限：read、deploy 或 full。此扩展无需 API 密钥或本地 npm 服务。

试试“列出我的 Cloady 工作区和正在运行的应用”“根据应用的构建日志说明最新部署失败的原因”，或“在创建任何内容之前，显示可用的数据库模板和价格”。

该扩展会将工具参数发送到 https://cloady.com/api/mcp，并将获准的结果返回给 Gemini。根据你请求的工具，这些结果可能包含账户和工作区元数据、应用配置、代码、日志、指标、数据库内容和支持消息。Google 会依据自身政策处理收到的结果；Cloady 对数据的处理、保留和删除方式详见隐私政策。账户级连接可涵盖该账户所属的所有工作区，但受权限范围和工作区角色限制。在 Cloady Account → API tokens 中撤销其令牌，即可停止后续请求。撤销不会删除托管数据或 Gemini 已收到的副本。

授权更改前，请检查目标工作区、应用、环境、区域及相关费用。写入工具可能会更改或删除资源。此扩展免费；托管资源按 Cloady 定价收费。支持和删除请求请联系：[email protected]。

Gemini 扩展和 Claude 插件的版本与本地 npm 包分别管理。

Qwen Code

Qwen Code 支持 Gemini CLI 扩展，并会在安装过程中转换其清单：

qwen extensions install https://github.com/Cloady/cloady-mcp

在你的客户端中使用 Cloady 的 OAuth 连接。上述相同的账户权限、数据处理方式和托管费用同样适用。请参阅 Qwen Code 的扩展文档。

本地 stdio 包

在控制面板的 Account → API tokens 下创建 API 令牌。

Claude Code

claude mcp add cloady -e BEARER_TOKEN_CLOADY=cldy_… -- npx -y @cloady/mcp

Claude Desktop / Cursor / 任意 MCP 客户端

{
  "mcpServers": {
    "cloady": {
      "command": "npx",
      "args": ["-y", "@cloady/mcp"],
      "env": { "BEARER_TOKEN_CLOADY": "cldy_…" }
    }
  }
}

如果你在其他位置运行 Cloady，API_BASE_URL 可覆盖目标地址。

工具

每个 API 操作对应一个工具。参数是该操作的路径参数、查询参数和请求体字段，全部合并到一个对象中，因此 createVar 接受 workspaceSlug、appSlug、env、region、key、value 和 isSecret。

每次调用时，API 都会强制执行令牌的权限范围（read / deploy / full）和你的工作区角色，与控制面板和 SDK 的执行方式完全相同。

文档

完整参考文档请访问 cloady.com/docs。

发布

此仓库包含已在 npm 上发布为 @cloady/[email protected] 的源代码和构建产物，以及目录打包内容。运行 npm install 和 npm start。Cursor 插件使用固定的 npm 版本。MCPB 包含生产依赖。

隐私政策

此本地服务会使用你配置的 API 令牌，将工具参数转发给 Cloady API。有关数据处理和联系方式，请参阅 Cloady 隐私政策。请使用权限范围最小的令牌；写入工具可能会更改或删除资源。

0.5.1 桌面版在 0.5.0 API 实现的基础上添加了工具标题和保守的读取／写入注释。Cursor 配置仍使用已发布的 npm 0.5.0 版本。