Antigravity 设置 | Weegloo Docs

Antigravity 是一个在终端中通过 agy 命令运行的编码 agent。把 WEEGLOO MCP 服务器连接到它之后，Antigravity 就能直接创建、读取和修改 Content Type、Content、Media 等资源。安装工具在安装 MCP 服务器的同时，也会安装 Skills 和 Rules，帮助 Antigravity 按预期的方式使用 WEEGLOO API。Skills 是讲解如何出色完成特定任务的指南，Rules 则是贯穿各项任务都要遵守的规则。先用安装工具一次性完成设置，然后完成 MCP 连接认证即可。

关于 MCP 服务器和 Skills、Rules 的详细内容，分别在 MCP 和 Skills 与 Rules 页面中介绍。本页只讲如何连接到 Antigravity。

交给 agent 安装

请在 Antigravity 中粘贴下面这句话。

请按照 https://github.com/weeglooapi/weegloo-mcp-plugin 的 README 运行 npm 包 weegloo（npx weegloo@latest），帮我安装 WEEGLOO。

安装完成后，请按照连接 MCP 认证步骤进行认证。准备工作和安装命令可以跳过。

准备工作

要运行下面的安装命令，需要 Node.js。请先用以下命令确认是否已安装，以及版本是否为 18.3 及以上。

终端

node --version # 显示 v18.3 及以上即可 npx --version # 显示版本号即可

如果已安装 Node.js 但没有 npx，请用下面的命令把 npm 更新到最新版本。更新 npm 会一并安装 npx。

终端

npm install -g npm@latest

如果尚未安装 Node.js 或版本过低，请按照所用操作系统对应的方法安装 Node.js。

终端

brew install node

如果没有 Homebrew，请先在 brew.sh (在新标签页中打开) 安装，或在 nodejs.org (在新标签页中打开) 直接下载 Node.js。

终端

winget install OpenJS.NodeJS.LTS

如果没有 winget 或无法识别，请在 nodejs.org (在新标签页中打开) 下载 LTS 安装文件。安装后需要重新打开终端。

发行版自带的软件包可能是旧版本，因此推荐使用可在多个发行版上使用的 nvm 来安装。

终端

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.5/install.sh | bash source ~/.bashrc nvm install --lts

如需直接下载安装文件，请在 nodejs.org (在新标签页中打开) 查看。

Antigravity 也需要已安装，以便在终端中通过 agy 命令运行。如果还没有，请参阅 Antigravity 安装指南 (在新标签页中打开)。

进行连接

默认安装只需复制本页的安装命令，在终端中执行一次即可。若想逐步自行选择安装过程，请打开 自定义安装。

在 Antigravity 中 MCP 认证可能不稳定

weegloo MCP 服务器使用常规的 stateful HTTP MCP 连接，但 Antigravity 对 stateful MCP 连接的支持尚不稳定，认证可能失败或需要重试。如果希望更稳定的设置流程，建议使用 Claude Code、Codex 或 Cursor。

安装位置

安装 MCP · Skills

复制安装命令并在终端中执行。

终端

$ npx weegloo@latest -y \ --agent antigravity

连接 MCP 认证

请按以下顺序进行认证。

用 agy 运行 Antigravity。

终端
agy
在提示符中输入 /mcp。

终端
/mcp
请选择 weegloo。

终端
MCP Servers Plugins (~/.gemini/config/plugins) > ✗ weegloo error: calling "initialize": sending "initialize": Unauthorized [Auth Needed] ✓ weegloo-upload Tools: CreateUpload Keyboard: ↑/↓ Navigate enter Actions
请选择 Authenticate。

终端
MCP Servers Plugins (~/.gemini/config/plugins) > ✗ weegloo error: calling "initialize": sending "initialize": Unauthorized [Auth Needed] Restart Disable [Authenticate] ✓ weegloo-upload Tools: CreateUpload Keyboard: ←/→ Navigate enter Actions
在打开的 WEEGLOO 认证页面上，确认当前登录账户无误后，点击允许。

