适合谁
- 需要在本地工具链（Git、编辑器）中开发 Google Apps Script 的开发者
- 希望为脚本项目建立版本控制和多人协作流程的团队
- 希望让 AI 编码代理（Claude Code、Gemini CLI）直接管理 Apps Script 项目的用户
C
63FMRS · C
clasp 是 Google 官方仓库维护、面向 Apps Script 的本地开发命令行工具，其实验性的 clasp mcp 子命令通过 STDIO 暴露给编码代理复用现有 CLI 凭据。功能覆盖项目推拉、部署、版本、日志和 API 管理，但 MCP 工具集有限且仍在迭代中，同时 OAuth 授权范围较广、push 为整体覆盖操作，需要谨慎管理凭据并留意远程覆盖风险。
clasp（Command Line Apps Script Projects）是 Google 官方仓库维护的命令行工具，用于在本地开发 Google Apps Script 项目：支持推送/拉取代码、创建和管理部署与版本、远程执行脚本函数、查看 Stackdriver 日志、以及启用/禁用 Google API。3.x 版本新增了实验性的 clasp mcp 模式，可作为基于 STDIO 传输的本地 MCP 服务器运行，供 Claude Code、Gemini CLI 等编码代理调用，使用与 CLI 相同的已保存凭据（需预先执行 clasp login）。README 明确声明本项目“不是 Google 官方支持的产品”，MCP 功能目前仅提供有限的一部分工具集。
工具能力
暂未整理工具清单。
安装接入
1) 全局安装：npm install -g @google/clasp；2) 在 https://script.google.com/home/usersettings 启用 Google Apps Script API；3) 运行 clasp login 完成 OAuth 授权（MCP 模式复用该凭据）；4) 作为 MCP 服务器接入编码代理，可选择：Claude Code 中运行 /plugin install @google/clasp 安装插件，或手动执行 claude mcp add clasp -- npx -y @google/clasp mcp（也可用仓库自带的 claude-mcp.json 通过 claude mcp add-json 添加）；Gemini CLI 中运行 gemini extensions install https://github.com/google/clasp。
claude_desktop_config.json
{"mcpServers":{"clasp":{"command":"npx","args":["-y","@google/clasp","mcp"]}}}
选型与风险
不适合谁
- 非 Apps Script 的通用云存储或数据库集成需求
- 需要官方厂商 SLA 支持的场景（README 明确声明这不是 Google 官方支持的产品）
- 依赖 clasp 2.x 内置 TypeScript 转译的项目（3.x 已移除，需自行使用 Rollup 等打包器）
- 希望使用服务账号免交互认证的场景（README 标注该功能为实验性且当前不可用）
所需权限
- Google OAuth 授权，用于读写用户的 Apps Script 项目（script.projects、script.deployments、script.webapp.deploy 等作用域）
- Google Drive 只读元数据及文件访问权限（drive.metadata.readonly、drive.file），用于列出和创建绑定脚本
- Google Cloud Service Usage API 权限，用于列出/启用/禁用高级服务 API
- Cloud Logging 读取权限，用于拉取脚本运行日志
- 本地凭据文件 `.clasprc.json`（含 OAuth 令牌）存储在用户主目录或工作目录中
风险与副作用
- `clasp push` 会整体覆盖远程项目内容（Apps Script API 不支持原子或单文件级操作），误操作可能导致远程代码丢失
- OAuth 授权范围较广，涵盖脚本、Drive 文件、日志和 API 管理，凭据泄露风险较高，尤其是使用 `--creds` 保存的自定义凭据文件
- MCP 模式为实验性功能，README 明确说明目前仅提供有限工具集，行为可能变化
- 服务账号（Application Default Credentials）支持被标注为“实验性/尚不可用”，不应用于生产自动化流程
常见排障
- 确认 Node.js 版本 >= 22.0.0（`node -v` 检查，可用 `npx n latest` 升级）
- 确认已在 Google Cloud 项目中启用 Apps Script API，并已成功执行 `clasp login`
- MCP 服务器无响应或凭据错误时，先确认对应用户的 `.clasprc.json` 是否有效，必要时用 `--user` 指定具体账号重新登录
- 排查问题时可设置环境变量 `DEBUG=clasp:*` 获取详细调试日志
- 推送/拉取异常时检查 `.clasp.json` 中的 `scriptId`、`rootDir` 等配置是否正确，以及 `.claspignore` 规则是否误排除了文件
使用场景
将 Apps Script 项目代码纳入本地版本控制并与团队协作开发
通过命令行推送/拉取脚本文件、管理部署和版本
远程执行 Apps Script 函数并查看运行日志
让 AI 编码代理通过 MCP 直接读写和部署 Apps Script 项目
支持客户端
Claude Code完整支持
Gemini CLI完整支持