Weegloo Docs - Antigravity 设置

Antigravity 是一个在终端中通过 agy 命令运行的编码 agent。把 WEEGLOO MCP 服务器连接到它之后，Antigravity 就能直接创建、读取和修改 Content Type、Content、Media 等资源。连接方式与其他环境相同。先用安装工具一次性完成设置，然后在 Antigravity 中完成认证即可。

关于 MCP 本身、服务器分组以及文件上传服务器的说明，请参阅 MCP。本页只讲连接到 Antigravity 的步骤。

准备工作

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

终端

node --version # 显示 v18 及以上即可 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。

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 \ --token wgl_••••••••••••

认证 MCP

请按以下顺序进行认证。

1.用 agy 运行 Antigravity。
终端
agy
2.在提示符处输入 /mcp。
终端
/mcp
3.请选择 weegloo。
终端
MCP Servers Plugins (~/.gemini/config/plugins) > ✗ weegloo error: calling "initialize": sending "initialize": Unauthorized [Auth Needed] ✓ weegloo-upload Tools: CreateUpload Keyboard: ↑/↓ Navigate enter Actions
4.请选择 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
5.在打开的认证页面的令牌输入框中，粘贴下方的令牌。
6.复制 Google Antigravity 页面上显示的 Code，返回 Antigravity 粘贴，然后按 Enter。
如果身份验证显示失败
如果看到 Authentication failed: no pending auth state for server weegloo，这可能是 Antigravity 侧的临时问题。该问题主要出现在低于 1.0.16 的版本中，但最新版本也可能发生，可以按以下步骤重新连接。
1. 1.按 Esc 返回 MCP Servers 屏幕。
2. 2.再次按 Esc 返回提示符输入界面。
3. 3.重新输入 /mcp，它会经过 initializing 并完成连接。

直接查看配置文件

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

weegloo 服务器以 HTTP 方式连接到 https://ai.weegloo.com/mcp，处理文件的 weegloo-upload 服务器通过 npx 运行，并使用 Personal Access Token 进行认证。以全局方式安装时，会注册到用户主目录的 ~/.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"],
      "env": {
        "UPLOAD_API_URL": "https://upload.weegloo.com/v1",
        "AUTH_BEARER_TOKEN": "<Personal Access Token>"
      }
    }
  }
}

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

下一步

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