如果尚未在此浏览器中登录 WEEGLOO，会先打开登录界面，登录后会返回认证页面。如果尚未同意 WEEGLOO 服务条款，或服务条款已变更，还会显示同意服务条款的复选框。此时，勾选该复选框后点击允许。
复制 Google Antigravity 页面上显示的 Code，回到 Antigravity 粘贴并按 Enter。
显示认证失败时
如果显示 Authentication failed: no pending auth state for server weegloo 消息，可能是 Antigravity 一侧的临时问题。该现象主要出现在低于 1.0.16 的版本，但在最新版本中也可能发生，可按以下步骤重新连接。
1. 按 Esc 返回 MCP Servers 界面。
2. 再按一次 Esc 返回提示符输入界面。
3. 再次输入 /mcp，经过 initializing 阶段后即可连接。

安装 MCP · Skills

复制安装命令并在终端中执行。必须在要连接的项目文件夹内执行。

终端

$ npx weegloo@latest -y \ --agent antigravity \ --location project

连接 MCP 认证

请按以下顺序进行认证。

用 agy 运行 Antigravity。

终端
agy
在提示符中输入 /mcp。

终端
/mcp
请选择 weegloo。

终端
MCP Servers Plugins (~/.gemini/config/plugins) > ✗ weegloo error: calling "initialize": sending "initialize": Unauthorized [Auth Needed] ✓ weegloo-upload Tools: CreateUpload Keyboard: ↑/↓ Navigate enter Actions
请选择 Authenticate。

终端
MCP Servers Plugins (~/.gemini/config/plugins) > ✗ weegloo error: calling "initialize": sending "initialize": Unauthorized [Auth Needed] Restart Disable [Authenticate] ✓ weegloo-upload Tools: CreateUpload Keyboard: ←/→ Navigate enter Actions
在打开的 WEEGLOO 认证页面上，确认当前登录账户无误后，点击允许。

如果尚未在此浏览器中登录 WEEGLOO，会先打开登录界面，登录后会返回认证页面。如果尚未同意 WEEGLOO 服务条款，或服务条款已变更，还会显示同意服务条款的复选框。此时，勾选该复选框后点击允许。
复制 Google Antigravity 页面上显示的 Code，回到 Antigravity 粘贴并按 Enter。
显示认证失败时
如果显示 Authentication failed: no pending auth state for server weegloo 消息，可能是 Antigravity 一侧的临时问题。该现象主要出现在低于 1.0.16 的版本，但在最新版本中也可能发生，可按以下步骤重新连接。
1. 按 Esc 返回 MCP Servers 界面。
2. 再按一次 Esc 返回提示符输入界面。
3. 再次输入 /mcp，经过 initializing 阶段后即可连接。

以交互方式运行 npx weegloo，逐项回答提示来完成安装。

在 Antigravity 中 MCP 认证可能不稳定

安装位置

运行安装工具

在终端中执行下面的命令，并逐项选择提示的内容。

终端

npx weegloo@latest

终端

✔ Select your IDE: Antigravity CLI ✔ What would you like to install? MCP server, Skills and Rules ✔ Select the MCP server group: default ✔ Where would you like to install the configuration? Global … ✔ Installation complete!

连接 MCP 认证

请按以下顺序进行认证。

用 agy 运行 Antigravity。

终端
agy
在提示符中输入 /mcp。

终端
/mcp
请选择 weegloo。

终端
MCP Servers Plugins (~/.gemini/config/plugins) > ✗ weegloo error: calling "initialize": sending "initialize": Unauthorized [Auth Needed] ✓ weegloo-upload Tools: CreateUpload Keyboard: ↑/↓ Navigate enter Actions
请选择 Authenticate。

终端
MCP Servers Plugins (~/.gemini/config/plugins) > ✗ weegloo error: calling "initialize": sending "initialize": Unauthorized [Auth Needed] Restart Disable [Authenticate] ✓ weegloo-upload Tools: CreateUpload Keyboard: ←/→ Navigate enter Actions
在打开的 WEEGLOO 认证页面上，确认当前登录账户无误后，点击允许。

如果尚未在此浏览器中登录 WEEGLOO，会先打开登录界面，登录后会返回认证页面。如果尚未同意 WEEGLOO 服务条款，或服务条款已变更，还会显示同意服务条款的复选框。此时，勾选该复选框后点击允许。
复制 Google Antigravity 页面上显示的 Code，回到 Antigravity 粘贴并按 Enter。
显示认证失败时
如果显示 Authentication failed: no pending auth state for server weegloo 消息，可能是 Antigravity 一侧的临时问题。该现象主要出现在低于 1.0.16 的版本，但在最新版本中也可能发生，可按以下步骤重新连接。
1. 按 Esc 返回 MCP Servers 界面。
2. 再按一次 Esc 返回提示符输入界面。
3. 再次输入 /mcp，经过 initializing 阶段后即可连接。

运行安装工具

先进入要连接的项目文件夹，然后在该文件夹中执行下面的命令并逐项选择提示的内容。务必在该项目文件夹内执行。

终端

npx weegloo@latest

终端

连接 MCP 认证

请按以下顺序进行认证。

用 agy 运行 Antigravity。

终端
agy
在提示符中输入 /mcp。

终端
/mcp
请选择 weegloo。

终端
MCP Servers Plugins (~/.gemini/config/plugins) > ✗ weegloo error: calling "initialize": sending "initialize": Unauthorized [Auth Needed] ✓ weegloo-upload Tools: CreateUpload Keyboard: ↑/↓ Navigate enter Actions
请选择 Authenticate。

终端
MCP Servers Plugins (~/.gemini/config/plugins) > ✗ weegloo error: calling "initialize": sending "initialize": Unauthorized [Auth Needed] Restart Disable [Authenticate] ✓ weegloo-upload Tools: CreateUpload Keyboard: ←/→ Navigate enter Actions
在打开的 WEEGLOO 认证页面上，确认当前登录账户无误后，点击允许。

如果尚未在此浏览器中登录 WEEGLOO，会先打开登录界面，登录后会返回认证页面。如果尚未同意 WEEGLOO 服务条款，或服务条款已变更，还会显示同意服务条款的复选框。此时，勾选该复选框后点击允许。
复制 Google Antigravity 页面上显示的 Code，回到 Antigravity 粘贴并按 Enter。
显示认证失败时
如果显示 Authentication failed: no pending auth state for server weegloo 消息，可能是 Antigravity 一侧的临时问题。该现象主要出现在低于 1.0.16 的版本，但在最新版本中也可能发生，可按以下步骤重新连接。
1. 按 Esc 返回 MCP Servers 界面。
2. 再按一次 Esc 返回提示符输入界面。
3. 再次输入 /mcp，经过 initializing 阶段后即可连接。

MCP 服务器配置文件

安装工具会自动创建并管理配置文件，因此用户无需自行查看。以下内容是为需要具体配置文件结构和路径的用户提供的参考资料。

weegloo 服务器以 HTTP 方式连接到 https://ai.weegloo.com/mcp，处理文件的 weegloo-upload 服务器通过 npx 运行。上传时，agent 会从 weegloo 服务器获取上传令牌，并将其与文件一起传递给 weegloo-upload 服务器。全局安装会注册到用户主目录的 ~/.gemini/config/mcp_config.json，项目安装会注册到项目文件夹中的 .agents/mcp_config.json。

{
  "mcpServers": {
    "weegloo": {
      "serverUrl": "https://ai.weegloo.com/mcp"
    },
    "weegloo-upload": {
      "command": "npx",
      "args": ["-y", "weegloo-upload@latest"],
      "env": {
        "UPLOAD_API_URL": "https://upload.weegloo.com/v1"
      }
    }
  }
}

要更换服务器分组，请在 weegloo 服务器的 serverUrl 末尾附加 group 值。例如，要使用所有工具，就写成 https://ai.weegloo.com/mcp?group=all。各分组的工具构成请参阅 MCP 服务器分组。

Skills

安装工具会把每个 Skill 作为一个目录放入。全局安装是 ~/.gemini/skills/，项目安装放在项目文件夹的 .agents/skills/。

Rules

Antigravity 没有 Rules 这样的独立概念。因此安装工具会把相当于 Rules 的内容，也就是与 Claude Code 的 Rules 起相同作用的内容，放入上下文文件。全局安装是 ~/.gemini/GEMINI.md，项目安装是项目文件夹中的 AGENTS.md。

下一步

MCP：介绍服务器分组、文件上传服务器等作为连接基础的内容。
Skills 与 Rules：介绍安装工具一并安装的 Skills 和 Rules 是什么。
保持最新状态：介绍如何让已安装的 Skills 和 Rules 保持最新。
用 AI 迁移静态页面：跟随流程，用已连接的 MCP 把实际页面迁移为基于内容的服务。